GuidesAPI Reference
Log In
API Reference

File Based Settlements

SFTP File Exchange

Liberis allows settlement records to be shared through Liberis' SFTP, using a Liberis owned schema CSV. A daily record of the previous days aggregated revenue and the split paid to Liberis for active deal merchants must be submitted through the Liberis SFTP server for ingestion.

Location: /Inbound/Reconciliation/

Recommended file name: daily_reconciliation_{yyyyMMdd}.csv - optionally, the date could include time yyyyMMddHHmmss

Any .csv file uploaded to the shared location will be treated as a settlement file and processed automatically, provided the file name is unique. Although not required, using a meaningful file name helps speed up issue diagnosis and resolution.
We also recommend not modifying files after they are uploaded. If you encounter unusual or irregular issues, please contact us so we can assist with manual resolution.

Access to Liberis SFTP is granted during integration for File Transfer.

Templates

Daily Reconciliation File - Empty Template

Daily Reconciliation File - Filled Template

File format

Liberis ESplit File Exchange

ColumnDescriptionFormat
Transaction_DateDate of transaction

Date Only

yyyy-MM-dd

Settlement_DateDate of end of settlement when payment arrives at Liberis (for Unsettled transactions)

Date Only

yyyy-MM-dd

Liberis_IDLiberis Company IDGUID
Application_IDLiberis Application IDGUID
Company_IDPartner's internal ID for merchantString
Payment_Channel_IDPayment Channel id, source of TXString
Transaction_ReferenceOPTIONAL - Reference of settlement in merchant's bank accountString
CurrencyCurrency of transaction - ISO standardString
Transaction_AmountRaw transaction value prior to split For Settled transactions, this is the total of settlement period transaction_amountsDouble
Split_PercentageSplit percentage sent to Liberis for repaymentInteger
Repayment_AmountTransaction_Amount * (Split_Percentage / 100) For Settled transactions, total of settlement period transactions repayment_amountsDouble
Transaction_Typeone of:
  • Unsettled
  • Settled
String
Batch_IDOPTIONAL - Allows Liberis to reconcile batch payment.
If partner settles >T+1, this MUST be provided
String

Flow