Bank withdrawal webhooks

Txn sends a bank withdrawal webhook each time a bank withdrawal transaction's simplifiedState changes. The payload mirrors the Read bank withdrawal endpoint response.

The tabs below show example payloads for each state.

For configuring webhook URLs, retry behaviour, source IPs, and signature verification, see the general Webhooks section.

Pending

{
  "data": {
    "attributes": {
      "amount": "-1.01",
      "createdAt": "2025-01-28T17:21:13.534Z",
      "reference": null,
      "simplifiedState": "pending",
      "transactionType": "BankWithdrawalTransaction"
    },
    "id": "a67076da-14cc-4f20-a443-8ffe1766fd31",
    "relationships": {
      "account": {
        "meta": {
          "included": false
        }
      },
      "transactionDetails": {
        "data": {
          "id": "a67076da-14cc-4f20-a443-8ffe1766fd31",
          "type": "bank_withdrawal_transactions"
        }
      }
    },
    "type": "transactions"
  },
  "included": [
    {
      "attributes": {
        "absorbFees": true,
        "amount": "1.01",
        "bankBic": "GUPULT22XXX",
        "bankName": "BANK NAME",
        "beneficiaryName": "Acme Ltd",
        "createdAt": "2025-01-28T17:21:13.493Z",
        "currency": "EUR",
        "fee": "0.01",
        "iban": "LT563400023810000822",
        "payAmount": "1.00",
        "paymentStatus": "created",
        "reference": "BDR6421088115176062",
        "state": "pending",
        "updatedAt": "2025-01-28T17:21:13.493Z"
      },
      "id": "a67076da-14cc-4f20-a443-8ffe1766fd31",
      "relationships": {
        "account": {
          "data": {
            "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
            "type": "accounts"
          }
        },
        "bankAccount": {
          "data": {
            "id": "849b4c2d-698b-4bde-9203-5cddcb8ea6e1",
            "type": "bank_accounts"
          }
        }
      },
      "type": "bank_withdrawal_transactions"
    },
    {
      "attributes": {
        "bankBic": "GXPTLT22XXX",
        "bankName": "BANK NAME",
        "beneficiaryName": "Acme Ltd",
        "createdAt": "2024-11-21T14:01:20.154Z",
        "currencyCode": "EUR",
        "iban": "LT563400023810000822",
        "updatedAt": "2024-12-27T13:52:12.012Z"
      },
      "id": "849b4c2d-698b-4bde-9203-5cddcb8ea6e1",
      "type": "bank_accounts"
    },
    {
      "attributes": {
        "balance": "32218.80",
        "currencyCode": "EUR",
        "currencyType": "fiat"
      },
      "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
      "relationships": {
        "company": {
          "meta": {
            "included": false
          }
        },
        "networks": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "accounts"
    }
  ],
  "meta": {}
}

Completed

Cancelled