Obtain reports
Antom provides the following five reconciliation reports:
- Transaction details report
- Settlement details report
- Settlement summary report
- Account activity report
- Daily ending balance report
You can download reconciliation reports from the SFTP server in CSV and XLSX formats. All reports are UTF-8 encoded by Antom before they are uploaded to the server.
The reconciliation reports downloaded from the SFTP server can be customized according to your requirements. The configured content in the SFTP server cannot be automatically updated when the reconciliation report capability is updated unless otherwise requested.
Server login
Complete the following steps first before you obtain reconciliation reports from the SFTP server:
- Contact Antom Merchant Service technical support (AlipayGlobalTechService@service.alipay.com) to obtain SFTP login credentials and submit the public IP address to access the SFTP server.
- Log in to the SFTP server using the following information:
- Port: 22
- Hostname: isftp.alipay.com (If the loading speed of this link is slow, try sftp.alipay.com.)
- Username and password
Notes:
- SFTP accounts that are not used for 90 days will be disabled.
- Reconciliation reports older than 7 days on the SFTP server might be deleted.
- In the case of no transaction, you can contact Antom Merchant Service technical support (AlipayGlobalTechService@service.alipay.com) to configure whether to generate reconciliation reports.
For the specific download path of the report, see the following section.
Report download path
The download path for all reconciliation reports is report directory + report name. For example, the download path for a settlement details report: /v1/settlements/102*************234/20221024/settlementItems_USD_202*************234_000.csv.
Report type | Report directory format | Default report name format |
Transaction details report | /v1/settlements/<platformMerchantId>/<transactionDate>/ | transactionItems_<transactionDate>_000.csv |
Settlement details report | /v1/settlements/<platformMerchantId>/<settlementDate>/ | settlementItems_<settlementCurrency>_<settlementBatchId>_000.csv |
Settlement summary report | /v1/settlements/<platformMerchantId>/<settlementDate>/ | settlementSummary_<settlementCurrency>_<settlementBatchId>_000.csv |
Account activity report | /v1/settlements/<platformMerchantId>/<accountDate>/ | accountLogItems_<accountDate>_000.csv |
Daily ending balance report | /v1/settlements/<platformMerchantId>/<accountDate>/ | accountDailyBalance_<accountDate>_000.csv |
The concepts in the report directory and default name format are defined as follows:
- platformMerchantId: the unique ID assigned by Antom for a marketplace
- transactionDate: the date of the transaction
- settlementDate: the date when Antom settles with the marketplace or sub-merchants
- accountDate: the date when the ending balance of the account is recorded
- settlementCurrency: the settlement currency used by Antom for settling transactions with the marketplace or sub-merchants
- settlementBatchId: the unique ID that is assigned by the acquirer to identify a settlement period
To customize the report name, contact Antom Merchant Service technical support (AlipayGlobalTechService@service.alipay.com).