IOPAY→Deweloperzy→Webhooks
Wydarzenia i synchronizacja

Webhooks i powiadomienia

Organizuj odbiór zmian statusu i podłącz płatności do własnych systemów bez konieczności ciągłego głosowania.

WykresHTTPS
WymógNieprzychodzący
CelSynchronizować stan
Zalecany przepływ Przykład handlerów Świadczenia →
Koncepcja

Jak to działa

Ustaw URL powiadomienia HTTPS, aby aplikacja otrzymywała odpowiednie zmiany w operacji. webhook musi być źródłem stanu wewnętrznego wniosku, powiadomienia lub odpowiedniego procesu.

Aktualna konfiguracja. URL jest zdefiniowany w Ustawienia → Transakcje online. Tylko HTTPS jest akceptowany. W przypadku niepowtarzania lub nieodpowiedzenia od 200, obecna dokumentacja informuje o kolejnych trzech próbach.
Zalecany przepływ

Zalecany przepływ

01 · IOPAYStatus zmienia się.

W procesie przetwarzania rozwija się istotna transakcja lub wydarzenie.

02 · EndpointTwój webhook przyjmuje.

Aplikacja otrzymuje ładunek na skonfigurowanym HTTPS.

03 · PersystancjaZapisz tę imprezę.

Zachowaj identyfikatory i wystarczającą ilość treści, aby można było je wykryć.

04 · DominaAktualuj systemy.

Wymagane, ERP, WHO, finansowe i automatyczne są w stanie.

Wdrożenie

Wdrożenie

Przykład koncepcyjny · 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. Przykładem jest architektura. Validacja, podpis, pola i zasady retry muszą być zgodne z obowiązującą umową integracji.
Rzetelność

Niepotrzebość i robustność

Niepotrzebność

Nie procesuj dwa razy.

Wykorzystaj identyfikator zdarzenia/transacji, aby zapobiec podwójnym skutkom.

Odpowiedź

Szybkie rozpoznanie.

Unikaj długich operacji przed powodzeniem wydarzenia do emitenta.

Wyrok

Uważaj obecny stan.

Nie zależy tylko od kolejności przybycia, porównaj zdarzenie z znanym stanem.

Obserwowalność

- Przechowywać historię.

Zapisywanie otrzymania, przetwarzania, błędu i korelacji z wnioskiem/transakcją.

Lista kontrolna

Lista kontrolna

  • URL HTTPS skonfigurowany i dostępny zewnętrznie.
  • Mała przerwa i ciężkie procesy w kolejce.
  • Idempotencja na wydarzenie/transakcję.
  • Logy z korelacją żądania i identyfikatorem IOPAY.
  • Ostrzeżenia o powtarzających się nieprawidłowości w procesie.
  • Routine pojednania za pośrednictwem konsultacji z API w wyjątkowych przypadkach.