Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

交易明细报告

交易明细报告包含 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 分配的交易唯一标识。该字段的值遵循以下规则:

  • 当 transactionType 为 PAYMENTCANCEL 、 AUTHORIZATION、或PAYMENT_REVERSAL 时,该字段的值与 paymentId 的值相同。
  • transactionTypeCAPTURE 时,该字段的值与 captureId 的值相同。
  • transactionTypeREFUND 时,该字段的值与 refundId 的值相同。
  • transactionTypeDISPUTE 时,该字段的值与 disputeId 的值相同。

originalTransactionId

可选 String (64)

原始交易的标识符。

  • 当 transactionType PAYMENTCANCELAUTHORIZATION时,该字段的值为空。
  • 当 transactionType VOID 时,该字段的值与原支付或授权请求的 paymentId 相同。
  • transactionType REFUND 时,该字段的值与原支付或授权请求的 paymentId 相同。
  • 当 transactionType CAPTURE 时,该字段的值与原支付或授权请求的 paymentId 相同。
  • 当 transactionType DISPUTE 时,该字段的值与原授权请求的 paymentId 相同。
  • 当 transactionType 为 PAYMENT_REVERSAL 时,该字段的值与原支付请求的 paymentId 相同。

transactionRequestId

必选 String (64)

商家分配的交易请求唯一标识。该字段的值与付款的 paymentRequestId 的值相同,或与退款的 refundRequestId 的值相同。

transactionTypeDISPUTE 时,该字段为空。

referenceTransactionId

可选 String (64)

直接向买家提供服务或商品的商家分配的用于识别交易的唯一标识。该字段的值与付款的 referenceOrderId 的值相同。

transactionTypeCANCELCAPTUREDISPUTE 时,该字段为空。

orderDescription

可选 String (256)

订单的说明。

该字段的值与原支付或授权请求中的 orderDescription 字段的值相同。

paymentMethodType

必选 String (32)

支付方式。可用枚举值请查看支付方式文档。

该字段的值与原先支付或授权请求中的 paymentMethodType 字段的值相同

pspName

可选 String (64)

Alipay+ 支付方式名称,例如 Gcash。

该字段的值原先支付或授权请求中的 pspName 字段的值相同

transactionType

必选 String

交易类型,包含的值如下:

  • PAYMENT:表示交易类型为支付。
  • REFUND:表示交易类型为退款。
  • CANCEL:表示交易类型为取消。
  • AUTHORIZATION:表示交易类型为卡支付预授权。
  • CAPTURE:表示交易类型为卡支付授权后请款。
  • VOID:表示交易类型为卡支付预授权解除。
  • DISPUTE表示交易类型为争议。
  • RAPID_DISPUTE_RESOLUTION表示交易类型为 RDR 争议。
  • PAYMENT_REVERSAL: 表示该交易最终支付成功。

paymentTime

必选 String (64)

交易达到成功或失败终态的日期和时间,格式为 YYYY-MM-DDTHH:MM:SS+hh:mm,遵循 ISO 8601 标准。

productCode

必选 String

Antom 和商家合同中约定的支付产品类型。值包含如下:

  • AGREEMENT_PAYMENT:表示代扣。
  • CASHIER_PAYMENT:表示收银台。

该字段的值与原支付或授权请求中的 productCode 字段的值相同。

transactionAmountValue

必选 String (16)

交易金额,以主要货币单位展示(例如美元用 USD 表示,日元用 JPY 表示)。

transactionCurrency

必选 String (3)transactionAmountValue 对应的货币,为 ISO 4217 中定义的 3 个字母的货币代码 。

originalTransactionRequestId

可选 String (64)交易类型为 REFUNDCANCELCAPTURE 时交易的原先支付请求 ID。该字段在其它情况下为空。

installmentsNum

可选 String (8)

表示分期付款的期数。

issuingCountry

可选 String (2)

发卡国家或地区。该字段值是遵循 ISO 3166 Country Codes 标准的二位国家码。

paymentMethodTypeCARD 时该字段有值。

该字段的值与原支付或授权请求中的 issuingCountry 字段的值相同。

cardBrand

可选 String (256)

卡品牌。

paymentMethodTypeCARD 时该字段有值。

该字段的值与原支付或授权请求中的 cardBrand 字段的值相同。

funding

可选 String (20)

支付方式的资金类型。当 paymentMethodTypeCARDGRABPAY_MY,或 GRABPAY_SG 时该字段有值。

paymentMethodTypeCARD 时,包含值如下:

  • CREDIT表示为信用卡。
  • DEBIT 表示为借记卡。

paymentMethodTypeGRABPAY_MY,或 GRABPAY_SG 时,包含值如下:

  • WALLETS表示为钱包余额支付。
  • BNPL_POSTPAID 表示先买后付,且一次性付清。
  • BNPL_INSTALLMENT表示先买后付,且分期付款。

该字段的值与原支付或授权请求中的 funding 字段的值相同。

表 1. 交易明细报告字段及说明

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

报告样例

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

样例一(标准账单)

在 2018 年 12 月 25 日(交易日), ID 为 102218800000000**** 的商家产生了两笔交易,一笔付款,一笔退款。在 2018 年 12 月 26 日,Antom 生成了一个 CSV 交易明细报告文件,详情如下:

copy
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>

📎交易明细报告-样例一.csv

在本样例中,付款和退款的重要信息如下:

  • 付款信息
    • 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 空文件,内容仅包含字段名和文件结束符,详情如下:

copy
customerId,acquirer,acquirerReferenceNo,referenceMerchantId,referenceStoreId,transactionId,originalTransactionId,transactionRequestId,referenceTransactionId,orderDescription,paymentMethodType,pspName,transactionType,paymentTime,productCode,transactionAmountValue,transactionCurrency,originalTransactionRequestId,issuingCountry,cardBrand,funding
<END>

📎交易明细报告-样例二.csv

注意:无交易的情况下,默认 SFTP 服务器或 Antom 全球商家门户都不会产生账单。若您需要无交易下的空账单,您可以联系 Antom 技术支持在 SFTP 服务器下进行配置。