Antom, leading provider of tailored payment solutions

结算汇总报告

结算汇总报告包含一个结算周期内的交易总数和净结算金额等信息,于结算打款后收到银行回执的次日和结算明细报告一起生成。您可以通过 SFTP 服务器 或 Antom 商家门户 两种方式获取来获取该报告。

报告详情

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

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

字段

说明

settlementBatchId

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

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: 表示拒付抗辩成功,拒付发生反转。
  • PAYMENT_REVERSAL:表示该交易最终支付成功。
  • COLLATERAL_WITHHOLDING: 表示保证金留存。
  • RESERVE_WITHHOLDING:表示预留金留存。
  • RESERVE_RELEASE:表示预留金释放。
  • COLLATERAL_RELEASE:表示保证金释放。
  • RAPID_DISPUTE_RESOLUTION: 表示交易类型为 RDR 争议。

settlementTime

必选 String (64)

结算报告生成的日期和时间,格式为 YYYY-MM-DDTHH:MM:SS+hh:mm,遵循 ISO 8601 标准。

count

必选 Integer

表示交易总数。

settlementAmountValue

必选 String (16)

净结算金额,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。

当收单机构为恒生且 summaryType 的值为 TOTAL 时,该字段值是准确的。但当收单机构为恒生且 summaryType 的值为其它时,该字段值可能有所偏差。预知详情,请参考 恒生收单 和 样例二。

settlementCurrency

必选 String (3)

settlementAmountValue 对应的币种,为 ISO 4217 中定义的 3 个字母的货币代码。

feeAmountValue

必选 String (16)

收单机构收取的手续费金额,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。

当收单机构为恒生时,该字段值可能有所偏差。预知详情,请参考 恒生收单 和 样例二。

当收单机构为 2C2P 的时候,可能会通过该字段来传递校差信息。预知详情,请参考 Interchange++ 报价模式 和 样例三。

feeCurrency

必选 String (3)

feeAmountValue 对应的币种,为 ISO 4217 中定义的 3 个字母的货币代码。

taxFeeAmountValue

可选 String (16)

税费,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。

当收单机构为恒生时,该字段值可能有所偏差。预知详情,请参考 恒生收单 和 样例二。

taxFeeCurrency

可选 String (3)

taxFeeAmountValue 对应的币种,为 ISO 4217 中定义的 3 个字母的货币代码。

processingFeeAmountValue

可选 String (16)

Antom 为每笔交易提供的支付处理服务费用金额,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。

processingFeeCurrency

可选 String (3)

processingFeeAmountValue 对应的币种。值为 ISO 4217 中定义的 3 个字母的货币代码。

nonGuaranteeCouponValue

可选 String (16)

商家折扣金额,该金额会在结算给商家的总金额中直接扣除,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。

nonGuaranteeCouponCurrency

可选 String (3)

nonGuaranteeCouponValue 对应的币种,为 ISO 4217 中定义的 3 个字母的货币代码。

disputeHandlingFee

可选 String (16)

Antom 向商家收取的拒付处理的费用金额,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。

disputeHandlingFeeCurrency

可选 String (3)

disputeHandingFee 对应的币种,为 ISO 4217 中定义的 3 个字母的货币代码。

disputeReverseFee

可选 String (16)

Antom 向商家收取的拒付反转费用,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。

当商家同意拒付并向 Antom 请求抗辩的时候,该字段会有值。

disputeReverseFeeCurrency

可选 String (3)

disputeReverseFee 对应的币种,为 ISO 4217 中定义的 3 个字母的货币代码。

interchangeFeeAmountValue

可选 String (16)

发卡行收取的费用,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。在结算明细报告中,该值精确到小数点后八位;在结算汇总报告中,该值会通过银行家算法四舍五入到小数点后两位。

当 paymentMethodType 为 CARD,且 Interchange++ 报价模式被使用时该字段有值。

interchangeFeeCurrency

可选 String (3)

interchangeFeeAmountValue 对应的币种。

当 paymentMethodType 为 CARD,且 Interchange++ 报价模式被使用时该字段有值。

schemeFeeAmountValue

可选 String (16)

卡组收取的费用,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。在结算明细报告中,该值精确到小数点后八位;在结算汇总报告中,该值会通过银行家算法四舍五入到小数点后两位。

当 paymentMethodType 为 CARD,且 Interchange++ 报价模式被使用时该字段有值。

