Webhooks for the Transfers API

This API supports webhooks. When asynchronous events occur on our side, we can send an HTTP call (webhook) to your application, so you can react to these events in real time.

You can set up webhooks via the dashboard. See the Next-gen Webhooks guide.

The payload of a webhook is always simply a snapshot of the entity, as returned by the GET endpoint.

If you are setting up webhooks via the Webhooks API instead for any of the events below, you will need access to business-account-transfers.read.

Available webhook events

Event	Description
`business-account-transfer.blocked`	The transfer is blocked.
`business-account-transfer.failed`	The transfer fails to be executed.
`business-account-transfer.initiated`	The transfer is SCA-authorized for execution. Funds are reserved.
`business-account-transfer.pending-review`	The transfer is pending manual review.
`business-account-transfer.processed`	The transfer is processed.
`business-account-transfer.requested`	The transfer is requested and waiting for SCA (exempt for Transfers API). SEPA transfer input checks passed.
`business-account-transfer.returned`	Incoming transfer when a transfer is returned.

Webhook payload examples

{
  "resource": "business-account-transfer",
  "id": "batrf_87GByBuj4UCcUTEbs6aGJ",
  "mode": "live",
  "businessAccountTransactionId": "batr_87GByBuj4UCcUTEbs6aGJ",
  "transferScheme": {
    "type": "sepa-credit-inst"
  },
  "creditDebitIndicator": "debit",
  "amount": {
    "currency": "EUR",
    "value": "100.00"
  },
  "debtor": {
    "fullName": "Mollie B.V.",
    "account": {
      "iban": "NL55MLLE0123456789"
    }
  },
  "creditor": {
    "fullName": "Jan Jansen",
    "account": {
      "iban": "NL02ABNA0123456789"
    }
  },
  "description": "Invoice 12345",
  "status": "blocked",
  "statusReason": {
    "code": "rejected",
    "message": null
  },
  "statusHistory": [
    {
      "status": "requested",
      "createdAt": "2025-01-01T12:00:00+00:00"
    },
    {
      "status": "pending-review",
      "createdAt": "2025-01-01T12:00:01+00:00"
    },
    {
      "status": "blocked",
      "createdAt": "2025-01-01T14:00:00+00:00"
    }
  ],
  "createdAt": "2025-01-01T12:00:00+00:00"
}

{
  "resource": "business-account-transfer",
  "id": "batrf_87GByBuj4UCcUTEbs6aGJ",
  "mode": "live",
  "businessAccountTransactionId": "batr_87GByBuj4UCcUTEbs6aGJ",
  "transferScheme": {
    "type": "sepa-credit-inst"
  },
  "creditDebitIndicator": "debit",
  "amount": {
    "currency": "EUR",
    "value": "100.00"
  },
  "debtor": {
    "fullName": "Mollie B.V.",
    "account": {
      "iban": "NL55MLLE0123456789"
    }
  },
  "creditor": {
    "fullName": "Jan Jansen",
    "account": {
      "iban": "NL02ABNA0123456789"
    }
  },
  "description": "Invoice 12345",
  "status": "failed",
  "statusReason": {
    "code": "insufficient-funds",
    "message": null
  },
  "statusHistory": [
    {
      "status": "requested",
      "createdAt": "2025-01-01T12:00:00+00:00"
    },
    {
      "status": "initiated",
      "createdAt": "2025-01-01T12:00:01+00:00"
    },
    {
      "status": "failed",
      "createdAt": "2025-01-01T12:00:30+00:00"
    }
  ],
  "createdAt": "2025-01-01T12:00:00+00:00"
}

{
  "resource": "business-account-transfer",
  "id": "batrf_87GByBuj4UCcUTEbs6aGJ",
  "mode": "live",
  "businessAccountTransactionId": "batr_87GByBuj4UCcUTEbs6aGJ",
  "transferScheme": {
    "type": "sepa-credit-inst"
  },
  "creditDebitIndicator": "debit",
  "amount": {
    "currency": "EUR",
    "value": "100.00"
  },
  "debtor": {
    "fullName": "Mollie B.V.",
    "account": {
      "iban": "NL55MLLE0123456789"
    }
  },
  "creditor": {
    "fullName": "Jan Jansen",
    "account": {
      "iban": "NL02ABNA0123456789"
    }
  },
  "description": "Invoice 12345",
  "status": "initiated",
  "statusReason": null,
  "statusHistory": [
    {
      "status": "requested",
      "createdAt": "2025-01-01T12:00:00+00:00"
    },
    {
      "status": "initiated",
      "createdAt": "2025-01-01T12:00:01+00:00"
    }
  ],
  "createdAt": "2025-01-01T12:00:00+00:00"
}

