订单和单项商品数据
订单和单项商品数据包括有关订单以及订单包含的商品的信息,您可以在请求中提供这些信息,并可以选择在确认付款前向付款人显示信息(通过 <<checkout>> 或浏览器付款)。 在交易中提供某些订单和单项商品数据,商务卡、企业卡或购物卡持有人有可能在交易过程中享受到更好的交换费率。 有关更多信息,请参阅 II 级和 III 级数据。
order.item[n].brand
order.item[n].category
order.item[n].description
order.item[n].name
order.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].sku
order.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.id
order.description
order.shippingAndHandlingAmount
order.amount
(强制)
如果您未提供此字段,但提供了小计金额(
order.itemAmount
、order.shippingAndHandlingAmount
、order.taxAmount
、order.gratuityAmount
、order.cashbackAmount
)和order.discount.amount
,那么此金额计算为小计金额减去折扣金额后的金额。 如果您同时提供此值和小计金额,那么此字段中的值必须等于计算后的值。order.itemAmount
如果您未提供此值但提供了单项商品数据,那么此金额计算为所有单项商品的商品总额 (
order.item[n].unitPrice
xorder.item[n].quantity
) 之和。 如果您同时提供此值和单项商品数据,那么此字段中的值必须等于计算后的值。order.taxAmount
如果您未提供此值但提供了单项商品数据,那么此金额计算为所有单项商品的纳税总额 (
order.item[n].unitTaxAmount
xorder.item[n].quantity
) 之和。 如果您同时提供此值和单项商品数据,那么此字段中的值必须等于计算后的值。order.discount.amount
如果您未提供此值但提供了单项商品数据,那么此金额计算为所有单项商品的折扣总额 (
order.item[n].unitDiscountAmount
xorder.item[n].quantity
) 之和。 如果您同时提供此值和单项商品数据,那么此字段中的值必须等于计算后的值。order.gratuityAmount
: 除付款人为从您那里购买的商品或服务支付的金额外,付款人选择作为提供的酬金或小费的金额。 小费金额包含在您在order.amount
中提供的订单总额中。order.cashbackAmount
: 除付款人为从您那里购买的商品或服务支付的金额外,付款人选择作为收到的现金的金额。 返现金额包含在您在order.amount
中提供的订单总额中。
订单和单项商品数据适用于 Authorize、Pay、Initiate Browser Payment、Confirm Browser Payment、Open Wallet 和 <<checkout>> 请求。
order.cashbackAmount 和 order.gratuityAmount 仅适用于 Authorize 和 Pay 请求。