字段

说明

settlementBatchId

必选 String (64)

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

customerId

必选 String (64)

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

acquirer

必选 String (64)

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

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

acquirerReferenceNo

可选 String (64)

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

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

referenceMerchantId

可选 String (64)

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

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

referenceStoreId

可选 String (64)

商家店铺的唯一标识，由一级商户分配给其二级商户。

transactionId

必选 String (64)

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

• 当 transactionType 为 PAYMENT、CANCEL 或 AUTHORIZATION 时，该字段的值与 paymentId 的值相同。
• 当 transactionType 为 CAPTURE 时，该字段的值与 captureId 的值相同。
• 当 transactionType 为 REFUND 时，该字段的值与 refundId 的值相同。
• 当 transactionType 为 DISPUTE 或 DISPUTE_REVERSAL 时，该字段的值与 disputeId 的值相同。
• 当 transactionType 为 VOID、REFUND_REVERSAL 、SETTLEMENT_FEE、COLLATERAL_WITHHOLDING、RESERVE_WITHHOLDING、 RESERVE_RELEASE 或 COLLATERAL_RELEASE 时，该字段的值为 APO 的内部 ID。

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)

电子钱包名称，例如 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 中定义的三位字母币种代码 。

settlementAmountValue

必选 String (16)

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

settlementCurrency

必选 String (3)

settlementAmountValue 对应的币种，为 ISO 4217 中定义的三位字母币种代码。

quoteCurrencyPair

可选 String (16)

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

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

quotePrice

可选 Decimal (20)

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

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

feeAmountValue

可选 String (16)

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

feeCurrency

必选 String (3)

feeAmountValue 对应的币种，为 ISO 4217 中定义的三位字母币种代码。

originalTransactionRequestId

可选 String (64)

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

acquirerTransactionType

可选 String

收单机构记录的原始交易类型。

acquirerCustomerId

可选 String (64)

收单机构分配的商户账户唯一 ID。

acquirerBatchId

可选 String (64)

收单机构分配给特定结算批次的唯一 ID。

cardBrand

可选 String (256)

卡品牌。

当 paymentMethodType 为 CARD 时该字段有值。

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