Un Sandbox separa tus clientes, pagos, llaves y webhooks de prueba de producción. No mueve dinero real. Necesitas una cuenta y permisos de administrador, o una invitación al Sandbox de tu equipo.
Abre tu ambiente de prueba
- Ingresa a Recurrente y abre Configuración → Llaves API → Sandbox.
- Elige Crear Sandbox y dale un nombre.
- Elige Crear mi llave TEST y guarda la llave completa. Se muestra una sola vez. Si la pierdes, crea otra; las otras llaves siguen funcionando.
- Sigue la guía de primer pago para confirmar el ambiente, crear un checkout de Q5 y recibir el webhook.
En el celular, el botón principal aparece al pie de la pantalla. En la guía, cambia según el paso pendiente. Después de hacer una solicitud o un pago de prueba, elige Actualizar progreso para ver el siguiente paso.
Dentro de un Sandbox, una barra amarilla en la parte superior muestra el nombre del ambiente y Dinero de prueba, para que nunca confundas pruebas con producción. Su menú de tres puntos permite abrir la guía o Volver a producción, si tienes acceso a esa cuenta.
Usa 4242 4242 4242 4242 para un pago exitoso o 4000 0000 0000 0002 para un rechazo, con fecha futura y CVC de tres dígitos. Usa datos ficticios. El pago aparece en Actividad; Ver entregas y reintentar permite revisar el resultado HTTP y reenviar un webhook.
Desde Administrar ambientes puedes crear, renombrar o archivar Sandboxes. Puedes tener hasta cinco activos; archiva uno si necesitas crear otro.
Invita a quien desarrolla tu integración
Abre Equipo y elige Añadir. La invitación da permisos dentro de ese ambiente, sin agregar acceso a producción. La persona abre el enlace del correo y confirma con Abrir mi Sandbox en la página de ingreso. Después puede reencontrar su ambiente en la sección Pruebas al iniciar sesión. Puedes quitarle acceso desde Equipo.
Si algo falla
- Si no puedes abrir el ambiente, pide al administrador que te invite directamente al Sandbox.
- Si pegaste una llave enmascarada, crea una nueva y copia el valor completo.
- Si
/testdevuelvelegacy_test, usa una llave creada dentro del Sandbox. - Si no llega el webhook, revisa su URL pública, la firma y las entregas en el panel; realiza otro pago después de registrar el endpoint.
Las transferencias, splits, swaps y retiros están bloqueados. Las pruebas no reproducen 3DS ni liquidación bancaria real. Para producción, completa la activación, cambia a una llave LIVE y registra el webhook LIVE con su propio secreto. Los datos y balances de Sandbox no pasan a producción.
Si necesitas ayuda, comparte el ID del Sandbox y del checkout, la hora y el mensaje de error. No envíes llaves API, secretos de webhooks ni datos de tarjetas.
Contacta a soporte por correo [email protected] o por WhatsApp +1 (786) 917-5397.