结算汇总报告
结算汇总报告包含一个结算周期内的交易总数和净结算金额等信息,于结算打款当日生成。您可以通过 SFTP 服务器或 Antom Dashboard 两种方式获取来获取该报告。
报告详情
结算汇总报告包含三部分内容:表头信息、结算汇总数据和文件结束符。文件结束符 <END> 出现在报告的最后一行,表头信息由如下字段表示,结算汇总数据由字段所对应的值表示。
下表展示了结算汇总报告正文中字段及字段说明:
字段 | 说明 |
settlementBatchId | 必选 String (64) Antom 分配的用于识别结算批次的唯一标识,与结算汇总文件中的结算批号相同。 |
customerId | 必选 String (64) Antom 为商家分配的唯一身份标识。 |
PSP | 必选 String (64) 支付服务供应商(PSP),负责交易处理的收单机构的名字。 该收单机构主要是指为您提供收单和资金结算服务的机构。 |
summaryType | 必选 String (16) 结算汇总的类型。包含的值有:
|
| settlementInitiatedDate | 必选 String (64) 结算报告生成的日期和时间,于结算打批当日生成。 |
count | 必选 Integer 表示交易总数。 |
settlementAmountValue | 必选 String (16) 订单金额转换为结算币种后,扣除费用后的净结算金额。以 settlementCurrency 币种单位展示(例如,如果币种是 |
settlementCurrency | 必选 String (3) settlementAmountValue 对应的币种,为 ISO 4217 中定义的三位字母币种代码。 |
| paymentMethodFeeAmountValue | 可选 String (16) Antom 收取的支付方式手续费金额。以 paymentMethodFeeCurrency 币种单位展示(例如,如果币种是 |
| paymentMethodFeeCurrency | 可选 String (3) paymentMethodFeeAmountValue 对应的币种,为 ISO 4217 中定义的三位字母币种代码。 |
taxFeeAmountValue | 可选 String (16) 税费。以 taxFeeCurrency 币种单位展示(例如,如果币种是 |
taxFeeCurrency | 可选 String (3) taxFeeAmountValue 对应的币种,为 ISO 4217 中定义的三位字母币种代码。 |
processingFeeAmountValue | 可选 String (16) Antom 为每笔交易提供的支付处理服务费用金额。以 processingFeeCurrency 币种单位展示(例如,如果币种是 |
processingFeeCurrency | 可选 String (3) processingFeeAmountValue 对应的币种。值为 ISO 4217 中定义的三位字母币种代码。 |
disputeHandlingFee | 可选 String (16) Antom 向商家收取的拒付处理的费用金额。以 disputeHandlingFeeCurrency 币种单位展示(例如,如果币种是 当 summaryType 为 |
disputeHandlingFeeCurrency | 可选 String (3) disputeHandingFee 对应的币种,为 ISO 4217 中定义的三位字母币种代码。 |
interchangeFeeAmountValue | 可选 String (16) 发卡行收取的费用。以 interchangeFeeCurrency 币种单位展示(例如,如果币种是 当报价模式为 Interchange++ ,且发卡行向商户收取、退还该费用时该字段有值。 |
interchangeFeeCurrency | 可选 String (3) interchangeFeeAmountValue 对应的币种,为 ISO 4217 中定义的三位字母币种代码。 |
schemeFeeAmountValue | 可选 String (16) 卡组收取的费用。以 schemeFeeCurrency 币种单位展示(例如,如果币种是 当报价模式为 Interchange++ ,且卡组向商户收取、退还该费用时该字段有值。 |
schemeFeeCurrency | 可选 String (3) schemeFeeAmountValue 对应的币种,为 ISO 4217 中定义的三位字母币种代码。 |
acquirerMarkupAmountValue | 可选 String (16) Antom 收取的费用。以 acquirerMarkupCurrency 币种单位展示(例如,如果币种是 当报价模式为 Interchange++ ,且 Antom 向商户收取、退还该费用时该字段有值。 |
acquirerMarkupCurrency | 可选 String (3) acquirerMarkupAmountValue 对应的币种,为 ISO 4217 中定义的三位字母币种代码。 |
refundFeeAmountValue | 可选 String (16) 针对退款交易,Antom 收取的费用。以 refundFeeCurrency 币种单位展示(例如,如果币种是 当 summaryType 为 |
refundFeeCurrency | 可选 String (3) refundFeeAmountValue 对应的币种,为 ISO 4217 中定义的三位字母币种代码。
|
financingFeeAmountValue | 可选 String (16) 分期支付场景中,Antom 向商家收取的服务费。以 financingFeeCurrency 币种单位展示(例如,如果币种是 当 Antom 向商户收取、退还该费用时该字段有值。 |
financingFeeCurrency | 可选 String (3) financingFeeAmountValue 对应的币种,为 ISO 4217 中定义的三位字母的币种代码。 |
rdrFeeAmountValue | 可选 String (16) Antom 向商家收取的快速争议解决(RDR)类型交易的费用。以 rdrFeeCurrency 币种单位展示(例如,如果币种是 当商户通过 Antom 开通 RDR 服务且 summaryType 为 |
rdrFeeCurrency | 可选 String (3) rdrFeeAmountValue 对应的币种,为 ISO 4217 中定义的三位字母币种代码。 |
anticipationFeeAmountValue | 可选 String (16) Antom 向商家收取的结算周期加速服务费。以 anticipationFeeCurrency 币种单位展示(例如,如果币种是 |
anticipationFeeCurrency | 可选 String (3) |
riskDecisionServiceFeeAmountValue | 可选 String (16) 风控决策处理费。以 riskDecisionServiceFeeCurrency 币种单位展示(例如,如果币种是 当商户未签约风控包赔能力时向商户收取;如商户签约风控包赔能力,则不收取。 此费项仅在 |
riskDecisionServiceFeeCurrency | 可选 String (3) riskDecisionServiceFeeAmountValue 对应的币种,为 ISO 4217 中定义的三位字母的币种代码。 |
riskManagementFeeAmountValue | 可选 String (16) 风控管理费。以 riskManagementFeeCurrency 币种单位展示(例如,如果币种是 当商户签约风控包赔能力时向商户收取;如商户未签约风控包赔能力,则不收取。 此费项仅在 |
riskManagementFeeCurrency | 可选 String (3) riskManagementFeeAmountValue 对应的币种,为 ISO 4217 中定义的三位字母的币种代码。 |
cdrnFeeAmountValue | 可选 String (16) 由 Antom 向商户收取的信用卡争议解决网络 (CDRN) 类型交易的费用金额。以 cdrnFeeCurrency 币种单位展示(例如,如果币种是 当 summaryType 为 |
| cdrnFeeCurrency | 可选 String (3) cdrnFeeAmountValue 对应的币种,为 ISO 4217 中定义的三位字母的币种代码。 |
| iofFeeAmountValue | 可选 String (16) IOF(Imposto sobre Operações Financeiras)费用是巴西联邦政府规定的一项税收,适用于特定金融业务,包括外汇交易、信用卡国际结算以及跨境投资等。 以 iofFeeCurrency 币种单位展示(例如,如果币种是 当巴西联邦政府收取该税时该字段有值。 |
| iofFeeCurrency | 可选 String (3) iofFeeAmountValue 对应的币种,为 ISO 4217 中定义的三位字母的币种代码。 |
| withholdingTaxAmountValue | 可选 String (16) 此字段表示根据相关当地税务法规在源头预扣的税额。它代表由付款方代扣并上缴至相应税务机关的交易金额部分。该数值通常根据适用的税率计算,可能因交易性质及相关方的分类不同而有所变化。以 withholdingTaxFeeCurrency 币种单位展示(例如,如果币种是 当菲律宾政府收取该税时该字段有值。 |
| withholdingTaxFeeCurrency | 可选 String (3) withholdingTaxAmountValue 对应的币种,为 ISO 4217 中定义的三位字母的币种代码。 |
fxFeeAmountValue | 可选 String (16) Antom 为每笔交易提供外汇兑换(FX,即 Foreign exchange)服务所收取的处理费用金额。以 fxFeeAmountCurrency 币种单位展示(例如,如果币种是 当 Antom 向商户收取、退还该费用时该字段有值。 |
fxFeeAmountCurrency | 可选 String (3) fxFeeAmountValue 对应的币种,为 ISO 4217 中定义的三位字母的币种代码。 |
表 1. 结算汇总报告字段及说明
注意:请利用表头字段信息进行账单解析。您从 SFTP 和 Antom Dashboard 所下载的账单中的字段顺序不一定与上方报告中显示的字段顺序一致。
报告样例
如下样例分别展示了不同场景下的报告。
样例一(标准账单)
2024 年 12 月 17 日,ID 为 21881201642xxxxx 的商家产生了 17 笔交易,分别为授权、支付、退款、请款、付款、取消、争议、退款失败、结算手续费、拒付抗辩、最终支付、保证金释放、保证金代扣、预留金代扣、预留金释放、RDR 争议。结算打款并收到银行回执后,Antom 生成了一个 CSV 文件,详情如下:
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>样例二(无交易)
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>注意:无交易的情况下,默认 SFTP 服务器或 Antom Dashboard 都不会产生账单。若您需要无交易下的空账单,您可以联系 Antom 技术支持(TechnicalService@antom.com)在 SFTP 服务器下进行配置。