交易明细报告
交易明细报告包含 T 日所有成功交易的明细,于 T+1 日生成。您可以通过 SFTP 服务器或 Antom Dashboard 两种方式获取来获取该报告。
报告详情
交易明细报告包含三部分内容:表头信息、交易详情和文件结束符。文件结束符 <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 的值相同。
|
referenceTransactionId | 必选 String (64) 直接向买家提供服务或商品的商家分配的用于识别交易的唯一标识。该字段的值与付款的 referenceOrderId 的值相同。 |
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 中定义的三位字母币种代码 。 |
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 Dashboard 所下载的账单中的字段顺序不一定与上方报告中显示的字段顺序一致。
报告样例
如下样例分别展示了不同场景下的报告。
样例一(标准账单)
在 2024 年 11 月 29 日(交易日), ID 为 21881202142xxxxx 的商家产生了 8 笔交易,分别为授权、请款、退款、争议、付款、取消、预授权解除、RDR 争议。在 2024 年 11 月 30 日,Antom 生成了一个 CSV 交易明细报告文件,详情如下:
customerId,acquirer,acquirerReferenceNo,referenceMerchantId,referenceStoreId,transactionId,originalTransactionId,transactionRequestId,referenceTransactionId,orderDescription,paymentMethodType,pspName,transactionType,paymentTime,productCode,transactionAmountValue,transactionCurrency,originalTransactionRequestId,installmentsNum,issuingCountry,cardBrand,funding
"21881202142xxxxx ",Alipay_SG,,," ","202411291940109000001883902622xxxxx ",,"REQUEST_test5 ","ORDER_065623791944xxxxx ","Chilled American Medium (Mika's coffee shop) ",CARD,,AUTHORIZATION,2024-11-29T17:56:23+08:00,CASHIER_PAYMENT,2,HKD,,,GB,VISA,DEBIT
"21881202142xxxxx ",Alipay_SG,,," ","202411291940108070001883902634xxxxx ","202411291940109000001883902622xxxxx ","REQUEST_test5 ","ORDER_065623791944xxxxx ","Chilled American Medium (Mika's coffee shop) ",CARD,,CAPTURE,2024-11-29T17:56:26+08:00,CASHIER_PAYMENT,2,HKD,"REQUEST_test5 ",,GB,VISA,DEBIT
"21881202142xxxxx ",Alipay_SG,,," ","202411291940108013001883902412xxxxx ","202411291940109000001883902622xxxxx ","REQUEST_ggkkkggkkxxxxx ",,Don't want,CARD,,REFUND,2024-11-29T18:00:35+08:00,CASHIER_PAYMENT,-0.13,HKD,"REQUEST_test5 ",,GB,VISA,DEBIT
"21881202142xxxxx ",Alipay_SG,,," ","20241129290131014278047xxxxx ","202411201940109000001884202623xxxxx ",,"ORDER_085721491926xxxxx ",,CARD,,DISPUTE,2024-11-29T15:56:48+08:00,CASHIER_PAYMENT,0,HKD,"REQUEST_test2 ",,GB,VISA,DEBIT
"21881202142xxxxx ",Alipay_SG,,global_viver, ,"20241129194010800100188360266xxxxx ",,"globa20241129172200xxxxx ","241129KOG703_xxxxx ","Mousse Cake (Mika's coffee shop) ",ALIPAY_HK,AlipayHK,PAYMENT,2024-11-29T17:22:33+08:00,CASHIER_PAYMENT,114,USD,,,,,
"21881202142xxxxx ",Alipay_SG,,global_viver, ,"20241129194010801300188360244xxxxx ","202411291940108001001883602662xxxxx ","202411291940108070001883602675xxxxx ",,"Mousse Cake (Mika's coffee shop) ",ALIPAY_HK,AlipayHK,CANCEL,2024-11-29T17:24:45+08:00,CASHIER_PAYMENT,-114,USD,"globa20241129172200xxxxx ",,,,
"21881202142xxxxx ",Alipay_SG,,," ","202411291940108063001885002408xxxxx ","202411291940108001001885002634xxxxx ","5015202412034303788645170xxxxx ","5015202412034303788645170xxxxx ","Ice ",CARD,,VOID,2024-11-29T15:44:01+08:00,CASHIER_PAYMENT,-1,KRW,"5015202412034303788645170xxxxx ",,KR,VISA,CREDIT
"21881202142xxxxx ",Alipay_SG,,," ","202401128290131013980044xxxxx ","202411071940108001001883902386xxxxx "," ","2591054-20241108022547xxxxx "," ",CARD,,RAPID_DISPUTE_RESOLUTION,2024-11-29T16:46:16+08:00,CASHIER_PAYMENT,-56.88,USD,"PR_17230551xxxxx ",,SE,VISA,CREDIT
<END>
在本样例中,授权、请款和退款的重要信息如下:
- 授权信息:
- transactionId:交易流水号 202411291940109000001883902622xxxxx,与原授权支付中的 paymentId 的值相同。
- transactionAmountValue:交易金额 2 (HKD),与原授权支付中的 paymentAmount.value 的相同。
- 请款信息:
- transactionId:交易流水号 202411291940108070001883902634xxxxx,与原请款中的 captureId 的值相同。
- transactionAmountValue:交易金额 2 (HKD),为原请款中的 captureAmount.value 的基础单位的值。
- originalTransactionId:原始交易流水号 202411291940109000001883902622xxxxx,与原授权支付请求中的 paymentId 相同。
- originalTransactionRequestId:原先支付请求 ID REQUEST_test5,与原授权支付请求中的 paymentRequestId 相同。
- 退款信息:
- transactionId:交易流水号 202411291940108013001883902412xxxxx,与原退款中的 refundId 的值相同。
- transactionAmountValue:交易金额 0.13 (HKD) ,为原退款中的 refundAmount.value 的基础单位的值。
- originalTransactionId:原始交易流水号 202411291940109000001883902622xxxxx,与原授权支付请求中的 paymentId 相同。
- originalTransactionRequestId:原先支付请求 ID REQUEST_test5,与原授权支付请求中的 paymentRequestId 相同。
付款和取消的重要信息如下:
- 付款信息:
- transactionId:交易流水号 202411291940108001001883602662xxxxx,为原支付中的 paymentId 的值相同。
- transactionRequestId:商家分配的交易请求唯一标识为 globa20241129172200xxxxx,为原支付的 paymentRequestId 的值相同
- transactionAmountValue:交易金额114 (USD),为原支付中的 paymentAmount.value 的基础单位的值。
- 取消信息:
- transactionId:交易流水号 202411291940108013001883602449xxxxx,为原支付中的 paymentId 的值相同。
- transactionAmountValue:交易金额114 (USD),为原支付中的 paymentAmount.value 的基础单位的值。
- originalTransactionId:原始交易流水号 202411291940108001001883602662xxxxx,与原支付请求中的 paymentId 相同。
- originalTransactionRequestId:原先支付请求 ID globa20241129172200xxxxx,与原支付请求中的 paymentRequestId 相同。
样例二(无交易)
2024 年 11 月 29 日商家无交易,2024 年 11 月 30 日,Antom 会生成一个 CSV 空文件,内容仅包含字段名和文件结束符,详情如下:
customerId,acquirer,acquirerReferenceNo,referenceMerchantId,referenceStoreId,transactionId,originalTransactionId,transactionRequestId,referenceTransactionId,orderDescription,paymentMethodType,pspName,transactionType,paymentTime,productCode,transactionAmountValue,transactionCurrency,originalTransactionRequestId,installmentsNum,issuingCountry,cardBrand,funding
<END>
注意:无交易的情况下,默认 SFTP 服务器或 Antom Dashboard 都不会产生账单。若您需要无交易下的空账单,您可以联系 Antom 技术支持(AlipayGlobalTechService@service.alipay.com)在 SFTP 服务器下进行配置。