Direct Debit Runs
A Direct Debit run processes a batch of payments on a chosen date. The API lets you retrieve runs and their results. Most businesses let automatic collection create and process runs; see Payment Runs.
Methods
Section titled “Methods”Retrieve Single Direct Debit Run
Section titled “Retrieve Single Direct Debit Run”/backend/api/v1/directDebitRuns/ID - fetch the run with the specified ID.
List Direct Debit Runs
Section titled “List Direct Debit Runs”/backend/api/v1/directDebitRuns/ - list all Direct Debit runs.
Additional Query Parameters
Section titled “Additional Query Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
idAfter | integer | No | Only include runs with a higher ID |
createdSince | datetime | No | Only include runs created since the given time |
updatedSince | datetime | No | Only include runs updated since the given time |
Runs are created and processed by the payment-run workflow and automatic collection, not through the API, so the endpoint is read-only.
Fields
Section titled “Fields”| Field | Name | Type | Description |
|---|---|---|---|
| ourReference | Our Reference | Text | Unique reference identifier for this direct debit run |
| status | Status | Preset Value | Current processing status of the direct debit run |
| commencedDate | Commenced Date | Date | Date when this direct debit run was commenced |
| completedDate | Completed Date | Date | Date when this direct debit run was completed |
| collectedAmount | Collected Amount | Currency | Total amount successfully collected in this direct debit run |
| paymentDate | Payment Date | Date | The date when payments will be credited to invoices |
| collectionDate | Collection Date | Date | The date when funds will be collected from the payment provider (if different than the payment date) |
| invoiceDate | Invoice Date | Date | Minimum invoice date for including invoices in this direct debit run |
| id | Direct Debit Run ID | Text | The unique identifier for this direct debit run |