PayZu Gateway
Ambientes de teste e produção
Teste a integração no sandbox sem movimentar dinheiro real e passe para a produção trocando só o endereço do servidor e as chaves, porque as rotas são as mesmas.
Servidores
| Ambiente | Endereço |
|---|---|
| Sandbox | https://api.sandbox.payzu.dev |
| Produção | https://api.gateway.payzu.com.br |
Cada ambiente tem a sua chave de API, enviada em Authorization: Bearer, e a sua chave de checkout, enviada em x-checkout-key. Na Referência API, o seletor ao lado do caminho de cada rota troca entre os dois servidores.
O /v1 já faz parte do caminho de cada rota.
Não acrescente o prefixo ao endereço do servidor: o caminho completo é o da rota, como em /v1/invoices.
Antes de ir para a produção
- Meios de pagamento: confirme que a conta tem habilitados os meios que você oferece, o que o suporte da PayZu faz. Sem a habilitação, as cobranças naquele meio respondem
403. - Recorrência: se você vende planos ou assinaturas, ative a Recorrência no painel.
| Rotas | Recorrência |
|---|---|
Planos, assinaturas e configurações, em /v1/plans, /v1/subscriptions e /v1/settings | Exigem. Sem ela, respondem 404. |
| Plano e assinatura do Checkout | Exigem. Sem ela, respondem 404. |
| Faturas, clientes, cartões, token de cartão, contestações, webhooks e as rotas do link e da fatura no checkout | Não exigem. |
| Código | HTTP | Mensagem |
|---|---|---|
PZ032 | 403 | Cartão não habilitado para esta conta. Fale com o suporte para habilitar ou ofereça apenas Pix. |
PZ033 | 403 | Pix não habilitado para esta conta. Fale com o suporte para habilitar. |
PZ034 | 404 | Recorrência não ativada para esta conta. |
Os demais itens a conferir estão no Checklist de produção.