结算汇总报告
结算汇总报告包含一个结算周期内的交易总数和净结算金额等信息,于结算打款后收到银行回执的次日和结算明细报告一起生成。您可以通过 SFTP 服务器 或 Antom 商家门户 两种方式获取来获取该报告。
报告详情
结算汇总报告包含三部分内容:表头信息、结算汇总数据和文件结束符。文件结束符 <END> 出现在报告的最后一行,表头信息由如下字段表示,结算汇总数据由字段所对应的值表示。
下表展示了结算汇总报告正文中字段及字段说明:
字段 | 说明 |
settlementBatchId | 必选 String (64) |
customerId | 必选 String (64) 收单机构为商家分配的唯一身份标识。 |
acquirer | 必选 String (64) 负责交易处理的收单机构的名字。 该收单机构主要是指为您提供收单和资金结算服务的机构。 |
summaryType | 可选 String (16) 结算汇总的类型。包含的值有:
|
settlementTime | 必选 String (64) 结算报告生成的日期和时间,格式为 |
count | 必选 Integer 表示交易总数。 |
settlementAmountValue | 必选 String (16) 净结算金额,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。 当收单机构为恒生且 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 为 |
interchangeFeeCurrency | 可选 String (3) interchangeFeeAmountValue 对应的币种。 当 paymentMethodType 为 |
schemeFeeAmountValue | 可选 String (16) 卡组收取的费用,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。在结算明细报告中,该值精确到小数点后八位;在结算汇总报告中,该值会通过银行家算法四舍五入到小数点后两位。 当 paymentMethodType 为 |
schemeFeeCurrency | 可选 String (3) schemeFeeAmountValue 对应的币种。 当 paymentMethodType 为 |
acquirerMarkupAmountValue | 可选 String (16) 收单机构收取的费用,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。 当 paymentMethodType 为 |
acquirerMarkupCurrency | 可选 String (3) acquirerMarkupAmountValue 对应的币种。 当 paymentMethodType 为 |
refundFeeAmountValue | 可选 String (16) 针对退款交易,收单机构收取的费用,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。 当 transactionType 为 |
refundFeeCurrency | 可选 String (3) refundFeeAmountValue 对应的币种。 当 transactionType 为 |
表 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>
在本样例中,结算币种(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>
在本样例中,您需要重点关注的信息如下:
- 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>
在该样例中,您需要重点关注的费用信息如下:
- 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>
【注意】无交易的情况下,默认 SFTP 服务器或 Antom 商家门户都不会产生账单。若您需要无交易下的空账单,您可以联系 Antom 技术支持在 SFTP 服务器下进行配置。