IOPAY→Entwickler→Webhooks
Ereignisse & Synchronisation

Webhooks und Benachrichtigungen

Organisieren Sie die Empfangszahlungen von Statusänderungen und verbinden Sie Zahlungen mit Ihren eigenen Systemen, ohne sich auf kontinuierliche Umfragen zu verlassen.

EndpunktHTTPS
StandardAsynchron
ZielStatus-Synchronisierung
Empfohlener Fluss Beispiel eines Handlers - Die Auskunft
Konzept

Wie funktioniert

Setzen Sie eine HTTPS-Notifikations-URL ein, damit Ihre Anwendung relevante Änderungen an der Operation erhält. Die webhook muss den internen Status des Antrags, der Erhebung oder des entsprechenden Verfahrens ermitteln.

Aktuelle Einstellung. Die URL ist in Einstellungen → Online-Transaktionen. Nur HTTPS wird akzeptiert. Bei 200 verschiedene Anfragen oder Antworten fehlen, gibt es in der aktuellen Dokumentation weitere 3 Versuche.
Empfohlener Fluss

Empfohlener Fluss

01 · IOPAYStatus ändert sich.

Eine relevante Transaktion oder Ereignis entwickelt sich in der Verarbeitung.

02 · EndpunktIhr webhook Sie empfangen.

Die Anwendung erhält die Payload am konfigurierten HTTPS-Endpunkt.

03 · AusdauerRegistrieren Sie das Ereignis.

Speichern Sie Identifikatoren und genügend Inhalt für die Rückverfolgung.

04 · BereichAktualisieren Sie die Systeme.

Auf Anfrage, ERP, WHO, Finanz und Automation sind auf dem neuesten Stand.

Die Umsetzung

Die Umsetzung

Konzeptionelles Beispiel · 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. Das Beispiel ist Architektur. Validierung, Unterzeichnung, Felder und Retry-Regeln müssen dem gültigen Integrationsvertrag folgen.
Robustheit

Impotenz und Stärke

Die Zeit ist nicht zu lang.

Du musst nicht zweimal vorgehen.

Verwenden Sie einen Ereignis-/Transaktions-Identifikator, um Duplikate zu verhindern.

Antwort

Erkenntnis schnell.

Vermeiden Sie lange Operationen, bevor Sie den Event-Emittenten erfolgreich zurückgeben.

Der Auftrag

Gestätigt den aktuellen Status.

Es hängt nicht nur von der Ankunftsordnung ab; vergleiche das Ereignis mit dem bekannten Zustand.

Beobachtbarkeit

- Das ist ein historisches Buch.

Erfassung von Empfang, Verarbeitung, Fehler und Korrelation zu Anforderung/Transaktion.

Checkliste

Checkliste

  • HTTPS-URL konfiguriert und extern zugänglich.
  • Ein niedriger Zeitverlauf und eine schwere Reihenarbeit.
  • Die Zeiträume für die Veranstaltung/Transaktion.
  • Logs mit Anforderungskorrellenz und Identifikator IOPAY.
  • Warnungen für wiederholte Verarbeitungsschwäche.
  • Einheitliche Vereinbarung Routine nach Konsultation mit API für Ausnahmezustände.