{
  "resource": "business-account-transfer",
  "id": "batrf_87GByBuj4UCcUTEbs6aGJ",
  "mode": "live",
  "businessAccountTransactionId": "batr_87GByBuj4UCcUTEbs6aGJ",
  "transferScheme": {
    "type": "sepa-credit-inst"
  },
  "creditDebitIndicator": "debit",
  "amount": {
    "currency": "EUR",
    "value": "100.00"
  },
  "debtor": {
    "fullName": "Mollie B.V.",
    "account": {
      "iban": "NL55MLLE0123456789"
    }
  },
  "creditor": {
    "fullName": "Jan Jansen",
    "account": {
      "iban": "NL02ABNA0123456789"
    }
  },
  "description": "Invoice 12345",
  "status": "pending-review",
  "statusReason": null,
  "statusHistory": [
    {
      "status": "requested",
      "createdAt": "2025-01-01T12:00:00+00:00"
    },
    {
      "status": "pending-review",
      "createdAt": "2025-01-01T12:00:01+00:00"
    }
  ],
  "createdAt": "2025-01-01T12:00:00+00:00"
}

{
  "resource": "business-account-transfer",
  "id": "batrf_87GByBuj4UCcUTEbs6aGJ",
  "mode": "live",
  "businessAccountTransactionId": "batr_87GByBuj4UCcUTEbs6aGJ",
  "transferScheme": {
    "type": "sepa-credit-inst"
  },
  "creditDebitIndicator": "debit",
  "amount": {
    "currency": "EUR",
    "value": "100.00"
  },
  "debtor": {
    "fullName": "Mollie B.V.",
    "account": {
      "iban": "NL55MLLE0123456789"
    }
  },
  "creditor": {
    "fullName": "Jan Jansen",
    "account": {
      "iban": "NL02ABNA0123456789"
    }
  },
  "description": "Invoice 12345",
  "status": "processed",
  "statusReason": null,
  "statusHistory": [
    {
      "status": "requested",
      "createdAt": "2025-01-01T12:00:00+00:00"
    },
    {
      "status": "initiated",
      "createdAt": "2025-01-01T12:00:01+00:00"
    },
    {
      "status": "processed",
      "createdAt": "2025-01-01T12:00:30+00:00"
    }
  ],
  "createdAt": "2025-01-01T12:00:00+00:00"
}

{
  "resource": "business-account-transfer",
  "id": "batrf_87GByBuj4UCcUTEbs6aGJ",
  "mode": "live",
  "businessAccountTransactionId": "batr_87GByBuj4UCcUTEbs6aGJ",
  "transferScheme": {
    "type": "sepa-credit-inst"
  },
  "creditDebitIndicator": "debit",
  "amount": {
    "currency": "EUR",
    "value": "100.00"
  },
  "debtor": {
    "fullName": "Mollie B.V.",
    "account": {
      "iban": "NL55MLLE0123456789"
    }
  },
  "creditor": {
    "fullName": "Jan Jansen",
    "account": {
      "iban": "NL02ABNA0123456789"
    }
  },
  "description": "Invoice 12345",
  "status": "requested",
  "statusReason": null,
  "statusHistory": [
    {
      "status": "requested",
      "createdAt": "2025-01-01T12:00:00+00:00"
    }
  ],
  "createdAt": "2025-01-01T12:00:00+00:00"
}

{
  "resource": "business-account-transfer",
  "id": "batrf_87GByBuj4UCcUTEbs6aGJ",
  "mode": "live",
  "businessAccountTransactionId": "batr_87GByBuj4UCcUTEbs6aGJ",
  "transferScheme": {
    "type": "sepa-credit-inst"
  },
  "creditDebitIndicator": "debit",
  "amount": {
    "currency": "EUR",
    "value": "100.00"
  },
  "debtor": {
    "fullName": "Mollie B.V.",
    "account": {
      "iban": "NL55MLLE0123456789"
    }
  },
  "creditor": {
    "fullName": "Jan Jansen",
    "account": {
      "iban": "NL02ABNA0123456789"
    }
  },
  "description": "Invoice 12345",
  "status": "returned",
  "statusReason": null,
  "statusHistory": [
    {
      "status": "requested",
      "createdAt": "2025-01-01T12:00:00+00:00"
    },
    {
      "status": "initiated",
      "createdAt": "2025-01-01T12:00:01+00:00"
    },
    {
      "status": "processed",
      "createdAt": "2025-01-01T12:00:30+00:00"
    },
    {
      "status": "returned",
      "createdAt": "2025-01-01T14:00:00+00:00"
    }
  ],
  "createdAt": "2025-01-01T12:00:00+00:00"
}