Sandbox
Entorno de pruebas. No se mueve dinero real; los pagos se simulan de forma
determinista. Úsalo para desarrollar y validar tu integración.
Producción
Entorno real, conectado a las adquirentes. Mueve dinero de verdad.
URLs base
| Servicio | Sandbox | Producción |
|---|---|---|
| API (PSP) | https://api.sandbox.z2pay.com | https://api.z2pay.com |
| Checkout API | https://checkout-api.sandbox.z2pay.com | https://checkout-api.z2pay.com |
| Páginas alojadas (checkout/factura) | https://pay.sandbox.z2pay.com | https://pay.z2pay.com |
| Dashboard | acceso mediante el botón “Entorno de pruebas” | https://app.z2pay.com |
Las claves de API son específicas de cada entorno. Una clave de sandbox no funciona en
producción y viceversa. Consulta Autenticación.
Cómo acceder al sandbox
- Inicia sesión en el Dashboard de producción (
https://app.z2pay.com). - En el menú de perfil, haz clic en “Entorno de pruebas”.
- Espera la configuración automática de tu sandbox (solo la primera vez).
- Serás redirigido ya autenticado al Dashboard de sandbox, donde encontrarás tus credenciales de prueba y el panel de simulación de pagos.
Qué cambia en el sandbox
El sandbox utiliza un proveedor simulado (FakeProvider) en lugar de las adquirentes reales. Esto hace que las pruebas sean deterministas:- Tarjeta: el resultado (aprobado/rechazado/error) está definido por los últimos 4 dígitos del número. Consulta Tarjetas de prueba.
- PIX y boleto: la liquidación está controlada por una configuración por método (
instant,autoomanual), con la opción de forzar escenarios por valor. Consulta PIX y boleto de prueba. - Chargeback: puede ser simulado. Consulta Simular eventos.