订单和单项商品数据
订单和单项商品数据包括有关订单以及订单包含的商品的信息,您可以在请求中提供这些信息,并可以选择在确认付款前向付款人显示信息(通过 Hosted Checkout 或浏览器付款)。 在交易中提供某些订单和单项商品数据,商务卡、企业卡或购物卡持有人有可能在交易过程中享受到更好的交换费率。 有关更多信息,请参阅 II 级和 III 级数据。
order.item[n].brandorder.item[n].categoryorder.item[n].descriptionorder.item[n].nameorder.item[n].quantity当十进位数量与金额(order.item[n].unitPrice、order.item[n].unitTaxAmount或order.item[n].unitDiscountAmount)相乘,并且计算后的值中小数位超过了付款人货币的最小单位时,网关会使用“舍入到偶数”算法舍入总额。 例如,如果 2.555(数量)乘以 3(单价)总计为 7.665,如果付款人使用的货币(美元)最小单位为 2,那么舍入后的商品金额将等于 7.66。
请确保在请求中提供这些金额字段时使用此舍入方法。order.item[n].skuorder.item[n].unitPrice
此金额乘以
order.item[n].quantity得出单项商品的商品总额。 如果提供了order.itemAmount,那么所有单项商品的商品总额之和必须等于order.itemAmount中的值。order.item[n].unitTaxAmount
此金额乘以
order.item[n].quantity得出单项商品的纳税总额。 如果提供了order.taxAmount,那么所有单项商品的纳税总额之和必须等于order.taxAmount中的值。order.item[n].unitDiscountAmount
此金额乘以
order.item[n].quantity得出单项商品的折扣总额。 如果提供了order.discount.amount,那么所有单项商品的折扣总额之和必须等于order.discount.amount中的值。
order.item[n].name、order.item[n].quantity 和 order.item[n].unitPrice 字段。order.currency(强制)order.idorder.descriptionorder.shippingAndHandlingAmountorder.amount(强制)
如果您未提供此字段,但提供了小计金额(
order.itemAmount、order.shippingAndHandlingAmount、order.taxAmount、order.gratuityAmount、order.cashbackAmount)和order.discount.amount,那么此金额计算为小计金额减去折扣金额后的金额。 如果您同时提供此值和小计金额,那么此字段中的值必须等于计算后的值。order.itemAmount
如果您未提供此值但提供了单项商品数据,那么此金额计算为所有单项商品的商品总额 (
order.item[n].unitPricexorder.item[n].quantity) 之和。 如果您同时提供此值和单项商品数据,那么此字段中的值必须等于计算后的值。order.taxAmount
如果您未提供此值但提供了单项商品数据,那么此金额计算为所有单项商品的纳税总额 (
order.item[n].unitTaxAmountxorder.item[n].quantity) 之和。 如果您同时提供此值和单项商品数据,那么此字段中的值必须等于计算后的值。order.discount.amount如果您未提供此值但提供了单项商品数据,那么此金额计算为所有单项商品的折扣总额 (
order.item[n].unitDiscountAmountxorder.item[n].quantity) 之和。 如果您同时提供此值和单项商品数据,那么此字段中的值必须等于计算后的值。order.gratuityAmount: 除付款人为从您那里购买的商品或服务支付的金额外,付款人选择作为提供的酬金或小费的金额。 小费金额包含在您在order.amount中提供的订单总额中。order.cashbackAmount: 除付款人为从您那里购买的商品或服务支付的金额外,付款人选择作为收到的现金的金额。 返现金额包含在您在order.amount中提供的订单总额中。
订单和单项商品数据适用于 Authorize、Pay、Initiate Browser Payment、Confirm Browser Payment、Open Wallet 和 Hosted Checkout 请求。
order.cashbackAmount 和 order.gratuityAmount 仅适用于 Authorize 和 Pay 请求。