结算汇总报告

结算汇总报告包含一个结算周期内的交易总数和净结算金额等信息,于结算打款当日生成。您可以通过 SFTP 服务器Antom Dashboard种方式获取来获取该报告。

报告详情

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

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

字段

说明

settlementBatchId

必选 String (64)

Antom 分配的用于识别结算批次的唯一标识,与结算汇总文件中的结算批号相同。

customerId

必选 String (64)

Antom 为商家分配的唯一身份标识。

PSP

必选 String (64)

支付服务供应商(PSP),负责交易处理的收单机构的名字。

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

summaryType

必选 String (16)

算汇总的类型。包含的值有:

  • AUTHORIZATION表示一段时间内的授权交易汇总。
  • PAYMENT表示一段时间内的成功支付的交易汇总。
  • CAPTURE表示一段时间内的请款交易汇总。
  • REFUND表示一段时间内的退款信息汇总。
  • CANCEL表示一段时间内的取消交易汇总。
  • DISPUTE表示一段时间内的拒付信息汇总。
  • ADJUSTMENT_FEE: 表示调整费用,对于卡支付,可能会因包括但不限于支付系统运营商征收或规定的费用或额外费用的变化、错误和其他原因而进行调整
  • TOTAL表示一个结算批次内的所有结算汇总。
  • REFUND_REVERSAL表示退款逆转,通常发生在不支持原路退款的支付方式中。资金则会返回到您的账户。
  • PAYMENT_REVERSAL表示一个结算批次内的支付逆转总额,通常发生在不支持原路退款的支付方式中。资金则会返回到您的账户。
  • SETTLEMENT_FEE表示收单机构收取结算手续费。具体费用明细通过 settlmentAmountValuesettlementCurrency 字段体现。
  • DISPUTE_REVERSAL表示在争议中成功抗辩并胜诉。
  • COLLATERAL_WITHHELD:表示保证金代扣,是指如果 Antom 向您收取保证金,则会从结算批次金额中扣取保证金金额。
  • RESERVE:表示预留金代扣,是指如果您需要预留一部分资金为退款做准备,当您在门户预留金菜单下调高预留金账户的阈值时,Antom 会从结算批次中扣除预留金金额。
  • RESERVE_RELEASED:表示预留金释放,是指当您在门户预留金菜单下调低预留金账户的阈值时,Antom 会将预留金多余的资金释放至结算批次中,一起结算给您。
  • COLLATERAL_RELEASED:表示保证金释放,是指如果 Antom 不需向您收取更多保证金,会将多余的部分资金释放到结算批次中一起结算给您。
  • RAPID_DISPUTE_RESOLUTION: 表示交易类型为快速争议解决(RDR)
  • CDRN: 表示持卡人争议解决网络流程(CARDHOLDER_DISPUTE_RESOLUTION_NETWORK)。
settlementInitiatedDate

必选 String (64)

结算报告生成的日期和时间,于结算打批当日生成。

count

必选 Integer

表示交易总数。

settlementAmountValue

必选 String (16)

订单金额转换为结算币种后,扣除费用后的净结算金额。以 settlementCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

settlementCurrency

必选 String (3)

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

paymentMethodFeeAmountValue

可选 String (16)

Antom 收取的支付方式手续费金额。以 paymentMethodFeeCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

paymentMethodFeeCurrency

可选 String (3)

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

taxFeeAmountValue

可选 String (16)

税费。以 taxFeeCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

taxFeeCurrency

可选 String (3)

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

processingFeeAmountValue

可选 String (16)

Antom 为每笔交易提供的支付处理服务费用金额。以 processingFeeCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

processingFeeCurrency

可选 String (3)

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

disputeHandlingFee

可选 String (16)

Antom 向商家收取的拒付处理的费用金额。以 disputeHandlingFeeCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

summaryType 为 DISPUTE,且 Antom 向商户收取、退还该费用时该字段有值。

disputeHandlingFeeCurrency

可选 String (3)

disputeHandingFee 对应的币种,ISO 4217 中定义的三位字母币种代码。

interchangeFeeAmountValue

可选 String (16)

发卡行收取的费用。以 interchangeFeeCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

报价模式为 Interchange++ ,且发卡行向商户收取、退还该费用时该字段有值。

interchangeFeeCurrency

可选 String (3)

interchangeFeeAmountValue 对应的币种,ISO 4217 中定义的三位字母币种代码。

schemeFeeAmountValue

可选 String (16)

卡组收取的费用。以 schemeFeeCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

当报价模式为 Interchange++ ,且卡组向商户收取、退还该费用时该字段有值。

schemeFeeCurrency

可选 String (3)

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

acquirerMarkupAmountValue

可选 String (16)

Antom 收取的费用。以 acquirerMarkupCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

当报价模式为 Interchange++ ,且 Antom 向商户收取、退还该费用时该字段有值。

