Nightly Settlement File Feed
Nightly Settlement File Feed publishes one CSV per business day to /outbound/settlement at approximately 02:00 UTC, named settlement_YYYYMMDD.csv for the date being settled. Authentication is by SSH key; send your public key to onboarding and connect as the account issued to you. Files remain available for 30 days. A zero-row file is still published on days with no activity, so an absent file means the run did not complete rather than that there was nothing to settle.
- Service type
- SFTP / Batch file feed
Formats
CSV
Filename patterns
settlement_YYYYMMDD.csv
csv
settlement_20261022.csv
| settlement_date | transaction_id | account_id | amount | currency | status | scheme_reference |
|---|---|---|---|---|---|---|
| 2026-10-22 | TXN-8841023 | ACC-00017734 | -125.50 | GBP | settled | MC-5512098331 |
| 2026-10-22 | TXN-8841024 | ACC-00017734 | -9.99 | GBP | settled | MC-5512098332 |
| 2026-10-22 | TXN-8841025 | ACC-00028110 | 2400.00 | GBP | settled | FPS-7781220045 |
| 2026-10-22 | TXN-8841026 | ACC-00028110 | -87.20 | GBP | reversed | MC-5512098340 |
| 2026-10-22 | TXN-8841027 | ACC-00031902 | -1500.00 | EUR | settled | SEPA-99120034 |
json schema
Settlement file row
Column definition for one row of settlement_YYYYMMDD.csv. The file is UTF-8, comma separated, with a header row, published daily to /outbound/settlement.
| Field | Type | Required | Description |
|---|---|---|---|
settlement_date |
string (date) |
yes | Business day being settled (YYYY-MM-DD). |
transaction_id |
string |
yes | Unique transaction reference. |
account_id |
string |
yes | Account the transaction settled against. |
amount |
number |
yes | Signed amount. Negative is a debit. |
currency |
string |
yes | ISO 4217 currency code. |
status |
string |
yes | Settlement outcome for the row. |
scheme_reference |
string |
no | Card or payment scheme reference, when the scheme supplies one. |
- Host
sftp-uat.digitalapi.ai:22- Remote path
/outbound/settlement- Direction
- Outbound — files published for pickup
- Authentication
- SSH key
- Schedule
- Daily at 02:00 UTC