Pasarela de pagos para Colombia
Cobra con PSE, Nequi, Daviplata, Bancolombia, Efecty, tarjeta y criptomonedas con una sola integración. Comisión de 0,05% y dispersiones a cuentas bancarias o llaves Bre-B.
Sin costo de integración. Checkout hospedado, listo para usar.
curl -X POST https://api.prod.niiopay.com/api/v1/collect \
-H "X-Api-Key: niio_live_..." \
-H "X-Api-Secret: niio_secret_..." \
-H "Content-Type: application/json" \
-d '{
"amount": 100000,
"currency": "COP",
"reference": "ORDEN-1042",
"webhookUrl": "https://tutienda.com/webhooks/niio"
}'Métodos de pago
Una integración, todos los medios que usa tu cliente en Colombia.
-
PSE
Débito directo desde cuentas bancarias colombianas.
-
Nequi
El cliente aprueba el pago desde su app.
-
Daviplata
Billetera digital de Davivienda.
-
Bancolombia
Botón de pago con débito a cuenta.
-
Efecty
Pago en efectivo en puntos físicos.
-
Tarjetas
Crédito y débito Visa y Mastercard.
-
Transferencia bancaria
Con verificación automática del pago.
-
Criptomonedas
BTC, ETH, USDT y USDC.
Cómo funciona
-
1
Creas la orden de cobro
Un
POSTa/v1/collectcon el monto y tu referencia. La API te devuelve uncollectUrlúnico. -
2
Tu cliente paga
Rediriges al
collectUrl. El checkout hospedado muestra los métodos disponibles y gestiona todo el flujo. -
3
Recibes el webhook
NIIO notifica a tu
webhookUrlcon firma HMAC-SHA256. Ese webhook es la fuente de verdad del pago.
Comisión de 0,05% on-top
Pides el monto que quieres recibir y el pagador cubre la comisión. Lo que solicitas es lo que te queda: sin descuentos sorpresa sobre tu venta.
baseAmount)
$ 100.000 COP
feeAmount)
$ 50 COP
amount)
$ 100.050 COP
Dispersiones a Bre-B y cuentas bancarias
Además de cobrar, dispersa tu saldo en pesos colombianos a cuentas
bancarias (BANK) o a llaves Bre-B (BREB).
Consulta los destinos con GET /payout/methods y crea la
dispersión con POST /payout, con idempotencia obligatoria
para que un reintento nunca pague dos veces.
Pagos de agentes de IA (x402)
Cobra a agentes autónomos con el protocolo x402: tu servidor responde
HTTP 402, el agente firma un pago en USDC sobre Polygon y
NIIO lo liquida on-chain. Sin cuenta, sin tarjeta y sin intervención
humana.
Para desarrolladores
-
Webhooks firmados
Cada evento llega con firma HMAC-SHA256 en
X-NIIO-Signature. Verifícala siempre: elcallbackUrles solo el retorno visual y no va firmado. -
Idempotencia
Envía tu propia
referenceal crear el cobro y haz tu handler idempotente: un webhook puede llegar más de una vez. -
SDKs y plugin
Ejemplos en Node.js, Python y PHP, colección de Postman y plugin de WooCommerce.
-
OpenAPI y llms.txt
Especificación en OpenAPI, referencia ejecutable en Scalar y llms.txt para agentes de IA.
Preguntas frecuentes
¿Cuánto cobra NIIO Pay por transacción?
La comisión es de 0,05% y se cobra on-top: tú pides el monto que quieres recibir y el pagador paga ese monto más la comisión. La respuesta de la API te devuelve amount (lo que paga el cliente), baseAmount (lo que recibes) y feeAmount.
¿Qué métodos de pago puedo aceptar en Colombia?
PSE, Nequi, Daviplata, Bancolombia, Efecty, tarjetas de crédito y débito Visa y Mastercard, transferencia bancaria y criptomonedas (BTC, ETH, USDT y USDC). Todos con una sola integración.
¿Cómo integro PSE en mi sitio web?
Haces un POST a /api/v1/collect con tus headers X-Api-Key y X-Api-Secret, y la API te devuelve un collectUrl. Rediriges a tu cliente a esa URL y el checkout hospedado se encarga de toda la interfaz de pago, incluido el flujo de PSE con el listado de bancos.
¿Hay un ambiente de pruebas (sandbox)?
No hay un sandbox separado. Las pruebas se hacen contra producción con credenciales de prueba y montos pequeños. Conviene revisar la guía de pruebas antes de procesar pagos reales.
¿Cómo obtengo las credenciales de la API?
Las credenciales (niio_live_… y niio_secret_…) se solicitan al equipo de NIIO. Todavía no hay un panel de autoservicio para generarlas.
¿Cómo confirmo que un pago se completó?
Con el webhook que NIIO envía a tu webhookUrl cuando el pago se completa o falla. Verifica siempre la firma HMAC-SHA256 del header X-NIIO-Signature: el webhook es la fuente de verdad. El callbackUrl es solo el retorno visual del cliente, no va firmado y no debe usarse para marcar un pago como recibido.
¿El cliente paga el mismo monto que yo recibo?
No. La comisión va on-top, así que el cliente paga un poco más de lo que tú recibes. Si pides un cobro de 100.000 COP, esos 100.000 son los que te quedan (baseAmount) y el pagador ve el total con la comisión sumada.
¿Puedo dispersar dinero a una llave Bre-B?
Sí. Los payouts de NIIO dispersan saldo a cuentas bancarias (BANK) o a llaves Bre-B (BREB) en Colombia, en pesos colombianos. Se consultan los destinos con GET /payout/methods y se crea la dispersión con POST /payout, que exige idempotencia.
¿Qué pasa si un webhook llega dos veces?
Puede pasar, así que tu handler debe ser idempotente. Usa el campo reference (tu identificador único) al crear la orden para reconocer el evento repetido y no acreditar dos veces.
¿Acepta pagos con criptomonedas?
Sí. El checkout acepta Bitcoin (BTC), Ethereum (ETH), USDT y USDC, y el comercio recibe la confirmación por el mismo webhook que el resto de métodos.
¿Tienen plugin para WooCommerce?
Sí, hay un plugin de WooCommerce, además de ejemplos de integración en Node.js, Python y PHP y una colección de Postman.
¿Un agente de IA puede pagar automáticamente?
Sí, con el protocolo x402: el servidor responde HTTP 402, el agente firma un pago en USDC sobre Polygon y NIIO lo liquida on-chain. No hace falta que el agente tenga cuenta ni tarjeta.
Empieza a cobrar hoy
Crea tu primer link de pago en cinco minutos.