acquirerMarkupCurrency

可选 String (3)

acquirerMarkupAmountValue 对应的币种,ISO 4217 中定义的三位字母币种代码。

refundFeeAmountValue

可选 String (16)

针对退款交易,Antom 收取的费用。以 refundFeeCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

 summaryType 为 REFUND,且 Antom  向商户收取该费用时该字段有值。

refundFeeCurrency

可选 String (3)

refundFeeAmountValue 对应的币种,ISO 4217 中定义的三位字母币种代码。

financingFeeAmountValue

可选 String (16)

分期支付场景中,Antom 向商家收取的服务费。以 financingFeeCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

当 Antom 向商户收取、退还该费用时该字段有值。

financingFeeCurrency

可选 String (3)

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

rdrFeeAmountValue

可选 String (16)

Antom  向商家收取快速争议解决(RDR)类型交易费用。以 rdrFeeCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

当商户通过 Antom 开通 RDR 服务且 summaryType 为 RAPID_DISPUTE_RESOLUTION,且 Antom 向商户收取、退还该费用时该字段有值。

rdrFeeCurrency

可选 String (3)

rdrFeeAmountValue 对应的币种,ISO 4217 中定义的三位字母币种代码。

anticipationFeeAmountValue

可选 String (16)

Antom 向商家收取的结算周期加速服务费。anticipationFeeCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)
当买家使用巴西本地卡的卡分期支付场景,或对客资金结算延迟天数小于 T+26 时,Antom 向商户收取、退还该费用时该字段有值。

anticipationFeeCurrency

可选 String (3)
anticipationFeeAmountValue 对应的币种,ISO 4217 中定义的三位字母的币种代码。

riskDecisionServiceFeeAmountValue

可选 String (16)

风控决策处理费。以 riskDecisionServiceFeeCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

当商户未签约风控包赔能力时向商户收取;如商户签约风控包赔能力,则不收取。 此费项仅在 AUTHORIZATION 时收取,不做退费。

riskDecisionServiceFeeCurrency

可选 String (3)

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

riskManagementFeeAmountValue

可选 String (16)

风控管理费。以 riskManagementFeeCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

当商户签约风控包赔能力时向商户收取;如商户未签约风控包赔能力,则不收取。 此费项仅在 CAPTURE 时收取,不做退费。

riskManagementFeeCurrency

可选 String (3)

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

cdrnFeeAmountValue

可选 String (16)

由 Antom 向商户收取信用卡争议解决网络 (CDRN) 类型交易的费用金额。以 cdrnFeeCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

summaryType 为 CDRN,商户已经通过 Antom 开通 CDRN 服务时,且由 Antom 向商户收取、退还该费用时该字段有值。

cdrnFeeCurrency

可选 String (3)

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

iofFeeAmountValue

可选 String (16)

IOFImposto sobre Operações Financeiras)费用是巴西联邦政府规定的一项税收,适用于特定金融业务,包括外汇交易、信用卡国际结算以及跨境投资等。 以 iofFeeCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

当巴西联邦政府收取该税时该字段有值。

iofFeeCurrency

可选 String (3)

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

withholdingTaxAmountValue

可选 String (16)

此字段表示根据相关当地税务法规在源头预扣的税额。它代表由付款方代扣并上缴至相应税务机关的交易金额部分。该数值通常根据适用的税率计算,可能因交易性质及相关方的分类不同而有所变化。以 withholdingTaxFeeCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

当菲律宾政府收取该税时该字段有值。

withholdingTaxFeeCurrency

可选 String (3)

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

fxFeeAmountValue

可选 String (16)

