Webhooks
Webhook notifications allow you to efficiently track payments states, and enable you to automate communication internally or with your customers
Webhook notifications allow you to efficiently track payments states, and enable you to automate communication internally or with your customers. They are push notifications sent as webhook message to URLs you define. We do not recommend using webhooks as a replacement for reconciliation purposes, here we refer you to our Reconciliation report.
You can subscribe to several payment events. When one of these events is triggered, we send a HTTP POST request to a URL of your choice in a JSON format. Along with the event, data about the payment is included, which we refer to as the payload.
Limitations
Due to the nature of webhook technology, we cannot guarantee delivery for every event, nor that duplicate events may not occur.
Supported events
These are the payment events for which you can subscribe to. You can refer to the Payment lifecycle for additional context on how payments change from status to another.
| Event | Description | Enum |
|---|---|---|
| IncomingPaymentProcessed | One of your accounts is successfully funded (this also includes internal credit transfers) | 1 |
| OutgoingPaymentRejected | One of your outgoing payments is rejected. The status of the payment is now Rejected | 2 |
| OutgoingPaymentProcessed | One of your outgoing payments is successfully processed (this also includes internal debit transfers). The status of the payment is now Processed | 3 |
| MissingFunding | One of your outgoing payments cannot be executed due to insufficient balance. The payment will be automatically executed when there are sufficient funds, or rejected after 2 days. The status of the payment is now MissingFunding | 4 |
| Reversed | One of your outgoing payments is reversed. The status of the payment is now Reversed | 5 |
| OutgoingPaymentBooked | One of your outgoing payments is successfully booked on your account. | 6 |
| PaymentRouting | One of your outgoing payment is routed via other payment scheme. More details will be available in 'routingStatus' field. | 7 |
| IncomingPaymentBooked | One of your incoming payments is successfully booked on your account | 8 |
| AccountHolderVerification | The response to an Account Verification Request. More information in Account Holder Verification. | 9 |
| OutgoingDirectDebitPendingProcessing | One of your accounts has an outgoing payment initiated by a third party (e.g. through Bacs or SEPA Direct Debit) that is pending processing. | 10 |
Subscriptions and subscription events
Our setup is flexible: you can create one subscription for all (or some) event types or you can create separate subscriptions specific to an event type. You can also setup subscriptions at a company level or on a bank account level. Here are two examples to illustrate the different setups.
Example where multiple event types covering one company are subscribed to a single URL
Example where each event type covering a subset of bank accounts is subscribed to a unique URL
Updated 8 days ago