PayZu GatewayApoio
Checklist de produção
Leve a integração para a produção sem recusa de acesso nem aviso perdido, conferindo estes itens antes da primeira chamada.
Acesso
| Confira | Guia |
|---|---|
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
| Confira | Guia |
|---|---|
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
| Confira | Guia |
|---|---|
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.