Datos del pedido y de artículos de línea
Los datos del pedido y de productos de línea incluyen información acerca del pedido y los artículos contenidos en el pedido, lo cual puede proporcionar en la solicitud y elegir su visualización para el pagador (a través de Hosted Checkout o pagos mediante explorador) antes de confirmar el pago. Ciertos datos de pedido y de artículo de línea, cuando se proporcionan en una transacción, pueden calificar la transacción para obtener mejores tasas de intercambio con los titulares de tarjetas corporativas, de negocios o de compra. Para obtener más información, consulte Datos de Nivel II y Nivel III.
order.item[n].brandorder.item[n].categoryorder.item[n].descriptionorder.item[n].nameorder.item[n].quantityCuando una cantidad decimal se multiplica por montos (order.item[n].unitPrice,order.item[n].unitTaxAmount, o bienorder.item[n].unitDiscountAmount), y si los decimales del valor calculado exceden las unidades menores de la moneda del pagador; el motor de pagos redondeará el total usando el algoritmo "redondear la mitad al par". Por ejemplo, si 2.555 (cantidad) multiplicado por 3 (precio unitario) da un total de 7.665, y si la moneda del pagador (USD) tiene 2 unidades menores, entonces el monto del artículo redondeado será igual a 7.66.
Asegúrese de aplicar este redondeo cuando proporcione estos campos de monto en la solicitud.order.item[n].skuorder.item[n].unitPrice
Este monto se multiplica por
order.item[n].quantitypara calcular el monto total de artículos para el artículo de línea. Si se proporcionaorder.itemAmount, entonces la suma del monto total de artículos para todos los artículos de línea DEBE igualar el valor deorder.itemAmount.order.item[n].unitTaxAmount
Este monto se multiplica por
order.item[n].quantitypara calcular el monto total del impuesto para el artículo de línea. Si se proporcionaorder.taxAmount, entonces la suma del monto total del impuesto para todos los artículos de línea DEBE igualar el valor deorder.taxAmount.order.item[n].unitDiscountAmount
Este monto se multiplica por
order.item[n].quantitypara calcular el monto total del descuento para el artículo de línea. Si se proporcionaorder.discount.amount, entonces la suma del monto total de descuento para todos los artículos de línea DEBE igualar el valor deorder.discount.amount.
order.item[n].name, order.item[n].quantity y order.item[n].unitPrice para dicho artículo.order.currency(obligatorio)order.idorder.descriptionorder.shippingAndHandlingAmountorder.amount(obligatorio)
Si no proporciona este campo, pero proporciona cualquiera de los montos subtotales (
order.itemAmount,order.shippingAndHandlingAmount,order.taxAmount,order.gratuityAmount,order.cashbackAmount) yorder.discount.amount, entonces este monto se calcula como la suma de los montos subtotales menos el monto del descuento. Si proporciona tanto este campo como cualquier monto de subtotal, entonces el valor en este campo DEBE igualar el valor calculado.order.itemAmount
Si no proporciona este campo, pero proporciona cualquier dato de artículo de línea, entonces este monto se calcula como la suma de los montos totales de artículos (
order.item[n].unitPricexorder.item[n].quantity) para todos los artículos de línea. Si proporciona tanto este campo como cualquier dato de artículo de línea, entonces el valor en este campo DEBE igualar el valor calculado.order.taxAmount
Si no proporciona este campo, pero proporciona cualquier dato de artículo de línea, entonces este monto se calcula como la suma del monto total de impuesto (
order.item[n].unitTaxAmountxorder.item[n].quantity) para todos los artículos de línea. Si proporciona tanto este campo como cualquier dato de artículo de línea, entonces el valor en este campo DEBE igualar el valor calculado.order.discount.amountSi no proporciona este campo, pero proporciona cualquier dato de artículo de línea, entonces este monto se calcula como la suma del monto total de descuento (
order.item[n].unitDiscountAmountxorder.item[n].quantity) para todos los artículos de línea. Si proporciona tanto este campo como cualquier dato de artículo de línea, entonces el valor en este campo DEBE igualar el valor calculado.order.gratuityAmount: el monto que el pagador ha elegido proporcionar como propina, además del monto que está pagando por los bienes o servicios que le está comprando a usted. El monto de la propina está incluido en el monto total del pedido que usted proporciona enorder.amount.order.cashbackAmount: el monto que el pagador ha elegido recibir como efectivo, además del monto que está pagando por los bienes o servicios que le está comprando a usted. El monto de la devolución está incluido en el monto total del pedido que usted proporciona enorder.amount.
Los datos del pedido y de productos de línea se aplican a Authorize, Pay, Initiate Browser Payment, Confirm Browser Payment, Open Wallet y solicitudes de Hosted Checkout.
order.cashbackAmount y order.gratuityAmount solo se pueden aplicar a las solicitudes Authorize y Pay.
Referencia de API de Datos de pedido [REST][NVP]
Referencia de API de Datos de productos de línea [REST][NVP]