Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

获取对账报告

您可以通过 SFTP 服务器中的特定目录下载对账报告,Antom 会将所有报告进行 UTF-8 编码并上传到 SFTP 中。通过 SFTP 下载的账单是可以根据您的要求进行定制化配置的,所配置内容在无要求的情况下不会自动根据账单能力的更新而变更。

服务器登陆

通过 SFTP 获取报告,您首先需要完成以下步骤:

  1. 联系 Antom 技术支持AlipayGlobalTechService@service.alipay.com获取 SFTP 登录凭证并提交访问 SFTP 服务器的公网 IP 地址。
  2. 使用以下信息登录 SFTP 服务器并下载对账报告:
    • 端口:22
    • 主机名:isftp.alipay.com(如果该链接速度过慢,请尝试使用 sftp.alipay.com)
    • 用户名和密码

注意

报告的具体下载路径请参考下面的报告下载路径模块。

报告下载路径

所有对账报告的下载路径均为:报告目录 + 报告名。例如,一个结算明细报告的下载路径为: /v1/settlements/102218800000000****/20221024/settlementItems_USD_20221024193034****_000.csv

报告目录

不同报告类型的下载目录格式及示例如下:

报告类型

报告目录格式

例子

交易明细报告

/v1/settlements/<merchantIdByAcquirer>/<transactionDate>/

/v1/settlements/102218800000000XXXX/20181225

结算明细报告

/v1/settlements/<merchantIdByAcquirer>/<settlementDate>/

/v1/settlements/102218800000000XXXX/20181227

结算汇总报告

表 1. 不同报告的目录格式

上方目录格式中的概念解释如下:

  • merchantIdByAcquirer: Antom 用于识别商户的身份证明。
  • transactionDate: 交易日。
  • settlementDate: Antom 向商家结算的日期。

报告名

默认情况下不同报告类型的报告名及示例如下,您也可以选择联系 Antom 技术支持(AlipayGlobalTechService@service.alipay.com自定义报告名。

报告类型

报告名格式

例子

交易明细报告

transactionItems_<transactionDate>_000.csv

transactionItems_20181225_000.csv

结算明细报告

settlementItems_<settlementCurrency>_<settlementBatchId>_000.csv

settlementItems_USD_2022XXXXXXXXXXXXXXX_000.csv

结算汇总报告

settlementSummary_<settlementCurrency>_<settlementBatchId>_000.csv

settlementSummary_USD_2022XXXXXXXXXXXXXXX_000.csv

表 2. 不同报告的报告名默认格式

上方报告名格式中的概念解释如下:

  • transactionDate: 交易日。
  • settlementCurrency: 约定的结算币种,与报告中的结算币种一致。
  • settlementBatchId: 结算批次号,与结算汇总报告中的批次号一致。