Skip to main content

​
Definition

Nachdem du eine Zahlung initiiert hast, erhältst du über den Webhook automatische Status-Updates — z.B. wenn die Zahlung erfolgreich ausgeführt wurde oder fehlgeschlagen ist.
Die Webhook-URL wird zentral für alle Banking-Events konfiguriert (PUT /v2/banking/webhook-url). Nutze das event-Feld, um zwischen AIS- und PIS-Events zu unterscheiden.

​
Payload

​
payment_update

Wird ausgelöst, wenn sich der Status einer Zahlung ändert (z.B. von processing zu settled). 
{
  "event": "payment_update",
  "data": {
    "payment_id": "7364509182736450918",
    "status": "settled",
    "raw_provider_status": "ACCC",
    "template_identifier": "SEPA",
    "payment_attributes": {
      "amount": "150.00",
      "currency_code": "EUR",
      "description": "Rechnung RE-2026-001",
      "creditor_iban": "DE89370400440532013000",
      "creditor_name": "Mustermann GmbH",
      "debtor_iban": "DE27100777770209299700",
      "end_to_end_id": "RE-2026-001",
      "customer_ip_address": "203.0.113.42"
    },
    "custom_fields": {
      "invoice_id": "RE-2026-001"
    }
  },
  "received_at": "2026-03-31T14:35:00.000Z"
}
FeldTypBeschreibung
payment_idstringID der Zahlung
statusstringAktueller Status (siehe unten)
raw_provider_statusstring | nullRoher Bank-Statuscode (z.B. ACCC, ACSC)
template_identifierstringSEPA oder SEPA_INSTANT
payment_attributesobjectZahlungsdetails (amount, creditor_iban, creditor_name, debtor_iban, etc.)
custom_fieldsobjectBenutzerdefinierte Felder aus dem Create-Request (falls gesetzt)

​
Payment Status-Werte

StatusBeschreibung
processingZahlung wird verarbeitet
settledZahlung erfolgreich ausgeführt
failedZahlung fehlgeschlagen
rejectedZahlung von der Bank abgelehnt
initiated_info_requiredZahlung initiiert, wartet auf TAN-Bestätigung
Der raw_provider_status gibt den Original-Statuscode der Bank zurück. Gängige Werte sind ACCC (AcceptedSettlementCompleted) und ACSC (AcceptedSettlementCompletedDebitorAccount). Verwende das status-Feld für die Logik in deiner Integration.

​
Verbrauch

Webhooks verbrauchen keine Credits. Die 3 Credits für eine Zahlung werden erst beim erfolgreichen Settlement (settled) bestätigt.