En esta página
Pruebas
Prueba tu integración antes de procesar pagos reales.
Ambiente de pruebas
URLs del ambiente
| Recurso | URL |
|---|---|
| API | https://api.prod.iionpay.com/api/v1 |
| Página de pago | https://pay.iionpay.com |
Obtener credenciales
Las credenciales (X-Api-Key con prefijo niio_live_ y
X-Api-Secret) se crean en el panel de negocios, en
Integraciones → API keys. Consulta la guía de
autenticación.
Probar la creación de un cobro
Crea una orden de cobro por 5.000 COP y abre la collectUrl que
devuelve la respuesta para validar el flujo de extremo a extremo. Si la API responde 400
COLLECT_AMOUNT_BELOW_MINIMUM, el message trae el monto mínimo vigente: crea la orden de nuevo con ese monto.
curl -X POST https://api.prod.iionpay.com/api/v1/collect \
-H "X-Api-Key: niio_live_tu_api_key" \
-H "X-Api-Secret: niio_secret_tu_api_secret" \
-H "Content-Type: application/json" \
-d '{
"amount": 5000,
"currency": "COP",
"description": "Prueba de integración"
}'
Datos de cliente de ejemplo
| Campo | Valor |
|---|---|
| Nombre | Test User |
test@example.com |
|
| Tipo documento | CC |
| Número documento | 1234567890 |
Probar webhooks
Para recibir webhooks en desarrollo local, expón tu servidor a internet con una herramienta como ngrok o localtunnel.
npm run dev # Tu servidor en http://localhost:3000
ngrok http 3000
ngrok te dará una URL pública como https://abc123.ngrok.io
Registra https://abc123.ngrok.io/webhook como webhook general de tu comercio en el panel (Integraciones → Webhooks) para recibir los eventos payment.completed y payment.failed.
También puedes registrarla por API con PUT /api/v1/collect/webhook (la URL va en el campo url) y enviar un aviso de prueba firmado con POST /api/v1/collect/webhook/test.
Checklist antes de producción
Antes de procesar pagos reales, verifica que:
- Puedes crear órdenes de cobro exitosamente
- La página de pago (
collectUrl) carga correctamente - Recibes el webhook al completarse un pago
- Tu sistema maneja los webhooks de forma idempotente
- Verificas la firma
X-IION-Signaturede todos los webhooks - Manejas correctamente los errores de la API
- El callback URL redirige al usuario correctamente
- Tu UI muestra estados de pago apropiados