字段

说明

settlementBatchId

必选 String (64)收单机构分配的用于识别结算批次的唯一标识，与结算汇总文件中的结算批号相同。如果收单机构不分配结算批次号，APO 会生成该批次号。

customerId

必选 String (64)

收单机构为商家分配的唯一身份标识。

acquirer

必选 String (64)

负责交易处理的收单机构的名字。

该收单机构主要是指为您提供收单和资金结算服务的机构。

acquirerReferenceNo

可选 String (64)

收单机构（非 Antom ）为交易分配的唯一识别 ID。

当交易是由收单机构（非 Antom ）进行结算时，该字段会有值。

referenceMerchantId

可选 String (64)

直接向买家提供服务或商品的商家唯一标识，由机构分配给其二级商户。

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

referenceStoreId

可选 String (64)

商家店铺的唯一标识，由对应商家分配。

transactionId

必选 String (64)

APO 分配的交易唯一标识。该字段的值遵循以下规则：

• 当 transactionType 为 PAYMENT、CANCEL 或 AUTHORIZATION 时，该字段的值与 paymentId 的值相同。
• 当 transactionType 为 CAPTURE 时，该字段的值与 captureId 的值相同。
• 当 transactionType 为 REFUND 时，该字段的值与 refundId 的值相同。
• 当 transactionType 为 DISPUTE 时，该字段的值与 disputeId 的值相同。

originalTransactionId

可选 String (64)

原始交易的标识符。

• 当 transactionType 为 PAYMENT、CANCEL 或AUTHORIZATION时，该字段的值为空。
• 当 transactionType 为 VOID 时，该字段的值与原支付或授权请求的 paymentId 相同。
• 当 transactionType 为 REFUND 时，该字段的值与原支付或授权请求的 paymentId 相同。
• 当 transactionType 为 CAPTURE 时，该字段的值与原支付或授权请求的 paymentId 相同。
• 当 transactionType 为 DISPUTE 时，该字段的值与原授权请求的 paymentId 相同。

transactionRequestId

必选 String (64)

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

当 transactionType 为 DISPUTE 时，该字段为空。

referenceTransactionId

可选 String (64)

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

当 transactionType 为 CANCEL, CAPTURE 或 DISPUTE 时，该字段为空。

paymentMethodType

必选 String (32)

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

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

pspName

可选 String (64)

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

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

transactionType

必选 String

交易类型，包含的值如下：

• PAYMENT：表示交易类型为支付。
• REFUND：表示交易类型为退款。
• CANCEL：表示交易类型为取消。
• AUTHORIZATION：表示交易类型为卡支付预授权。
• CAPTURE：表示交易类型为卡支付授权后请款。
• VOID：表示交易类型为卡支付预授权解除。
• DISPUTE: 表示交易类型为拒付。
• REFUND_REVERSAL: 表示由于支付方式无法处理退款而导致退款失败，资金会返回到您的账户。
• SETTLEMENT_FEE: 表示收单机构收取结算手续费。具体费用明细通过 settlmentAmountValue 和 settlementCurrency 字段体现。
• DISPUTE_REVERSAL: 表示拒付抗辩成功，拒付发生反转。
• COLLATERAL_WITHHOLDING: 表示保证金留存。
• RESERVE_WITHHOLDING：表示预留金留存。
• RESERVE_RELEASE：表示预留金释放。
• COLLATERAL_RELEASE：表示保证金释放。

paymentTime

必选 String (64)

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

settlementTime

必选 String (64)

收单机构向您结算的日期和时间，格式为 YYYY-MM-DDTHH:MM:SS+hh:mm，遵循 ISO 8601 标准。

productCode

必选 String

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

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

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

transactionAmountValue

必选 String (16)

交易金额，以主要货币单位展示（例如美元用 USD 表示，日元用 JPY 表示）。

transactionCurrency

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

settlementAmountValue

必选 String (16)

净结算金额，以主要货币单位展示（例如美元用 USD 表示，日元用 JPY 表示）。

settlementCurrency

必选 String (3)

settlementAmountValue 对应的币种，为 ISO 4217 中定义的 3 个字母的货币代码。

quoteCurrencyPair

可选 String (16)

报价币种对, 目前 APO 使用外汇合作机构提供的标准币种对顺序进行报价。两种货币用斜线分隔，均为 ISO 4217 中定义的 3 个字母的货币代码，如 USD/IDR。

若交易币种与结算币种相同，该字段为空。

quotePrice

可选 Decimal (20)

报价币种对时价，quoteCurrencyPair 参数指定的货币对中两种货币之间的汇率报价。

若交易币种与结算币种相同，该字段为空。

feeAmountValue

必选 String (16)

处理该笔交易收取的各种费用的总金额，以主要货币单位展示（例如美元用 USD 表示，日元用 JPY 表示）。

feeCurrency

必选 String (3)

feeAmountValue 对应的币种，为 ISO 4217 中定义的 3 个字母的货币代码。

nonGuaranteeCouponValue

可选 String (16)

商家折扣金额，该金额会在结算给商家的总金额中直接扣除，以主要货币单位展示（例如美元用 USD 表示，日元用 JPY 表示）。

nonGuaranteeCouponCurrency

可选 String (3)

nonGuaranteeCouponValue 对应的币种，为 ISO 4217 中定义的 3 个字母的货币代码。

originalTransactionRequestId

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

installmentsNum

可选 String (8)

表示分期付款的期数。

issuingCountry

可选 String (2)

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

当 paymentMethodType 为 CARD 时该字段有值。

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

cardBrand

可选 String (256)

卡品牌。

当 paymentMethodType 为 CARD 时该字段有值。

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

funding

可选 String (6)

卡的资金类型。包含值如下：

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

当 paymentMethodType 为 CARD 时该字段有值。

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