Sandbox
El entorno sandbox (entorno de pruebas) le permite probar su integración sin procesar pagos reales ni crear pedidos reales.
Sandbox vs Producción
| Característica | Sandbox | Producción |
|---|---|---|
| URL base | Misma (/v2/partners) | Misma (/v2/partners) |
| Claves API | Claves con prefijo sandbox | Claves de producción |
| Pagos | Simulados (sin cargos reales) | Procesamiento de pagos real |
| Límites de velocidad | 5x más altos que producción | Límites estándar |
| Webhooks | Entregados normalmente | Entregados normalmente |
| Datos de pedidos | Datos de prueba, purgados periódicamente | Persistentes |
Cómo funciona
Sus entornos sandbox y de producción están determinados por la clave API que utilice. Las claves API de sandbox se emiten por separado de las claves de producción en su panel de control de socio.
- Use las claves de sandbox durante el desarrollo y las pruebas.
- Cambie a las claves de producción cuando esté listo para salir a producción.
- Ambos entornos exponen los mismos endpoints y aceptan los mismos formatos de solicitud.
Pagos simulados
En modo sandbox, todo el procesamiento de pagos es simulado:
- Los pagos con CARD siempre se aprueban sin contactar al procesador de pagos.
- Los tokens de GOOGLE_PAY y APPLE_PAY se aceptan sin validación.
- Los flujos de IDEAL, REVOLUT y BANCONTACT se completan inmediatamente sin redirección.
- No se cobra dinero real y no se requiere un método de pago real.
Consejos de prueba
- Use direcciones de correo electrónico con prefijo sandbox (p. ej.,
sandbox-user@example.com) para los datos del cliente para distinguir claramente los pedidos de prueba. - Pruebe la entrega de webhooks en sandbox para verificar que su endpoint maneja las cargas útiles (payloads) correctamente.
- Simule escenarios de error usando valores de prueba específicos documentados en su panel de control de socio.
- Los límites de velocidad en sandbox son 5 veces los límites de producción, dándole más margen para probar rápidamente.