Auszahlungs-Webhook

Payload-Struktur für Auszahlungs-Webhooks.

Inhalt

KeyTypeDescription
uuidstring
  • Öffentliche Auszahlungs-ID
  • 8–40 Zeichen lang
modestring
  • Auszahlungsmodus
  • Mögliche Werte: TEST oder LIVE
objectstringImmer payout
amountintGesamtbetrag der Auszahlung
total_feesintSumme der Gebühren innerhalb der Auszahlung
currencystringISO 4217-Währungscode
datestringDatum der Auszahlung im Format 2026-01-16
statementstringBankverwendungszweck
payerstring
  • Initiator der Auszahlung
  • API-Literale: stripe, payrexx oder unknown
  • payrexx = Auszahlung über die zahls.ch-Plattform (fester API-Wert)
statusstringStatus der Auszahlung
destinationDestinationDestination
transfersarray of TransfersTransfer
merchantMerchantMerchant
is_manual_payoutboolWurde die Auszahlung manuell durch den Händler erstellt

Statuswerte

StatusDescription
initiated *Auszahlung wurde vom System initiiert
pending *Auszahlung ist erstellt und bereit zur Verarbeitung
under-review *Auszahlung muss genauer geprüft werden
processingAuszahlungsdatei wurde an die Bank übermittelt
sentAuszahlung erfolgreich an die Bank übertragen
failedAuszahlung fehlgeschlagen und von der Bank zurückgewiesen

Beispiel

{
  "uuid": "AABB1122",
  "mode": "TEST",
  "object": "payout",
  "amount": 29390,
  "total_fees": 310,
  "currency": "CHF",
  "date": "2026-01-06",
  "statement": "zahls.ch Demo Shop Thun",
  "payer": "payrexx",
  "status": "processing",
  "destination": {
    "type": "bank_account",
    "iban": "CH36 8914 4576 4981 8798 3",
    "account_holder": "Demo Firma CH"
  },
  "transfers": [
    {
      "type": "payout-fee",
      "amount": -10,
      "date_time": "2026-01-06T13:45:18+00:00",
      "items": [
        {
          "type": "payout-fee",
          "amount": -10
        }
      ],
      "transaction": {}
    },
    {
      "type": "transaction",
      "amount": 29400,
      "date_time": "2025-12-25T13:44:30+00:00",
      "items": [
        {
          "type": "transaction",
          "amount": 30000
        },
        {
          "type": "transaction-fee",
          "amount": -300
        }
      ],
      "transaction": {
        "type": "transaction",
        "amount": 30000,
        "uuid": "aabb1122",
        "fee": 300,
        "currency": "EUR",
        "time": "2026-01-06T14:44:31+01:00",
        "payment": {
          "brand": "visa"
        },
        "reference_id": ""
      }
    }
  ],
  "merchant": {
    "name": "demo",
    "site_title": "zahls.ch",
    "owner": {
      "company": "Demo Firma",
      "first_name": "Jane",
      "last_name": "Doe",
      "address": "Burgstrasse 20",
      "zip": "3600",
      "place": "Thun",
      "email": "test@zahls.ch"
    }
  },
  "is_manual_payout": false
}