Skip to main content
Z2Pay has two fully isolated environments: Sandbox (testing) and Production.

Sandbox

Test environment. No real money is moved; payments are simulated in a deterministic way. Use it to develop and validate your integration.

Production

Live environment, connected to the payment processors. Moves real money.

​
Base URLs

ServiceSandboxProduction
API (PSP)https://api.sandbox.z2pay.comhttps://api.z2pay.com
Checkout APIhttps://checkout-api.sandbox.z2pay.comhttps://checkout-api.z2pay.com
Hosted pages (checkout/invoice)https://pay.sandbox.z2pay.comhttps://pay.z2pay.com
Dashboardaccessed via the “Test environment” buttonhttps://app.z2pay.com
API keys are environment-specific. A sandbox key does not work in production and vice versa. See Authentication.

​
How to access the sandbox

  1. Log in to the Production Dashboard (https://app.z2pay.com).
  2. In the profile menu, click “Test environment”.
  3. Wait for your sandbox to be automatically configured (first time only).
  4. You will be redirected and already logged into the Sandbox Dashboard, where you can find your test credentials and the payment simulation panel.

​
What changes in the sandbox

The sandbox uses a simulated provider (FakeProvider) instead of real payment processors. This makes tests deterministic:
  • Card: the outcome (approved/declined/failed) is determined by the last 4 digits of the card number. See Test cards.
  • PIX and boleto: settlement is controlled by a per-method setting (instant, auto, or manual), with the option to force scenarios by amount. See Test PIX and boleto.
  • Chargeback: can be simulated. See Simulate events.
Always start with the sandbox. Once your integration is solid, simply swap the base URLs and API key for production — the API contract is identical.