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

AmbienteEndereço
Sandboxhttps://api.sandbox.payzu.dev
Produçãohttps://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.
RotasRecorrência
Planos, assinaturas e configurações, em /v1/plans, /v1/subscriptions e /v1/settingsExigem. Sem ela, respondem 404.
Plano e assinatura do CheckoutExigem. Sem ela, respondem 404.
Faturas, clientes, cartões, token de cartão, contestações, webhooks e as rotas do link e da fatura no checkoutNão exigem.
CódigoHTTPMensagem
PZ032403Cartão não habilitado para esta conta. Fale com o suporte para habilitar ou ofereça apenas Pix.
PZ033403Pix não habilitado para esta conta. Fale com o suporte para habilitar.
PZ034404Recorrência não ativada para esta conta.

Os demais itens a conferir estão no Checklist de produção.