Montos y monedas
Precios en céntimos, tasas decimales y conversión al momento del pago.
Unidad menor
| Valor enviado | Moneda | Importe |
|---|---|---|
1000 | VES | 10,00 Bs. |
2500 | USD | USD 25,00 |
999 | EUR | EUR 9,99 |
Envía enteros, nunca un monto como 10.50. Las tasas de cambio llegan como texto decimal para conservar su precisión.
Precio y liquidación
Un precio en USD o EUR puede cobrarse en bolívares a tasa BCV. El importe de referencia y el importe liquidado son conceptos diferentes: muestra al cliente el importe que devuelve el método de pago. No calcules el cobro a partir de una tasa guardada en el navegador.
| Método | Ruta | Resultado |
|---|---|---|
| GET | /v1/currencies | Monedas y disponibilidad |
| GET | /v1/exchange-rates | Tasas oficiales actuales |
Que una moneda exista en los tipos no implica que esté disponible para cobrar. Consulta la disponibilidad antes de ofrecerla: sigue el entorno de tu clave (sin clave, el de producción), y un método que solo funciona en pruebas no activa su moneda en producción.
Impuestos
taxBehavior: "inclusive" indica que el precio ya contiene el impuesto; "exclusive" lo añade al precio. El impuesto es el IVA del negocio: si no es contribuyente de IVA, tax es 0 y el total es el precio, sea cual sea taxBehavior, y un checkout o Cobro puede juntar productos con taxBehavior distinto. Usa los totales que devuelve Billete para subtotal, descuentos, impuestos y total.
Reembolsos
El importe de un reembolso está en la moneda de liquidación del pago. No envíes el precio original en divisas como si fuera el importe cobrado en bolívares.