Saltar al contenido principal
El sandbox es un entorno de pruebas aislado, idéntico al de producción en el contrato de la API, pero que no mueve dinero real. En lugar de las adquirentes, utiliza un proveedor simulado (FakeProvider) que decide el resultado de cada pago de forma determinista — usted elige si un pago será aprobado, rechazado o quedará pendiente.

Tarjetas de prueba

Qué números pasan, cuáles fallan — y un generador de tarjeta válida.

PIX y boleto

Controle la liquidación: pagar al instante, tras X minutos o manualmente.

Simular eventos

Fuerce el pago manual y el chargeback desde el panel.

Guía de pruebas

Un paso a paso que cubre aprobación, rechazo, PIX, devolución y chargeback.

​
Cómo acceder

  1. Inicie sesión en el Dashboard de producción y haga clic en “Entorno de pruebas”.
  2. Obtenga sus credenciales de sandbox en la sección de credenciales.
  3. Apunte su integración a las URLs de sandbox:
ServicioURL base
API (PSP)https://api.sandbox.z2pay.com
Checkout APIhttps://checkout-api.sandbox.z2pay.com
Páginas hospedadashttps://pay.sandbox.z2pay.com
Consulte los detalles en Entornos.

​
Principio: todo es determinista

A diferencia de un gateway real (donde el resultado depende del emisor), en el sandbox usted controla el desenlace:
MétodoCómo se decide el desenlace
TarjetaPor los últimos 4 dígitos del número. Ej.: ...1002 = rechazado, ...1111 = aprobado.
PIX / boletoPor la configuración de liquidación por método (instant/auto/manual) y, opcionalmente, por valor (centavos mágicos).
ChargebackPor valor (tarjeta pagada terminada en 31) o manualmente desde el panel.
En el sandbox el CVV se ignora para las tarjetas — lo que importa es el last-4. En producción, el CVV es validado normalmente por la adquirente.
Como los centavos del valor pueden disparar escenarios de PIX/boleto/chargeback, al probar con tarjeta use valores “redondos” (terminados en 00) para no activar un escenario sin querer.