PayZu PaymentsCobranças
Cobrança Pix
Receba por Pix na mesma integração do cartão.
Como integrar
1. Criar uma cobrança Pix
Crie a cobrança e mostre o Pix copia e cola ao comprador.
2. Confirmar o pagamentoSaiba do pagamento pelo postback ou pela consulta.
3. Devolver um PixDevolva ao comprador o valor inteiro de um Pix pago.
Antes de começar
- Habilitação: o Pix precisa estar habilitado na conta.
- Endereço: a API fica em
https://api.payzu.io, e as rotas começam por/v1. Os exemplos usam o sandbox, como em Ambientes e URLs. - Token: toda requisição leva o token gerado em
POST /v1/tokencom oclient_ide oclient_secret. Veja Token. - Certificado: a conexão apresenta o certificado de cliente quando a credencial o exige. Veja Mutual TLS.
- Segredo de assinatura: o
webhookSecret, recebido no cadastro, confere os postbacks. - Valores e datas: os valores são inteiros em centavos (R$ 100,00 é
10000), e as datas seguem o ISO 8601, em UTC.
Status
pixPayment.status | Significado |
|---|---|
pending | QR Code gerado, aguardando o pagamento. |
paid | Pago. |
canceled | O QR Code venceu sem pagamento. |
refunded | O valor foi devolvido ao comprador. |
failed | O Pix não pôde ser processado e não aceita pagamento. |
Os detalhes de cada status estão em Status do Pix.
Quando o valor fica disponível
- Recebível: cada Pix pago gera um recebível de uma parcela, já com a taxa de Pix da sua conta descontada.
- Liquidação: o recebível vai para o saldo disponível no dia útil seguinte ao pagamento, na liquidação das 18:00 (horário de Brasília).
- Até lá: o valor fica no saldo pendente.