schemeFeeCurrency

可选 String (3)

schemeFeeAmountValue 对应的币种。

当 paymentMethodType 为 CARD,且 Interchange++ 报价模式被使用时该字段有值。

acquirerMarkupAmountValue

可选 String (16)

收单机构收取的费用,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。

当 paymentMethodType 为 CARD,且 Interchange++ 报价模式被使用时该字段有值。

acquirerMarkupCurrency

可选 String (3)

acquirerMarkupAmountValue 对应的币种。

当 paymentMethodType 为 CARD,且 Interchange++ 报价模式被使用时该字段有值。

refundFeeAmountValue

可选 String (16)

针对退款交易,收单机构收取的费用,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。

当 transactionType 为 REFUND 时该字段可能有值。

refundFeeCurrency

可选 String (3)

refundFeeAmountValue 对应的币种。

当 transactionType 为 REFUND 时该字段可能有值。

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

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

校差信息

您获取的结算报告在如下场景下可能会存在校差信息。

收单机构为恒生

当收单机构为恒生时,恒生只会提供最后的结算总金额,因此 Antom 会为您计算每笔交易的结算明细。由于计算方式不同,Antom 计算的最终结算金额与恒生提供的最终结算金额可能会有所差异,因此Antom 会在结算报告中为您提供结算金额差异的校差信息,该信息会展示在报告的倒数第二行,主要校差信息由 settlementAmountValue、feeAmountValue 和 taxFeeAmountValue 表示。例如:

  • 如果恒生提供的总结算金额为 37164,Antom 计算出来的结算总金额 (由 settlementAmountValue 字段表示)为 37140,那么 settlementAmountValue 字段对应的校差行值为 24。
  • 如果恒生提供的手续费用值为 760,Antom 计算出来的手续费用值 (由 feeAmountValue 字段表示)也为 760,那么 feeAmountValue 字段对应的校差行值为 0。
  • 如果恒生提供的税费金额值为 76,Antom 计算出来的税费金额(由 taxFeeAmountValue 字段表示)为 100,那么 taxFeeAmontValue 字段对应的校差行值为 -24。

最终的结算金额需以恒生的为准,因此根据 Antom 提供的总结算金额与校差行金额进行计算得出为最终结算金额。欲知恒生收单结算报告信息,请见 样例二。

Interchange++ 报价模式

Interchange++ 报价模式真实透明,因为您可以清晰地了解它详细的收费模式,分别包含发卡行、卡组和收单机构在处理每笔交易时所收取的费用:

  • Interchange fee:由发卡银行所收取的费用。
  • Scheme fee(第一个 +):由卡组收取的费用。
  • Acquirer fee(第二个 +):由收单机构收取的费用。

当 Interchange++ 报价模式被采用时,结算报告中可能会包含校差信息。该校差信息表示之前交易中实际收取费用与应收取费用之间的差异,通过 feeAmountValue 字段呈现在结算报告的倒数第二行。

  • 当 feeAmountValue 校差行值为正时,表示应收取费用少于实际收取费用,收单机构需向您补齐该费用。
  • 当 feeAmountValue 校差行值为负时,表示应收取费用大于实际收取费用,您需要向收单机构补齐该费用。

收单机构会不定期向 Antom 发送校差信息,Antom 会通过结算报告向您发送校差信息。

欲知含有校差信息的 Interchange++ 报价模式下的结算报告信息,请见 样例三。

报告样例

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

样例一(标准账单)

2018 年12 月 25 日,ID 为 102218800000000**** 的商家产生了两笔交易,一笔付款,一笔退款。结算打款并收到银行回执后,Antom 生成了一个 CSV 文件,详情如下:

settlementBatchId,customerId,acquirer,summaryType,settlementTime,count,settlementAmountValue,settlementCurrency,feeAmountValue,feeCurrency,processingFeeAmountValue,processingFeeCurrency,nonGuaranteeCouponValue,nonGuaranteeCouponCurrency,disputeHandlingFee,disputeHandlingFeeCurrency,disputeReverseFee,disputeReverseFeeCurrency,interchangeFeeAmountValue,interchangeFeeCurrency,schemeFeeAmountValue,schemeFeeCurrency,acquirerMarkupAmountValue,acquirerMarkupCurrency,refundFeeAmountValue,refundFeeCurrency
201812261102104****,102218800000000****,Alipay_SG,TOTAL,2018-12-26T10:00:00+08:30,2,725,USD,-25,USD,,,,,,,,,,,,,,,,
201812261102104****,102218800000000****,Alipay_SG,PAYMENT,2018-12-26T10:00:00+08:30,1,1450,USD,-50,USD,,,,,,,,,,,,,,,,
201812261102104****,102218800000000****,Alipay_SG,REFUND,2018-12-26T10:00:00+08:30,1,-725,USD,25,USD,,,,,,,,,,,,,,,,
<END>

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

