Comece aqui

Ambientes


Nesta páginaServidoresComo obter a credencialAntes de ir para produçãoErros de liberaçãoPróximos passos

Desenvolva no sandbox de cada produto e vá para a produção trocando só o host e a credencial, porque o caminho de cada rota é o mesmo nos dois ambientes.

Servidores

Servidor de produçãoProdutos atendidosNo sandbox
https://api.payzu.processamento.com/v1PayZu Pixhttps://pix.sandbox.payzu.dev/v1
https://api.hub.payzu.com.br/api/v1PayZu Conta Hubhttps://api.sandbox.payzu.dev/api/v1
https://api.payzu.io/v1PayZu Payments e recorrência no cartãohttps://api.sandbox.payzu.dev/v1
https://api.gateway.payzu.com.brAPI e checkout do PayZu Gatewayhttps://api.sandbox.payzu.dev
https://api.payzu.devPayZu Onboardinghttps://api.sandbox.payzu.dev
https://api.exchange.payzu.com.brPayZu CâmbioNão há sandbox

Na referência, o seletor ao lado do caminho de cada rota troca entre os dois servidores, e o Try It! começa no sandbox. No PayZu Câmbio, o seletor mostra só o servidor de produção.

No PayZu Gateway e no PayZu Onboarding, o /v1 já faz parte do caminho.

As rotas são /v1/invoices e /v1/proposals, e a troca de token do PayZu Onboarding fica na raiz, em /oauth/token. Não acrescente o prefixo ao host.

Como obter a credencial

ProdutoSandboxProdução
PayZu PixCredencial de 24 horas, sem cadastro, em Credencial de sandboxToken Bearer emitido na abertura da conta
PayZu Conta Hubclient_id e client_secret trocados em POST /oauth/token, ou o token da credencial direto no BearerA mesma forma, com a credencial de produção
PayZu Payments e recorrência no cartãoclient_id e client_secret trocados em POST /token, mais o certificado mTLS quando a credencial o exige, que é o padrãoA mesma forma, com a credencial de produção
Checkout do PayZu GatewayChave de checkout da conta, no header x-checkout-keyA chave de checkout de produção
API do PayZu GatewayChave de API criada no painel, em Authorization: BearerA chave de API de produção
PayZu OnboardingConta de serviço com autorização cadastrada pela PayZu; POST /oauth/token troca o ID token dela pelo token da APIA mesma troca, no servidor de produção
PayZu CâmbioNão há sandboxChave de API criada no painel, em Authorization: Bearer
  • Sandbox do PayZu Pix. Você confirma o seu e-mail com o código de seis dígitos enviado a ele e recebe o token.
  • Checkout do PayZu Gateway. As rotas de fatura e de link do checkout não pedem chave.

O passo a passo de cada forma está em Autenticação.

Antes de ir para produção

ExigênciaOnde vale
IP na lista da contaTodas as rotas, inclusive cobrança e consulta
Pelo menos um IP cadastradoConta que envia Pix pela API
Contrato assinado pelo representante legalRotas que criam ou alteram algo: cobrar, sacar, devolver, cadastrar webhooks, gerar relatórios e reenviar callbacks

O sandbox do PayZu Pix não confere IP nem contrato. Veja IP cadastrado.

Erros de liberação

CódigoHTTPMensagem
PZA203403Acesso não permitido a partir do endereço de IP 203.0.113.10.
PZA205403Conta com token de saque exige IP cadastrado na whitelist. Cadastre o IP de origem (203.0.113.10) antes de operar.
PZA206403Conta aguardando assinatura do contrato. Assine o contrato enviado ao representante legal para liberar as operações.
TOKEN_IP_NOT_ALLOWED403Esta credencial não pode ser usada a partir deste IP.

As mensagens de PZA203 e PZA205 trazem o IP de origem da chamada.

Use esse endereço quando a saída passa por proxy ou NAT.

Próximos passos