/v2/budgets/{budgetId}/direct-debits endpoint to create a Direct Debit mandate from a paper mandate — a signed physical form that authorises an originator to collect payments from a payer’s bank account. Paper mandates are the offline equivalent of setting up a Direct Debit digitally.
This is useful when you need to manage mandates that weren’t created through the API. For example, if your business collected Direct Debit authorisations on paper before your integration existed, those mandates still need to be registered in the system. The reference field is the link between the physical form and the mandate record — you’ll find it printed on the original paper mandate.
This endpoint is specifically for paper mandates. Electronic mandates are set up directly by the originator through the BACS network and don’t need to be created via the API.
Create a Direct Debit mandate
POST
/v2/budgets/{budgetId}/direct-debitsQuery parameters
Request body
Sample request
Sample response
If your request is successful, you’ll receive a201 response.