Tegemused & Sinkroniseerimine

Webhooks ja teavitused

Järjestle staatusmuutuste vastuvõtmist ja ühendage makse oma süsteemidesse, ilma et oleks vaja pidevat valimist.

EndpointHTTPS
MeesAsynchronous
EesmärkSynchronize state

Kuidas see toimib

Seada üles HTTPS-teadmise URL, et teie rakendus saaks operatsioonist asjakohaseid muudatusi. webhook peab andma andme-, nõupidamise- või vastava protsessi sisekujutuse.

Praegune seadistus. URL on määratud Konfiguratsioonid → Online-transactionid. Ainult HTTPS on lubatud. Kui 200 erinevat taotlust või vastust ei ole tehtud, siis praegune dokumentatsioon annab teada veel 3 katse.

Soovitatav voog

01 · IOPAYStatus muutub.

Täpse tehingu või sündmuse areng toimub töötlemisel.

02 · EndpointTeie webhook saab.

Rakendust saab payload konfigureeritud HTTPS-i lõpppunktis.

03 · PersistenceRegistreerige sündmus.

Hoidke identifitseerijaid ja piisavat sisust jälgitavuseks.

04 · DominePäevasüsteemid.

Soovitud ERP, WHO, rahandus ja automaatide süsteemid on uues seisundis.

Kohjeldamine

Laravel'i kontseptsiooniline näide
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. Näiteks arhitektuur. Valideerimine, allkirjastamine, väljad ja retry reeglid peavad järgima kehtivad integreerimislepingud.

Kõhusus ja tugevus

Kõhusus

Ära küsi kaks korda.

Kasutage sündmuse/transaasi identifitseerijat, et vältida topeltse mõju.

Vastus

Kiire tunnustamine.

Vältige pikemaid operatsioone enne, kui saate sündmuse emitentuks edukalt tagasi.

Orde

Tõenda praegune seisund.

Ära sõltu ainult saabumisjärgest. Võrdle sündmust teadaoleva seisundiga.

Jälgitavus

Pange ajalugu.

Registreerib saamine, töötlemine, viga ja korrelatsioon taotlus/transaksiooniga.

Kontrolinlist

  • HTTPS-URL konfiguratsioon ja väliselt juurdepääsetav.
  • Väike ajajooks ja raske töötamine.
  • Tegevuse/transaktsionaalsus.
  • Löögi- ja ID-nõuete korrelatsioon IOPAY.
  • Teised hoiatused korduvatele töötlemisõnnetustele.
  • Erandjuhtudel APIga konsulteeritud lepitusrootine.