Skip to main content
Subscribe to Direct Debit webhook events to receive real-time notifications about mandate activity.

DirectDebitCreated

A new Direct Debit mandate has been created.

Sample payload

Event fields

DirectDebitCancelled

A Direct Debit mandate has been cancelled.

Sample payload

Event fields

DirectDebitPaymentRejected

A Direct Debit collection has been rejected and won’t be paid. We don’t send this event when a collection can’t be matched to a Direct Debit on the account (reason codes 5, 6 and A). If the collection is the fourth rejected in a row, we also cancel the Direct Debit and send a DirectDebitCancelled event. The two events can arrive in either order.

Sample payload

Event fields

Reason codes

Successful collections

We don’t send a separate event when a collection is paid. The money leaving the budget is reported by a BoxDebited event, which carries the collection’s payRequestId. It matches payRequestId on DirectDebitPaymentRejected and the id of the payment request, so you can match the debit to the collection it paid. A collection’s BoxDebited has source set to direct_debit and no orderId.