En esta página

Pruebas

Prueba tu integración antes de procesar pagos reales.

Ambiente de pruebas

No hay sandbox separado
iion pay no tiene sandbox ni llaves de prueba. Las pruebas se hacen contra producción con tus API keys. Créalas en el panel de negocios, en Integraciones → API keys. Usa montos pequeños mientras validas tu integración.

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.

Crear cobro de prueba
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
Email 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.

Inicia tu servidor local
npm run dev  # Tu servidor en http://localhost:3000
Expón con ngrok
ngrok http 3000

ngrok te dará una URL pública como https://abc123.ngrok.io

Configura el webhook del merchant

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-Signature de todos los webhooks
  • Manejas correctamente los errores de la API
  • El callback URL redirige al usuario correctamente
  • Tu UI muestra estados de pago apropiados
¿Listo para producción?
Una vez verificado todo, ya puedes procesar pagos reales con las mismas API keys. Si tienes dudas, escribe a soporte@iionpay.com.