Pruebas

Prueba tu integración antes de procesar pagos reales.

Ambiente de pruebas

No hay sandbox separado

NIIO no expone hoy un ambiente sandbox independiente. Las pruebas se hacen contra el ambiente de producción usando credenciales de prueba que entrega tu contacto en NIIO. Usa montos pequeños mientras validas tu integración.

URLs del ambiente

Recurso	URL
API	`https://api.prod.niiopay.com/api/v1`
Página de pago	`https://pay.niiopay.com`

Obtener credenciales

Las credenciales (X-Api-Key con prefijo niio_live_ y X-Api-Secret) se solicitan a tu contacto en NIIO. Aún no existe un panel self-service para generarlas.

Probar la creación de un cobro

Crea una orden de cobro con un monto pequeño y abre la collectUrl que devuelve la respuesta para validar el flujo de extremo a extremo:

Crear cobro de prueba

curl -X POST https://api.prod.niiopay.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": 1000,
    "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 tu webhookUrl de merchant para recibir los eventos payment.completed y payment.failed.

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-NIIO-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, usa tus credenciales de producción. Si tienes dudas, contacta a tu contacto en NIIO.