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

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

Die Signatur steht im Header X-EConnect-Signature (sha256= plus Hex), berechnet mit dem secureKey aus der Hook-URL. Bei einer Antwort ungleich 2xx versucht die PSB die Zustellung bis zu 5 Tage erneut.

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

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

• 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)

Weiter mit:

• SDKs und CLI
• Validate API
• API Reference
• Fehlerbehandlung