交易明细报告
交易明细报告包含 T 日所有成功交易的明细,于 T+1 日生成。您可以通过 SFTP 服务器 或 Antom 全球商家门户 两种方式获取来获取该报告。
报告详情
交易明细报告包含三部分内容:表头信息、交易详情和文件结束符。文件结束符 <END> 出现在报告的最后一行,表头信息由如下字段名表示,交易详情由字段对应的值表示。
下表展示了交易明细报告正文中的字段及字段说明:
字段 | 说明 |
customerId | 必选 String (64) Antom 为商家分配的唯一身份标识号。 |
acquirer | 必选 String (64) 负责交易处理的收单机构的名字。 该收单机构主要是指为您提供收单和资金结算服务的机构。 |
acquirerReferenceNo | 可选 String (64) 收单机构(非 Antom )为交易分配的唯一识别 ID。 当交易是由收单机构(非 Antom )进行结算时,该字段会有值。 |
referenceMerchantId | 可选 String (64) 直接向买家提供服务或商品的商家唯一标识,由机构分配给其二级商户。 该字段的值与原支付或授权请求中的 referenceMerchantId 字段的值相同。 |
referenceStoreId | 可选 String (64) 商家店铺的唯一标识,由对应商家分配。 |
transactionId | 必选 String (64) Antom 分配的交易唯一标识。该字段的值遵循以下规则:
|
originalTransactionId | 可选 String (64) 原始交易的标识符。
|
transactionRequestId | 必选 String (64) 商家分配的交易请求唯一标识。该字段的值与付款的 paymentRequestId 的值相同,或与退款的 refundRequestId 的值相同。 当 transactionType 为 |
referenceTransactionId | 可选 String (64) 直接向买家提供服务或商品的商家分配的用于识别交易的唯一标识。该字段的值与付款的 referenceOrderId 的值相同。 当 transactionType 为 |
orderDescription | 可选 String (256) 订单的说明。 该字段的值与原支付或授权请求中的 orderDescription 字段的值相同。 |
paymentMethodType | 必选 String (32) 支付方式。可用枚举值请查看支付方式文档。 该字段的值与原先支付或授权请求中的 paymentMethodType 字段的值相同。 |
pspName | 可选 String (64) Alipay+ 支付方式名称,例如 Gcash。 该字段的值原先支付或授权请求中的 pspName 字段的值相同。 |
transactionType | 必选 String 交易类型,包含的值如下:
|
paymentTime | 必选 String (64) 交易达到成功或失败终态的日期和时间,格式为 |
productCode | 必选 String Antom 和商家合同中约定的支付产品类型。值包含如下:
该字段的值与原支付或授权请求中的 productCode 字段的值相同。 |
transactionAmountValue | 必选 String (16) 交易金额,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。 |
transactionCurrency | 必选 String (3)transactionAmountValue 对应的货币,为 ISO 4217 中定义的 3 个字母的货币代码 。 |
originalTransactionRequestId | 可选 String (64)交易类型为 |
installmentsNum | 可选 String (8) 表示分期付款的期数。 |
issuingCountry | 可选 String (2) 发卡国家或地区。该字段值是遵循 ISO 3166 Country Codes 标准的二位国家码。 当 paymentMethodType 为 该字段的值与原支付或授权请求中的 issuingCountry 字段的值相同。 |
cardBrand | 可选 String (256) 卡品牌。 当 paymentMethodType 为 该字段的值与原支付或授权请求中的 cardBrand 字段的值相同。 |
funding | 可选 String (20) 支付方式的资金类型。当 paymentMethodType 为 当 paymentMethodType 为
当 paymentMethodType 为
该字段的值与原支付或授权请求中的 funding 字段的值相同。 |
表 1. 交易明细报告字段及说明
注意:请利用表头字段信息进行账单解析。您从 SFTP 和 Antom 全球商家门户所下载的账单中的字段顺序不一定与上方报告中显示的字段顺序一致。
报告样例
如下样例分别展示了不同场景下的报告。
样例一(标准账单)
在 2018 年 12 月 25 日(交易日), ID 为 102218800000000**** 的商家产生了两笔交易,一笔付款,一笔退款。在 2018 年 12 月 26 日,Antom 生成了一个 CSV 交易明细报告文件,详情如下:
customerId,acquirer,acquirerReferenceNo,referenceMerchantId,referenceStoreId,transactionId,originalTransactionId,transactionRequestId,referenceTransactionId,orderDescription,paymentMethodType,pspName,transactionType,paymentTime,productCode,transactionAmountValue,transactionCurrency,originalTransactionRequestId,installmentsNum,issuingCountry,cardBrand,funding
102218800000000****,,,,,201812251907410100000000011****,,20190326L64842300****,,,KAKAOPAY,KaKaoPay,PAYMENT,2018-12-25T10:00:00+08:30,AGREEMENT_PAYMENT,18000,KRW,,,,,
102218800000000****,,,,,201812251907410200000000004****,201812251907410100000000011****,20190326L64842300****,,,KAKAOPAY,KaKaoPay,REFUND,2018-12-25T10:00:00+08:30,AGREEMENT_PAYMENT,-9000,KRW,20190326L64842300****,,,,
<END>
在本样例中,付款和退款的重要信息如下:
- 付款信息:
- transactionId :交易流水号 201812251907410100000000011****,与原支付中的 paymentId 的值相同。
- transactionAmountValue :交易金额18000 (KRW),与原支付中的 paymentAmount.value 的值相同。
- 退款信息:
- transactionId:交易流水号 201812251907410200000000004****,与原退款中的 refundId 的值相同。
- transactionAmountValue:交易金额 9000 (KRW) ,与原退款中的 refundAmount.value 的值相同。
- originalTransactionId:原始交易流水号 201812251907410100000000011****,与原支付请求中的 paymentId 相同。
样例二(无交易)
2018 年 12 月 25 日商家无交易,2018 年 12 月 26 日,Antom 会生成了一个 CSV 空文件,内容仅包含字段名和文件结束符,详情如下:
customerId,acquirer,acquirerReferenceNo,referenceMerchantId,referenceStoreId,transactionId,originalTransactionId,transactionRequestId,referenceTransactionId,orderDescription,paymentMethodType,pspName,transactionType,paymentTime,productCode,transactionAmountValue,transactionCurrency,originalTransactionRequestId,issuingCountry,cardBrand,funding
<END>
注意:无交易的情况下,默认 SFTP 服务器或 Antom 全球商家门户都不会产生账单。若您需要无交易下的空账单,您可以联系 Antom 技术支持在 SFTP 服务器下进行配置。