A API PayZu permite integrar pagamentos por PIX, boleto e cartão ao seu sistema, site ou aplicativo.
Credenciais de acesso
1. Acesse o painel em Configurações > Integrações > API.
2. Gere suas chaves de Sandbox (testes) e de Produção.
3. Guarde a chave secreta em local seguro — ela não é exibida novamente e nunca deve ser exposta no front-end.
Ambiente de testes (Sandbox)
Use o Sandbox para validar toda a integração sem movimentar dinheiro real. As transações de teste aparecem no painel identificadas com o selo Sandbox.
Autenticação
As requisições usam o padrão Bearer token no cabeçalho Authorization. Tokens comprometidos podem ser revogados e regenerados a qualquer momento no painel.
Webhooks
Configure a URL de notificação em Integrações > Webhooks para receber eventos de pagamento confirmado, estorno e chargeback em tempo real. Sempre valide a assinatura do evento antes de processar.
Erros comuns
401: chave inválida ou ambiente trocado (Sandbox x Produção).
422: campo obrigatório ausente ou formato inválido — verifique o corpo da requisição.
429: limite de requisições excedido — implemente retentativa com intervalo progressivo.
Suporte técnico
Ao abrir um chamado sobre integração, informe o endpoint chamado, o horário, o ID da requisição retornado no cabeçalho da resposta e o código de erro recebido. Nunca envie sua chave secreta no chamado.
Related Articles
O que é uma API?
Uma API é uma interface que permite a comunicação entre sistemas de forma automática. Na prática, ela conecta plataformas diretamente aos serviços da PayZu, eliminando a necessidade de operações manuais no painel. Com essa integração, é possível ...
API PayZu: Acessar e administrar token de API no dashboard
O dashboard PayZu permite criar e gerenciar múltiplos tokens de API para integração com seus sistemas. Durante a criação, você poderá definir quais permissões serão concedidas ao token, como depósitos, saques ou ambas as operações. Por segurança, os ...
Como funciona a API do Pix para clientes?
A API do Pix da PayZu permite que empresas integrem pagamentos instantâneos de forma simples e segura. Com ela, é possível automatizar cobranças, transferências e consultas de forma totalmente integrada ao seu sistema ou aplicativo. As principais ...
Whitelist IP na PayZu: adicione seu IP pelo dashboard
A Whitelist permite restringir o acesso à sua conta e às integrações apenas para os endereços IP autorizados, aumentando a segurança das operações. Você pode cadastrar quantos IPs desejar, conforme a necessidade da sua operação. Para adicionar um ...
Como reenviar um Callback (Webhook)
Caso seja necessário reenviar um callback (webhook) para o seu sistema, o processo pode ser realizado diretamente pelo painel da PayZu. Acesse a página de Webhooks: https://web.payzu.processamento.com/webhooks Localize a transação para a qual deseja ...