结算汇总报告
结算汇总报告包含一个结算周期内的交易总数和净结算金额等信息,和结算明细报告一起生成。您可以通过 SFTP 服务器 或 POP 商家门户 两种方式获取来获取该报告。
报告详情
结算汇总报告包含三部分内容:表头信息、结算汇总数据和文件结束符。文件结束符 <END> 出现在报告的最后一行,表头信息由如下字段表示,结算汇总数据由字段所对应的值表示。
下表展示了结算汇总报告正文中字段及字段说明:
字段 | 说明 |
settlementBatchId | 必选 String (64) |
customerId | 必选 String (64) 收单机构为商家分配的唯一身份标识。 |
acquirer | 必选 String (64) 负责交易处理的收单机构的名字。 该收单机构主要是指为您提供收单和资金结算服务的机构。 |
summaryType | 可选 String (16) 结算汇总的类型。包含的值有:
|
settlementTime | 必选 String (64) 收单机构向您结算的日期和时间,格式为 |
count | 必选 Integer 表示交易总数。 |
settlementAmountValue | 必选 String (16) 净结算金额,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。 |
settlementCurrency | 必选 String (3) settlementAmountValue 对应的币种,为 ISO 4217 中定义的 3 个字母的货币代码。 |
feeAmountValue | 必选 String (16) 处理该笔交易收取的各种费用的总金额,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。 |
feeCurrency | 必选 String (3) feeAmountValue 对应的币种,为 ISO 4217 中定义的 3 个字母的货币代码。 |
nonGuaranteeCouponValue | 可选 String (16) 商家折扣金额,该金额会在结算给商家的总金额中直接扣除,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。 |
nonGuaranteeCouponCurrency | 可选 String (3) nonGuaranteeCouponValue 对应的币种,为 ISO 4217 中定义的 3 个字母的货币代码。 |
表 1. 结算汇总报告字段及说明
【注意】请利用表头字段信息进行账单解析。您从 SFTP 和 Alipay 商家门户所下载的账单中的字段顺序不一定与上方报告中显示的字段顺序一致。
报告样例
如下样例分别展示了不同场景下的报告。
样例一(标准账单)
2018 年12 月 25 日,ID 为 102218800000000**** 的商家产生了两笔交易,一笔付款,一笔退款。结算打款并收到银行回执后,POP 生成了一个 CSV 文件,详情如下:
settlementBatchId,customerId,acquirer,summaryType,settlementTime,count,settlementAmountValue,settlementCurrency,feeAmountValue,feeCurrency,nonGuaranteeCouponValue,nonGuaranteeCouponCurrency
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>
在本样例中,收单机构为 Alipay,结算币种(settlementCurrency)为 USD,结算金额(settlementAmountValue)在不同结算类型(summaryType)下的值分别为:
PAYMENT
:支付对应的 settlementAmountValue 值为1450
,表示 Alipay 需给到商家的支付金额为 1450 USD。REFUND
:退款对应的 settlementAmountValue 值为-725
,表示 Alipay 需退给商家的金额为 735 USD。TOTAL
:结算汇总下 settlementAmountValue 值为725
,表示通过支付和退款结算金额计算后,Alipay 需最终结算给商家的净结算额为 725 USD。
样例二(无交易)
settlementBatchId,customerId,acquirer,summaryType,settlementTime,count,settlementAmountValue,settlementCurrency,feeAmountValue,feeCurrency,nonGuaranteeCouponValue,nonGuaranteeCouponCurrency
<END>
【注意】无交易的情况下,默认 SFTP 服务器不会产生账单。若您需要无交易下的空账单,您可以联系 Alipay 技术支持在 SFTP 服务器下进行配置。