Schritt 6: Webhooks

Webhooks für Ihre erste PSB-Integration: Topics registrieren, 2xx innerhalb von 100 s, HMAC SHA256-Signaturen prüfen.

Ohne Webhooks sehen Sie nur synchrone API-Antworten. Lieferstatus, Retries und Empfang laufen asynchron. Hooks gehören zu jeder ernsthaften Integration.

Minimale Einrichtung in der Sandbox
  1. Veröffentlichen Sie einen HTTPS-Endpoint, der JSON empfangen kann (vorübergehend: ein Tunnel wie ngrok ist für accp in Ordnung)
  2. Registrieren Sie einen Hook mit Topic InvoiceSent (Senden) und/oder InvoiceReceived (Empfang)
  3. Antworten Sie innerhalb von 100 Sekunden mit HTTP 2xx
  4. Prüfen Sie die HMAC SHA256-Signatur, bevor Sie dem Payload vertrauen

Exakte Registrierungs-API, Header und Retry-Verhalten: Webhooks einrichten.

Was Sie im ersten Test sehen wollen
  1. Senden Sie eine Rechnung (Schritt 5)
  2. Empfangen Sie einen Hook für das Sende-Event
  3. Loggen Sie Topic, Dokument-/Korrelations-ID und Prüfresultat
  4. Erzwingen Sie bewusst ein non-2xx, um Retries zu sehen; stellen Sie danach wieder auf 2xx um
Sicherheit
  • Teilen Sie das Hook-Secret nicht in Client-seitigem Code
  • Nutzen Sie getrennte Secrets/URLs für Accp und Produktion
  • Lehnen Sie Requests mit ungültiger Signatur ab (und loggen Sie sie)
Fertig mit Getting started?

Weiter mit: