Whisper Money

Buscar en la documentación

Busca páginas y secciones.

Importes y monedas

Todos los importes son enteros en la unidad más pequeña de su propia moneda, junto a la moneda en la que están.

Enteros en unidades mínimas

La API nunca envía ni acepta decimales para el dinero. Un importe es un número entero de la unidad mínima de la moneda, y el objeto al que pertenece lleva su currency como código ISO 4217:

{
    "amount": -1250,
    "currency": "EUR"
}

Eso son −12,50 €: 1.250 céntimos. Los importes negativos son dinero que sale y los positivos, dinero que entra.

No todas las monedas tienen céntimos

Cuántas unidades mínimas forman una unidad depende de la moneda, así que nunca dividas entre 100 a ciegas. Lee antes la currency:

Moneda Unidades mínimas por unidad 1250 significa
EUR, USD, GBP y la mayoría 100 12,50
JPY, COP, CLP, PYG, PKR 1 1.250
KWD 1.000 1,250
BTC 100.000.000 0,0000125

Cuando envíes un importe, usa las unidades mínimas de la moneda de la cuenta u objeto al que corresponde.

La única excepción son las conditions de una regla de automatización: un importe que se compara ahí va en unidades principales y con signo, así que un gasto de 12,50 es -12.5.

Fechas

Las fechas son cadenas ISO 8601: 2026-01-15 para un día del calendario, como el de una transacción, y 2026-01-15T09:30:00+00:00 para un instante, como el momento en que se creó algo.