PayZu GatewayApoio

Checklist de produção


Nesta páginaAcessoOperaçõesAvisos

Leve a integração para a produção sem recusa de acesso nem aviso perdido, conferindo estes itens antes da primeira chamada.

Acesso

ConfiraGuia
O servidor trocado por https://api.gateway.payzu.com.br.Ambientes de teste e produção
A chave de API criada no painel, que aparece uma única vez, guardada no servidor, fora do código e do navegador.Autenticação
No aparelho do comprador, só as chaves públicas da tokenização.Tokenização de cartão
A Recorrência ativada no painel, se você vende planos ou assinaturas. Sem ela, as rotas de planos, assinaturas e configurações retornam 404.Recorrência
Os meios que você oferece habilitados na conta. Sem o cartão ou sem o Pix, a cobrança naquele meio retorna 403.Ambientes de teste e produção

Operações

ConfiraGuia
Idempotency-Key em toda criação de fatura, pagamento de fatura, estorno e criação de assinatura, com a mesma chave repetida quando a chamada der timeout.Idempotência
A resposta 201 lida pelo status da fatura e de payments[0]: o cartão recusado deixa a fatura pending, com a tentativa failed, e a nova tentativa vai com outra Idempotency-Key.Pagar uma fatura
A tentativa processing tratada como resultado em aberto: não cobre de novo e espere invoice.paid ou invoice.payment_failed.Vender no cartão
Os valores em centavos inteiros. A fatura, o plano e a assinatura avulsa aceitam no mínimo 500 (R$ 5,00), também depois do desconto, e a fatura fora do limite da conta retorna 422.Valores em dinheiro
O pedido liberado só com a fatura paid, e o acesso só com a assinatura active.Cobranças
Cada erro tratado pelo code e, quando ele não vem, pelo status_code, como no 429 do limite por IP.Erros

Avisos

ConfiraGuia
O webhook cadastrado antes da primeira venda, assinando os eventos que você trata, como invoice.paid e invoice.payment_failed, com o secret da resposta guardado.Cadastrar webhooks
X-Webhook-Signature conferido em cada aviso.Assinatura dos webhooks
Cada aviso gravado, respondido com 2xx em até 5 segundos e deduplicado pelo id do evento.Webhooks
As entregas com status=failed em GET /v1/webhook-deliveries acompanhadas, e as que ficaram sem processar reenviadas.Consultar entregas e Reenviar entregas

O que acontece antes do cadastro do webhook não é enviado depois.

A PayZu só gera aviso para webhook ativo que assina o evento. O secret só volta quando você troca o segredo.