Antom, leading provider of tailored payment solutionsAntom, leading provider of tailored payment solutions

结算汇总报告

结算汇总报告包含一个结算周期内的交易总数和净结算金额等信息，在收单机构和银行完成结算处理后和结算明细报告一起生成。您可以通过 SFTP 服务器 或 APO Dashboard 两种方式获取来获取该报告。

报告详情

结算汇总报告包含三部分内容：表头信息、结算汇总数据和文件结束符。文件结束符 <END> 出现在报告的最后一行，表头信息由如下字段表示，结算汇总数据由字段所对应的值表示。

下表展示了结算汇总报告正文中字段及字段说明：

字段

说明

settlementBatchId

必选 String (64)
收单机构分配的用于识别结算批次的唯一标识，与结算汇总文件中的结算批号相同。如果收单机构不分配结算批次号，APO 会生成该批次号。

customerId

必选 String (64)

收单机构为商家分配的唯一身份标识。

acquirer

必选 String (64)

负责交易处理的收单机构的名字。

该收单机构主要是指为您提供收单和资金结算服务的机构。

summaryType

可选 String (16)

结算汇总的类型。包含的值有：

  • AUTHORIZATION: 表示一个结算批次内的授权交易汇总。
  • PAYMENT: 表示一个结算批次内的成功支付的交易汇总。
  • CAPTURE: 表示一个结算批次内的请款交易汇总。
  • REFUND: 表示一个结算批次内的退款信息汇总。
  • CANCEL: 表示一个结算批次内的取消交易汇总。
  • DISPUTE: 表示一个结算批次内的拒付信息汇总。
  • VOID: 表示一个结算批次内的预授权解除交易汇总。
  • TOTAL: 表示一个结算批次内的所有结算汇总。
  • REFUND_REVERSAL: 表示一个结算批次内的退款反转交易汇总。当支付方式无法处理退款时，退款反转会发生，资金会返回到您的账户。
  • SETTLEMENT_FEE: 表示收单机构收取结算手续费。具体费用明细通过 settlmentAmountValue 和 settlementCurrency 字段体现。
  • DISPUTE_REVERSAL: 表示拒付抗辩成功，拒付发生反转。
  • COLLATERAL_WITHHOLDING: 表示保证金留存。
  • RESERVE_WITHHOLDING: 表示预留金留存。
  • RESERVE_RELEASE: 表示预留金释放。
  • COLLATERAL_RELEASE: 表示保证金释放。

settlementTime

必选 String (64)

收单机构向您结算的日期和时间，格式为 YYYY-MM-DDTHH:MM:SS+hh:mm，遵循 ISO 8601 标准。

count

必选 Integer

表示交易总数。

settlementAmountValue

必选 String (16)

净结算金额，以主要币种单位展示（例如美元用 USD 表示，日元用 JPY 表示）。

settlementCurrency

必选 String (3)

settlementAmountValue 对应的币种，为 ISO 4217 中定义的三位字母币种代码。

feeAmountValue

可选 String (16)

处理该笔交易收取的各种费用的总金额，以主要币种单位展示（例如美元用 USD 表示，日元用 JPY 表示）。

feeCurrency

必选 String (3)

feeAmountValue 对应的币种，为 ISO 4217 中定义的三位字母币种代码。

表 1. 结算汇总报告字段及说明

注意：请利用表头字段信息进行账单解析。您从 SFTP 和 APO Dashboard 所下载的账单中的字段顺序不一定与上方报告中显示的字段顺序一致。

报告样例

如下样例分别展示了不同场景下的报告。

样例一（标准账单）

2025 年 5 月 6 日，ID 为 21111100000xxxx 的商家产生了一笔付款交易。结算打款并收到银行回执后，APO 生成了一个 CSV 文件，详情如下：

copy
settlementBatchId,customerId,acquirer,summaryType,settlementTime,count,settlementAmountValue,settlementCurrency,feeAmountValue,feeCurrency
"202505051967155612 ","2111110000022047 ",ALIPAY,PAYMENT,2025-05-06T05:18:17+08:00,1,0.98,HKD,-0.02,HKD
"202505051967155612 ","2111110000022047 ",ALIPAY,TOTAL,2025-05-06T05:18:17+08:00,1,0.98,HKD,-0.02,HKD
<END>,,,,,,,,,

📎结算汇总报告-样例一.csv

在本样例中，收单机构为 Antom，结算币种（settlementCurrency）为 HKD，结算金额（settlementAmountValue）在不同结算类型（summaryType）下的值分别为：

  • PAYMENT：支付对应的 settlementAmountValue 值为 0.98，表示 APO 需给到商家的支付金额为 0.98 HKD。
  • TOTAL：结算汇总下 settlementAmountValue 值为 0.98，表示通过支付和退款结算金额计算后，APO 需最终结算给商家的净结算额为 0.98 USD。

样例二（无交易）

copy
settlementBatchId,customerId,acquirer,summaryType,settlementTime,count,settlementAmountValue,settlementCurrency,feeAmountValue,feeCurrency
<END>,,,,,,,,,

📎结算汇总报告-样例二.csv

注意：无交易的情况下，默认 SFTP 服务器不会产生账单。若您需要无交易下的空账单，您可以联系 APO 技术支持在 SFTP 服务器下进行配置。