Saltar al contenido principal
Cada monto que envías a la API de Yuno es un objeto con un currency y un value. currency es un código ISO 4217 alfabético de tres letras. value es el monto en unidades mayores de esa moneda: envía 25 para USD 25.00, no 2500. Dieciséis monedas no tienen unidades menores. Para estas monedas, value debe ser un número entero. Yuno no redondea ni trunca el valor por ti: una solicitud con un value fraccionario devuelve 400 INVALID_PARAMETERS antes de que Yuno cree algo.
Request

Monedas sin decimales

Cualquier otra moneda acepta un value decimal. COP no está en la lista, porque ISO 4217 asigna dos dígitos decimales al peso colombiano, por lo que COP 11833.2 se acepta, mientras que KRW 11833.2 no. Los dígitos decimales de la moneda de cada país aparecen en la referencia de países. Los ceros finales no hacen fallar la validación: 11833.00 se acepta para KRW, 11833.2 se rechaza.

Dónde se aplica la regla

Yuno valida cada campo que lleva un value junto a un código de moneda, tanto en la solicitud que crea la operación como en la que la actualiza:

El error

Response
El mensaje indica el campo que falló. Un cardholder_amount fraccionario devuelve The field 'currency_conversion.cardholder_amount' has an invalid amount.

Redondea una sola vez, al construir el pedido

Si tu catálogo fija los precios de los artículos con dos decimales, redondea cada línea a una unidad entera al construir el pedido, con la regla de redondeo que exija tu política de precios, y guarda los valores redondeados. Envía esos mismos números enteros en la sesión de checkout, en el pago y en cada reembolso. No redondees en cada llamada a la API a partir de los valores con dos decimales. Un total redondeado una vez y un conjunto de líneas redondeadas una por una pueden diferir en una unidad, lo que hace que un reembolso parcial falle o que la suma de los reembolsos supere el monto cobrado. Para un reembolso parcial, calcula el value del reembolso a partir de los montos de línea guardados en unidades enteras y comprueba que la suma de todos los reembolsos del pago no supere su amount.value cobrado.

Ejemplo

La primera solicitud se rechaza porque value tiene una parte fraccionaria. La segunda solicitud es el mismo pedido con el valor redondeado al won.
Rejected
Response
Accepted
Un reembolso parcial del mismo pago sigue la misma regla:
Partial refund