Settlement

Settlement is where the network settles net amounts between your settlement account(s) and the network. Settlement is typically generated once per day per settlement account / currency.

How it works

1. Open Fabric sends a settlement file ready notification (see Settlement file ready notification).
2. You download the settlement report from the download_url in the settlement file ready notification.
3. You process the file for your finance operations and reconciliation.

info

download_url is a pre-signed link that expires at download_url_expires_at. To get a fresh one, call Generate report download URL with the file_ref from the notification.

The report is also uploaded to an S3 bucket established during onboarding; file_ref is its S3 URI (s3://<bucket>/<key>).

Structure of the Settlement Report

File name PBA_EOS_<UUID>_<YYYYMMDD>_<HHmmSS>.json

File format JSON

Location S3 Bucket as configured for you.

Frequency Once a day, corresponding to the end of settlement cycles from the card network.

note

The settlement report should be delivered approximately around 19:10 UTC

Schema The settlement report is made up of two sections:

1. Net settlement summary: totals, net amount, dates, and currency metadata.
2. Settlement records: line-by-line records and fees.

See Settlement report schema for details.