Empezar

Montos y monedas

Todos los montos son enteros en centavos. No hay decimales en ningún campo de plata.

Cien veces. Mandar 119000 en vez de 11900000 cobra $ 1.190 en lugar de $ 119.000. La API no puede detectarlo: los dos son montos válidos. Es el error de integración más común y el más caro.

La conversión es siempre la misma: amount = pesos × 100. El peso colombiano no se fracciona en la práctica, pero el campo se expresa igual en centavos para que la misma API sirva en los mercados que sí lo hacen.

Lo que ve el comprador	Lo que mandas
$ 1.000 COP	`100000`
$ 10.000 COP	`1000000`
$ 119.000 COP	`11900000`
$ 1.500.000 COP	`150000000`

Moneda

currency es opcional y por defecto es COP. Hoy se liquida en Colombia; se aceptan tarjetas emitidas en cualquier país, pero el cobro se hace en pesos.

Topes por medio de pago

Las tarjetas no tienen tope de red: el límite lo pone el emisor. Los medios instantáneos sí, y un monto fuera de rango devuelve 422.

Medio	Mínimo	Máximo
`pse`	—	Sin tope de red
`nequi`	—	~$ 12.000.000 COP
`daviplata`	—	$ 3.000.000 COP
`breb`	$ 1.000 COP	—

Cómo se cobra con cada uno está en Medios instantáneos.

Cero como monto

Solo un caso admite amount: 0: verificar que una tarjeta guardada sigue viva, con intent: "account-status". No mueve plata y no le aparece nada al tarjetahabiente. Cualquier otro endpoint rechaza el cero con 400.

Esta página en markdown: /docs/montos.md · Toda la documentación: /docs/llms-full.txt