Saltar al contenido principal
La API te permite desglosar el total de un pago en componentes individuales, como cargos base, impuestos, comisiones, propinas y descuentos. Estos campos son informativos: cada componente ya está incluido en el amount.value total del pago y no se suma encima de él. La única excepción es un descuento YUNO_PROMOTION: envías el amount original y Yuno cobra amount.value menos ese descuento (consulta Descuentos).

Monto de la comisión

Un campo dedicado (additional_data.order.fee_amount) te permite especificar el monto de la comisión por tus servicios que está incluido en la transacción. En el siguiente ejemplo puedes ver una solicitud que aclara que una comisión de 180 JPY forma parte de una transacción final de 5000 JPY. Este campo es solo informativo: el fee_amount ya está incluido en el monto final de la transacción y no se suma por separado.

Monto de envío

Un campo dedicado (additional_data.order.shipping_amount) te permite especificar el monto de envío que está incluido en la transacción. En el siguiente ejemplo puedes ver una solicitud que aclara que un monto de envío de 270 JPY forma parte de una transacción final de 5000 JPY. Este campo es solo informativo: el shipping_amount ya está incluido en el monto final de la transacción y no se suma por separado.

Propinas

Un campo dedicado (additional_data.order.tip_amount) te permite especificar el monto de las propinas que está incluido en la transacción. En el siguiente ejemplo puedes ver una solicitud que aclara que una propina de 50 JPY forma parte de una transacción final de 5000 JPY. Este campo es solo informativo: el tip_amount ya está incluido en el monto final de la transacción y no se suma por separado.

Impuestos

Un arreglo dedicado de objetos (additional_data.order.taxes) te permite especificar los montos de impuestos por tus servicios que están incluidos en la transacción. En el siguiente ejemplo puedes ver una solicitud que aclara qué impuestos forman parte de una transacción final de 1000.00 USD. Este campo es solo informativo; la estructura taxes ya está incluida en el monto final de la transacción y no se ha sumado por separado.

Descuentos

Un arreglo dedicado de objetos (additional_data.order.discounts) te permite especificar los descuentos que están incluidos en la transacción. Cada línea tiene un type. MERCHANT (el valor predeterminado) es un descuento que calculaste tú: id, name y unit_amount son obligatorios, y id y name tienen de 3 a 255 caracteres. YUNO_PROMOTION es una cotización de promoción calculada por Yuno, solo con quote_id; rechaza id, name y unit_amount, una línea MERCHANT rechaza quote_id, y cualquier combinación devuelve 400 INVALID_PARAMETERS. Una línea con quote_id y sin type se interpreta como YUNO_PROMOTION. Escribe el type exactamente como se muestra, en mayúsculas: cualquier otra grafía devuelve 400. Una cotización por pago y, en total, como máximo 10 líneas de descuento. La línea YUNO_PROMOTION se acepta solo en Create Payment: los pagos con varios métodos, los enlaces de pago, las sesiones de checkout y la captura la rechazan con 400, y un pago que incluye un subscription o un external_subscription la rechaza con 422 PROMOTION_SUBSCRIPTION_UNSUPPORTED. En la respuesta y en cada webhook payment.*, Yuno completa la línea YUNO_PROMOTION (quote_id, id = el id de la promoción, unit_amount en la moneda del pago y, cuando Yuno lo tiene, name) y agrega un discount_amount, la suma de esas líneas. Tus líneas MERCHANT conservan su id, name y unit_amount; cuando el pago incluye una promoción de Yuno, la respuesta de Create Payment, Retrieve Payment y los webhooks listan primero la línea de Yuno y marcan la tuya con type: MERCHANT. El amount nunca se reescribe; el monto neto cobrado está en la transacción (transactions.amount). En el siguiente ejemplo puedes ver una solicitud que aclara que un descuento de 5 USD forma parte de una transacción final de 50 USD. Los descuentos calculados por el comercio son informativos: el monto ya está incluido en amount y no se suma de nuevo.
Example

Validaciones del cliente

Un objeto dedicado (customer_payer.merchant_customer_validations) te permite especificar ciertas reglas de validación del cliente para las consultas de prevención de fraude. En el siguiente ejemplo puedes ver una solicitud que aclara que el cliente fue verificado previamente fuera de Yuno.