API de pagos y recaudos para empresas en Colombia

Qué puedes hacer con la API de pagos

La API trabaja con órdenes de cobro. Una orden tiene un monto, un concepto y un estado. Tu sistema la crea, la consulta y la cancela cuando lo necesita.

• Crea una orden de cobro desde tu servidor con el monto y el concepto.
• Consulta el estado de cada orden y la lista de sus eventos.
• Cancela una orden pendiente que nadie empezó a pagar.
• Recibe un webhook firmado con HMAC cada vez que una orden cambia de estado.
• Pon en tu web un botón de pago con monto fijo o con monto libre.
• Envía una clave de idempotencia en cada orden para no crear la misma orden dos veces.

Medios de pago que acepta la API

Una sola orden acepta Bre-B, Nequi, Bancolombia, PSE y tarjeta. Tu cliente elige el medio en el checkout de iion pay. Tú no tienes que integrar cada medio por separado.

El monto mínimo de cada cobro es $5.000. La disponibilidad de cada medio depende de la configuración de tu comercio. En el panel ves cuáles tienes activos.

Webhooks firmados con HMAC

Cuando una orden cambia de estado, iion pay envía un aviso a la URL que configuras. Por ejemplo, el aviso llega cuando el pago se completa o cuando el pago falla.

Cada aviso lleva una firma HMAC calculada con tu secreto. Tu servidor calcula la misma firma y la compara antes de dar el pedido por pagado. Así descartas avisos falsos.

Idempotencia: una orden por cada clave

Una red inestable puede hacer que tu servidor repita una petición. Si la petición repetida lleva la misma clave de idempotencia y los mismos datos, la API devuelve la orden que ya existe. No crea un segundo cobro.

Usa una clave única por cada intento de compra, por ejemplo el número de pedido de tu tienda.

Lo que pagas: la misma tarifa del cobro a comercio

Un cobro creado por la API paga la misma comisión que un cobro creado en la app o en el panel. La comisión depende del medio de pago y de tu plan: Start, Grow o Scale.

A la comisión de Bre-B, Nequi, Bancolombia y PSE se suma un IVA de 19 % sobre la comisión completa. Un ejemplo con un cobro de $100.000 en el plan Start, pagado por Bre-B: la comisión es $990 y el IVA es $189. Tú recibes $98.821.

La tarjeta no lleva IVA. A su comisión se suma el costo estimado del procesador de tarjetas: hasta 6 % + US$0,41 por pago. Por eso, con tarjeta lo que recibes es aproximado hasta que el procesador liquida el pago.

Seguridad de las llaves

Tu API key y tu secreto se generan en el panel de tu empresa. Guarda el secreto solo en tu servidor. No lo pongas en el código de tu web ni en una app.

Crear una orden no mueve dinero. Solo genera el cobro. El dinero se mueve cuando tu cliente paga.

Comisión por medio de pago y plan

Bre-B, Nequi, Bancolombia y PSE: más IVA de 19 % sobre la comisión. Tarjeta: sin IVA, más el costo estimado del procesador de tarjetas, hasta 6 % + US$0,41 por pago.

Cifras medidas el 22 de octubre de 2026 y el 25 de octubre de 2026.

Cómo empezar

1. Crea la cuenta de empresa. Crea la cuenta de tu empresa en el panel de iion pay y completa la verificación. Cuando aprobemos tu cuenta de empresa, ya puedes cobrar.
2. Genera la API key. En el panel, abre la sección de API y genera tu API key y tu secreto. Guarda el secreto en tu servidor.
3. Crea una orden. Desde tu servidor, crea una orden de cobro con el monto, el concepto y una clave de idempotencia. Envía a tu cliente al checkout de la orden.
4. Recibe el webhook. Cuando tu cliente paga, tu servidor recibe un webhook firmado. Comprueba la firma y marca el pedido como pagado.