在本样例中,结算币种(settlementCurrency)为 USD,结算金额(settlementAmountValue)在不同结算类型(summaryType)下的值分别为:

  • PAYMENT:支付对应的 settlementAmountValue 值为 1450,表示 Antom 需给到商家的支付金额为 1450 USD。
  • REFUND:退款对应的 settlementAmountValue 值为 -725,表示 Antom 需退给商家的金额为 725 USD。
  • TOTAL:结算汇总下 settlementAmountValue 值为 725,表示通过支付和退款结算金额计算后,Antom 需最终结算给商家的净结算额为 725 USD。

样例二(收单机构为恒生)

下方结算明细文件为收单机构为恒生时的例子。该批次下的交易结算时间为 2022 年 10 月 30 日,包含十一笔支付和一笔退款,同时还包含倒数第二行的校差行信息。

结算打款并收到银行回执后,Antom 生成了一个 CSV 文件,详情如下:

settlementBatchId,customerId,acquirer,summaryType,settlementTime,count,settlementAmountValue,settlementCurrency,feeAmountValue,feeCurrency,taxFeeAmountValue,taxFeeCurrency,processingFeeAmountValue,processingFeeCurrency,nonGuaranteeCouponValue,nonGuaranteeCouponCurrency,interchangeFeeAmountValue,interchangeFeeCurrency,schemeFeeAmountValue,schemeFeeCurrency,acquirerMarkupAmountValue,acquirerMarkupCurrency,refundFeeAmountValue,refundFeeCurrency
202210190903110****,OB10****,Hundsun,PAYMENT,2022-10-30T23:00:00+08:00,11,1056,JPY,-44,JPY,0,JPY,,,,,,,,,,,,
202210190903110****,OB10****,Hundsun,REFUND,2022-10-30T23:00:00+08:00,1,-96,JPY,4,JPY,0,JPY,,,,,,,,,,,,
202210190903110****,OB10****,Hundsun,TOTAL,2022-10-30T23:00:00+08:00,13,956,JPY,-40,JPY,-4,JPY,,,,,,,,,,,,
202210190903110****,OB10****,Hundsun,default,2022-10-30T23:00:00+08:00,1,-4,JPY,0,JPY,-4,JPY,,,,,,,,,,,,
<END>

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

在本样例中,您需要重点关注的信息如下:

  • feeAmountValue (transactionType = default): 0
  • feeCurrency (transactionType = default): JPY
  • taxFeeAmountValue (transactionType = default): -4
  • taxFeeCurrency (transactionType = default): JPY
  • settlementAmountValue (transactionType = default): -4
  • settlementCurrency (transactionType = default): JPY
  • settlementAmountValue (transactionType = PAYMENT): 1056
  • settlementCurrency (transactionType = PAYMENT): JPY
  • settlementAmountValue (transactionType = REFUND): -96
  • settlementCurrency (transactionType = REFUND): JPY
  • settlementAmountValue (transactionType = TOTAL): 956
  • settlementCurrency (transactionType = TOTAL): JPY

其中,在校差行中,也就是当 transactionType 为 default 时,feeAmountValue 和 taxFeeAmountValue 的值分别为 0 和 -4,费用币种都为 JPY,汇总后结算金额为 -4 日元,即 settlementAmountValue 为 -4,settlementCurrency 为 JPY,表示恒生与 Antom 计算的结算金额信息相差负四日元。该报告中包含的支付结算总金额为 1056 日元,退款总金额为 -96 日元,与校差的结算金额汇总后,最终的结算金额为 956 日元,即 transactionType 为 TOTAL 时,settlementAmountValue 值为 956, settlementCurrency 为 JPY。

样例三(Interchange++ 报价模式)

下方结算报告为 Interchange++ 模式下的报告样例。该结算报告包含了一笔授权、两笔请款、和一笔退款交易,同时含有收单机构返回的之前交易的校差信息,呈现在报告的倒数第二行。

