Begivenheder

Webhooks og notifikationer

Organiser modtagelsen af statusændringer og tilslut betalinger til dine egne systemer uden at stole på kontinuerlig afstemning.

SlutpunktHTTPS
StandardAsynkron
MålSynkronisér tilstand

Sådan virker det

Indstil en HTTPS-meddelelsesURL, så dit program modtager relevante ændringer fra operationen. webhook skal indeholde den interne status for ansøgningen, indsamlingen eller den tilsvarende proces.

Aktuelle indstillinger. URL 'en er sat til Følgende er en liste over Den Europæiske Investeringsbanks vigtigste aktiviteter:. Kun HTTPS accepteres. I tilfælde af svigt i en anden anmodning eller reaktion på 200, den nuværende dokumentation rapporter 3 flere forsøg.

Anbefalet gennemstrømning

01 · IOPAYStatus er ved at ændre sig.

En relevant transaktion eller begivenhed udvikler sig i behandlingen.

02 · SlutpunktDin webhook modtager.

Ansøgningen modtager nyttelasten ved det konfigurerede HTTPS endpoint.

03 · PersistensOptag begivenheden.

Hold identifikatorer og nok sporbarhedsindhold.

04 · OmrådeOpdatering af systemerne.

På efterspørgslen følger ERP, WHO, finansiering og automatisering den nye trend.

Gennemførelse af programmet

Konceptuelt eksempel · Laravel
Route::post('/webhooks/iopay', function (Request $request) {
    $payload = $request->all();

    // 1. valide a origem / assinatura conforme o contrato vigente
    // 2. persista o evento com identificador único
    // 3. responda rapidamente
    ProcessIopayWebhook::dispatch($payload);

    return response()->json(['received' => true], 200);
});
Importante. Eksemplet er arkitektonisk. Validering, underskrift, felter og gentagelsesregler skal følge den nuværende integrationskontrakt.

Impotens og robusthed

Impotens

Du skal ikke sagsøge mig to gange.

Brug en event / transaction-id til at forhindre dobbelteffekter.

Svar

Bekræft det hurtigt.

Undgå lange operationer, før begivenheden returneres med succes til udsteder.

Rækkefølge

Valid den aktuelle status.

Du skal ikke bare afhænge af rækkefølgen af ankomst; sammenligne begivenheden med den kendte tilstand.

Observerbarhed

Behold historien.

Registrer kvittering, behandling, fejl og korrelation med anmodning / transaktion.

Checkliste over

  • HTTPS URL konfigureret og eksternt tilgængelig.
  • Lav timeout og tung forarbejdning i linje.
  • Påtænkt af begivenhed / transaktion
  • Logge med anmodning korrelation og identifikator IOPAY.
  • Indberetninger om gentagne behandlingssvigt.
  • Forsoningsrutine ved konsultation med API i særlige tilfælde.