Skip to main content
A Z2Pay tem dois ambientes totalmente separados: Sandbox (testes) e Produção.

Sandbox

Ambiente de testes. Nenhum dinheiro real é movimentado; os pagamentos são simulados de forma determinística. Use para desenvolver e validar sua integração.

Produção

Ambiente real, conectado às adquirentes. Movimenta dinheiro de verdade.

​
URLs base

A API da Z2Pay fica em um host, versionado em /v1: Outros endereços da plataforma:
As chaves de API são específicas de cada ambiente. Uma chave de sandbox não funciona em produção e vice-versa. Veja Autenticação.
Se a sua integração usa os subdomínios antigos (billing-api.*, checkout-api.*), eles seguem funcionando, mas estão depreciados — migre para a base acima.

​
Como acessar o sandbox

  1. Faça login no Dashboard de produção (https://app.z2pay.com).
  2. No menu de perfil, clique em “Ambiente de testes”.
  3. Aguarde a configuração automática do seu sandbox (na primeira vez).
  4. Você é redirecionado já logado no Dashboard de sandbox, onde encontra suas credenciais de teste e o painel de simulação de pagamentos.

​
O que muda no sandbox

O sandbox simula os pagamentos de forma determinística, sem acionar as adquirentes reais. Isso torna os testes previsíveis:
  • Cartão: o desfecho (aprovado/recusado/falha) é definido pelos últimos 4 dígitos do número. Veja Cartões de teste.
  • PIX e boleto: a liquidação é controlada por uma configuração por método (instant, auto ou manual), com a opção de forçar cenários por valor. Veja PIX e boleto de teste.
  • Chargeback: pode ser simulado. Veja Simular eventos.
Comece sempre pelo sandbox. Quando sua integração estiver redonda, basta trocar a URL base e a API key para produção — o contrato da API é idêntico.