Fases y certificación (Pase a Producción)
Cada sistema de cobro pasa por tres fases. La idea es simple: primero pruebas contra un entorno 100% simulado, después contra el procesador real en modo test, y solo entonces cobras dinero de verdad.
Sandbox
api-test.wizpay.app
- Dinero de mentira, flujo real
- Tarjetas ficticias de WizPay
- Billetera QR de prueba
- Banco 3-D Secure simulado
Implementación
api.wizpay.app · credenciales TEST
- Procesador real (CyberSource) en modo test
- Tarjetas oficiales de la matriz 3DS
- Nueva API key enviada por correo
Producción
api.wizpay.app · credenciales reales
- Cobros reales a tus clientes
- Reportes, facturación y antifraude
- API key definitiva
El switch de registro
En tu panel → Pase a Producción hay un switch de Registro de transacciones. Mientras está apagado, la API no registra transacciones de prueba (te lo dice con un error claro). Actívalo cuando estés listo para tu corrida de certificación: así decides exactamente qué transacciones cuentan.
Si tu integración devuelve el error "El registro de transacciones está desactivado", no es un bug: entra a tu panel → Pase a Producción y activa el switch.
Los requisitos de certificación
Para solicitar el pase de fase necesitas, en la fase actual, estas transacciones aprobadas:
| Requisito | Cantidad |
|---|---|
| Cobro con Visa (sin 3DS) | 1 |
| Cobro con Mastercard (sin 3DS) | 1 |
| Cobro con Amex (sin 3DS) | 1 |
| Cobros con 3-D Secure (Step-Up completado, cualquier marca) | 2 |
| Cobros con QR | 3 |
El panel muestra un checklist en vivo que se llena solo mientras corres tus pruebas, y debajo la lista de transacciones efectuadas con su detalle (haz clic en cualquiera para ver la tarjeta, el código de autorización o quién pagó el QR).
¿Te equivocaste o quieres una corrida limpia? El botón "Empezar pruebas de 0" borra las transacciones de prueba de la fase y reinicia los contadores (tus API keys se conservan).
Las tarjetas correctas para cada fase
- Sandbox: usa las tarjetas ficticias de WizPay (sección Fase Sandbox en tu panel →
Tarjetas de Prueba). El challenge 3DS abre un banco simulado — el código es
1234. - Implementación: usa las tarjetas oficiales de CyberSource TEST (sección Fase Implementación de la misma página), organizadas por escenario: Frictionless, Attempts y Step-Up (estas últimas cuentan para el requisito de 3DS).
Las tarjetas del sandbox no funcionan en implementación, y ninguna tarjeta de prueba funciona en producción. Cada fase tiene las suyas.
Solicitar el pase
Cuando el checklist está completo, el botón "Solicitar pase" se habilita:
- Tu solicitud llega a nuestro equipo (con tus contadores como evidencia).
- La revisamos y configuramos las credenciales del procesador para tu siguiente fase.
- Te llega un correo con tu nueva API key (la anterior deja de funcionar) y las instrucciones de la fase.
- Si algo se observa, te llega el motivo exacto para corregir y volver a solicitar.
En Implementación repites la misma certificación (mismos requisitos) y al aprobarla tu sistema pasa a Producción: desde ese momento procesas cobros reales. 🎉