settlementBatchId,customerId,acquirer,summaryType,settlementTime,count,settlementAmountValue,settlementCurrency,feeAmountValue,feeCurrency,taxFeeAmountValue,taxFeeCurrency,processingFeeAmountValue,processingFeeCurrency,nonGuaranteeCouponValue,nonGuaranteeCouponCurrency,disputeHandlingFee,disputeHandlingFeeCurrency,disputeReverseFee,disputeReverseFeeCurrency,interchangeFeeAmountValue,interchangeFeeCurrency,schemeFeeAmountValue,schemeFeeCurrency,acquirerMarkupAmountValue,acquirerMarkupCurrency,refundFeeAmountValue,refundFeeCurrency
2C2PXXXXXX0101,Oxxxx742,2C2P_SG,AUTHORIZATION,2023-01-09T02:45:29+08:00,1,-3,HKD,,,,,-1,HKD,,,,,,,,,-2,HKD,,,,
2C2PXXXXXX0101,Oxxxx742,2C2P_SG,CAPTURE,2023-01-09T02:45:29+08:00,2,91,HKD,,,-1,HKD,-1,HKD,,,,,,,-4,HKD,-2,HKD,-1,HKD,,
2C2PXXXXXX0101,Oxxxx742,2C2P_SG,REFUND,2023-01-09T02:45:29+08:00,1,-99,HKD,,,,,-1,HKD,,,,,,,4,HKD,-2,HKD,,,,
2C2PXXXXXX0101,Oxxxx742,2C2P_SG,TOTAL,2023-01-09T02:45:29+08:00,5,-511,HKD,,,0,HKD,,,,,,,,,-1,HKD,-2,HKD,-1,HKD,,
2C2PXXXXXX0101,Oxxxx742,2C2P_SG,default,2023-01-09T02:45:29+08:00,1,-500,HKD,-500,HKD,,,,,,,,,,,,,,,,,,
<END>

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

在该样例中,您需要重点关注的费用信息如下:

  • feeAmountValue (summaryType = default): -500
  • feeCurrency (summaryType = default): HKD
  • settlementAmountValue (summaryType = default): -500
  • settlementCurrency (summaryType = default): HKD
  • settlementAmountValue (summaryType = AUTHORIZATION): -3
  • settlementCurrency (summaryType = AUTHORIZATION): HKD
  • settlementAmountValue (summaryType = CAPTURE): 91
  • settlementCurrency (summaryType = CAPTURE): HKD
  • settlementAmountValue (summaryType = REFUND): -99
  • settlementCurrency (summaryType = REFUND): HKD
  • settlementAmountValue (summaryType = TOTAL): -511
  • settlementCurrency (summaryType = TOTAL): HKD

其中,当 summaryType 为 default 时,feeAmountValue 的值为 -500,且费用币种为 HKD,这表示您需要向收单机构额外付 500 港元的费用,即此时 settlementAmountValue 的校差值为 -500。该批次中有一笔授权交易,授权结算金额为 -3 港元;两笔请款交易,请款结算金额为 91 港元;一笔退款交易,退款结算金额为 -99 港元。因此最终结算金额为几种交易类型的结算金额相加,为 -511 港元,即当 summaryType 为 TOTAL 时,settlementAmountValue 的值为 -511,settlementCurrency 为 HKD。

【注意】在同一结算批次中,结算明细报告与结算汇总报告中的校差金额一致。

样例四(无交易)

settlementBatchId,customerId,acquirer,summaryType,settlementTime,count,settlementAmountValue,settlementCurrency,feeAmountValue,feeCurrency,processingFeeAmountValue,processingFeeCurrency,nonGuaranteeCouponValue,nonGuaranteeCouponCurrency,disputeHandlingFee,disputeHandlingFeeCurrency,disputeReverseFee,disputeReverseFeeCurrency,interchangeFeeAmountValue,interchangeFeeCurrency,schemeFeeAmountValue,schemeFeeCurrency,acquirerMarkupAmountValue,acquirerMarkupCurrency,refundFeeAmountValue,refundFeeCurrency
<END>

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

【注意】无交易的情况下,默认 SFTP 服务器或 Antom 商家门户都不会产生账单。若您需要无交易下的空账单,您可以联系 Antom 技术支持在 SFTP 服务器下进行配置。