对账
APO 会整合所有收单机构的账单,产出统一标准的对账报告供您对账。您可以通过 报告 和 门户 两种方式进行账。
报告对账
本部分说明对账报告的获取方法及如何使用报告进行对账。
获取报告
您可以通过以下两种方式来获取对账报告:
- 从 SFTP 服务器中下载:通过 SFTP 下载的账单是可以根据您的要求进行定制化配置的,所配置内容在无要求的情况下不会自动根据账单能力的更新而变更。
- 从 APO 门户下载:通过门户下载的账单无法根据您的需求进行定制化配置,门户账单是随着账单能力的不断更新而变化的。
SFTP
您可以通过 SFTP 服务器中的特定目录下载对账报告,APO 会将所有报告进行 UTF-8 编码并上传到 SFTP 中。通过 SFTP 服务器所下载对账报告包含.csv 和 .xlsx 格式。
服务器登陆
通过 SFTP 获取报告,您首先需要完成以下步骤:
- 联系 APO 技术支持(overseas_support@service.alibaba.com)获取 SFTP 登录凭证并提交访问 SFTP 服务器的公网 IP 地址。
- 使用以下信息登录 SFTP 服务器:
- 端口:22
- 主机名:isftp.alipay.com(如果该链接速度过慢,请尝试使用 sftp.alipay.com)
- 用户名和密码
【注意】
- 90 天未使用的 SFTP 帐户会被禁用。
- SFTP 服务器上超过 7 天的对账报告会被删除。如果您需要的报告已经被删除,您可以通过 APO 全球商家门户进行下载。
- 在无交易的情况下,您可以联系技术支持(overseas_support@service.alibaba.com) 配置是否生成对账报告。
报告的具体下载路径请参考下面的报告下载路径模块。
报告下载路径
所有对账报告的下载路径均为:报告目录 + 报告名。例如,一个结算明细报告的下载路径为: /v1/settlements/102218800000000****/20221024/settlementItems_USD_20221024193034****_000.csv
。
报告目录
不同报告类型的下载目录格式及示例如下:
报告类型 | 报告目录格式 | 例子 |
交易明细报告 |
|
|
结算明细报告 |
|
|
结算汇总报告 |
表 1. 不同报告的目录格式
上方目录格式中的概念解释如下:
- merchantIdByAcquirer: APO 用于识别商户的身份证明。
- transactionDate: 交易日。
- settlementDate: 收单机构向商家结算的日期。
报告名
默认情况下不同报告类型的报告名及示例如下,您也可以选择联系技术支持(overseas_support@service.alibaba.com)自定义报告名。
报告类型 | 报告名格式 | 例子 |
交易明细报告 |
|
|
结算明细报告 |
|
|
结算汇总报告 |
|
|
表 2. 不同报告的报告名默认格式
上方报告名格式中的概念解释如下:
- transactionDate: 交易日。
- settlementCurrency: 约定的结算币种,与报告中的结算币种一致。
- settlementBatchId: 结算批次号,与结算报告中的批次号一致。
APO 全球商家门户
通过 APO 门户获取实时对账报告或特定批次的对账报告,完成以下步骤:
- 登录门户并找到 对账中心,具体操作请参见 对账中心。
- 下载不同类型的报告:
使用报告
您可以使用如下三种交易和结算报告完成不同的对账任务:
报告类型 | 任务 |
交易明细报告 |
|
结算汇总报告 |
|
结算明细报告 |
|
表 3. 报告的类别和对账任务
门户对账
除在 APO 门户下载对账报告外,您还可以在门户的对账中心进行如下操作来辅助您进行对账:
- 实时查询交易