PayZu PaymentsCobranças

Cobrança Pix


Nesta páginaComo integrarAntes de começarStatusQuando o valor fica disponível

Receba por Pix na mesma integração do cartão.

Fluxo da cobrança Pix: a cobrança gera o QR Code, o comprador paga até o vencimento, o postback avisa o pagamento e o valor vai ao saldo disponível no dia útil seguinte; sem pagamento o Pix é cancelado, e um Pix pago pode ser devolvido

Como integrar

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/token com o client_id e o client_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.statusSignificado
pendingQR Code gerado, aguardando o pagamento.
paidPago.
canceledO QR Code venceu sem pagamento.
refundedO valor foi devolvido ao comprador.
failedO 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.