Daily Order Settlement Feed
Finance teams reconcile marketplace activity against this nightly settlement feed. Each file contains one row per completed order with amounts, fees, and payout references. Files are dropped on the SFTP endpoint after the daily close and retained for 90 days. The column reference and a machine-readable JSON Schema of the record format are attached.
- Service type
- SFTP / Batch file feed
Formats
CSV
Filename patterns
orders-YYYYMMDD.csv
orders-YYYYMMDD.csv.done
csv
orders-feed.csv
| orderId | amount | currency | createdAt |
|---|---|---|---|
| ORD-1001 | 49.99 | USD | 2026-07-01T10:00:00Z |
| ORD-1002 | 15.00 | GBP | 2026-07-01T11:30:00Z |
| ORD-1003 | 120.50 | EUR | 2026-07-02T08:15:00Z |
json schema
Order record
One order line in the daily batch feed.
| Field | Type | Required | Description |
|---|---|---|---|
orderId |
string |
yes | Unique order identifier. |
amount |
number |
yes | Order total in minor units. |
currency |
string |
no | ISO 4217 currency code. |
createdAt |
string (date-time) |
no | Order creation timestamp. |
Authenticate with your provisioned SSH key. Poll after 02:30 UTC; the file for day D is named orders-YYYYMMDD.csv with a .done marker written when the upload is complete. Never process a file without its marker.
- Host
sftp.settlement.example.com:22- Remote path
/outbound/settlement- Direction
- Outbound — files published for pickup
- Authentication
- SSH key
- Schedule
- Daily at 02:00 UTC (available by 02:30 UTC)