Antom 为每笔交易提供外汇兑换(FX,即 Foreign exchange服务所收取的处理费用金额。以 fxFeeAmountCurrency 币种单位展示(例如,如果币种是 USD 金额是 $1.00,则将此参数的值设置为 1.00。或者如果币种是 JPY,金额是 ¥1,则将此参数的值设置为 1。)

Antom 向商户收取、退还该费用时该字段有值。

fxFeeAmountCurrency

可选 String (3)

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

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

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

报告样例

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

样例一(标准账单)

2024 年 12 月 17 日,ID 为 21881201642xxxxx 的商家产生了 17 笔交易,分别为授权、支付、退款、请款、付款、取消、争议、退款失败、结算手续费、拒付抗辩、最终支付、保证金释放、保证金代扣、预留金代扣、预留金释放、RDR 争议。结算打款并收到银行回执后,Antom 生成了一个 CSV 文件,详情如下:

copy
settlementBatchId,customerId,PSP,summaryType,settlementInitiatedDate,count,settlementAmountValue,settlementCurrency,paymentMethodFeeAmountValue,paymentMethodFeeCurrency,taxFeeAmountValue,taxFeeCurrency,processingFeeAmountValue,processingFeeCurrency,disputeHandlingFee,disputeHandlingFeeCurrency,interchangeFeeAmountValue,interchangeFeeCurrency,schemeFeeAmountValue,schemeFeeCurrency,acquirerMarkupAmountValue,acquirerMarkupCurrency,refundFeeAmountValue,refundFeeCurrency,financingFeeAmountValue,financingFeeCurrency,rdrFeeAmountValue,rdrFeeCurrency,anticipationFeeAmountValue,anticipationFeeCurrency,riskDecisionServiceFeeAmountValue,riskDecisionServiceFeeCurrency,riskManagementFeeAmountValue,riskManagementFeeCurrency,cdrnFeeAmountValue,cdrnFeeCurrency,iofFeeAmountValue,iofFeeCurrency,withholdingTaxAmountValue,withholdingTaxFeeCurrency,fxFeeAmountValue,fxFeeAmountCurrency
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,AUTHORIZATION,2024-12-17T05:16:17+08:00,1,-0.24346,USD,,,,,,,,,,,-0.23346,USD,,,,,,,,,,,-0.01,USD,,,,,,,,,,
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,PAYMENT,2024-12-17T05:16:17+08:00,2,144.25,USD,-2.19,USD,,,-0.11,USD,,,,,,,,,,,,,,,,,,,,,,,,,,,,
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,CAPTURE,2024-12-17T05:16:17+08:00,1,4.85,USD,-0.18,USD,,,-0.15,USD,,,,,,,,,,,,,,,,,,,-0.01,USD,,,,,,,,
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,CANCEL,2024-12-17T05:16:17+08:00,1,-31.13,USD,0.47,USD,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,DISPUTE,2024-12-17T05:16:17+08:00,1,-325.79,USD,,,,,,,-15,USD,,,,,,,,,,,,,,,,,,,,,,,,,,
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,REFUND,2024-12-17T05:16:17+08:00,2,-284.87,USD,4.72,USD,,,,,,,,,,,,,-0.32,USD,,,,,,,,,,,,,,,,,,
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,REFUND_REVERSAL,2024-12-17T05:16:17+08:00,1,289.63,USD,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,SETTLEMENT_FEE,2024-12-17T05:16:17+08:00,1,0,USD,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,DISPUTE_REVERSAL,2024-12-17T05:16:17+08:00,1,240.05,USD,-6.31,USD,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,PAYMENT_REVERSAL,2024-12-17T05:16:17+08:00,1,15.39,USD,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,COLLATERAL_RELEASED,2024-12-17T05:16:17+08:00,1,378.71,USD,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,COLLATERAL_WITHHELD,2024-12-17T05:16:17+08:00,1,-451.87,USD,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,RESERVE_RELEASED,2024-12-17T05:16:17+08:00,1,11.3,USD,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,RESERVE,2024-12-17T05:16:17+08:00,1,-3.7,USD,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,RAPID_DISPUTE_RESOLUTION,2024-12-17T05:16:17+08:00,1,-875.88,USD,,,,,,,0,USD,,,,,,,,,,,,,,,,,,,,,,,,,,
"2024121619607xxxxx ","21881201642xxxxx ",Antom_SG,TOTAL,2024-12-17T05:16:17+08:00,17,-889.30346,USD,-3.49,USD,,,-0.26,USD,0,USD,,,-0.23346,USD,,,-0.32,USD,,,,,,,,,,,,,,,,,,
<END>

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

样例二(无交易)

copy
settlementBatchId,customerId,PSP,summaryType,settlementInitiatedDate,count,settlementAmountValue,settlementCurrency,paymentMethodFeeAmountValue,paymentMethodFeeCurrency,taxFeeAmountValue,taxFeeCurrency,processingFeeAmountValue,processingFeeCurrency,disputeHandlingFee,disputeHandlingFeeCurrency,interchangeFeeAmountValue,interchangeFeeCurrency,schemeFeeAmountValue,schemeFeeCurrency,acquirerMarkupAmountValue,acquirerMarkupCurrency,refundFeeAmountValue,refundFeeCurrency,financingFeeAmountValue,financingFeeCurrency,rdrFeeAmountValue,rdrFeeCurrency,anticipationFeeAmountValue,anticipationFeeCurrency,riskDecisionServiceFeeAmountValue,riskDecisionServiceFeeCurrency,riskManagementFeeAmountValue,riskManagementFeeCurrency,cdrnFeeAmountValue,cdrnFeeCurrency,iofFeeAmountValue,iofFeeCurrency,withholdingTaxAmountValue,withholdingTaxFeeCurrency,fxFeeAmountValue,fxFeeAmountCurrency
<END>

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

注意:无交易的情况下,默认 SFTP 服务器或 Antom Dashboard 都不会产生账单。若您需要无交易下的空账单,您可以联系 Antom 技术支持(TechnicalService@antom.com)在 SFTP 服务器下进行配置。