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 unvalue junto a un código de moneda, tanto en la solicitud que crea la operación como en la que la actualiza:
amounten sesiones de checkout, en pagos y en enlaces de pago.amounten reembolsos: Reembolsar un pago, Cancelar o reembolsar un pago y Cancelar o reembolsar un pago con transacción. La validación se ejecuta antes de que Yuno busque el pago, por lo que un reembolso parcial fraccionario de un pago enKRWfalla con el mismo error.currency_conversion.cardholder_amountfrente acardholder_currency, ymerchant_amountfrente amerchant_currency.- Los montos de pagos divididos y el
fixed_amountde la configuración de división de un destinatario. - Los montos de suscripciones, planes, medidores, métodos de envío y payout.
El error
Response
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 elvalue 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 porquevalue tiene una parte fraccionaria. La segunda solicitud es el mismo pedido con el valor redondeado al won.
Rejected
Response
Accepted
Partial refund
Relacionado
- Referencia: Solución de problemas enumera este error junto con las demás respuestas comunes.
- Referencia: la referencia de países indica la moneda y sus dígitos decimales para cada país.
- Guía: Reembolsar pagos cubre los reembolsos completos y parciales.
- Referencia: Detalles del pago desglosa un total en comisiones, envío, propinas, impuestos y descuentos.