PayZu PaymentsCobranças

Confirmar o pagamento


Nesta páginaReceba o postbackConsulte a cobrançaErros desta operação

Saiba do pagamento pelo postback enviado à postbackUrl da cobrança ou, sem ela, pela consulta.

Receba o postback

A PayZu envia um POST assinado para a postbackUrl a cada mudança no Pix. O corpo traz event igual a charge.update e, em data, a cobrança completa, com os mesmos campos da consulta.

MudançapixPayment.status
Pagamento confirmadopaid
QR Code vencido ou venda canceladacanceled
Devolução concluídarefunded
Devolução não concluídapaid
Falha de um Pix pendentefailed

O corpo de um Pix pago está em Cobrança atualizada. A assinatura, o prazo de resposta e as novas tentativas são os mesmos do cartão; veja Validação da assinatura.

Libere o pedido só com pixPayment.status igual a paid e pixPayment.refunds vazio.

Se o pagamento chegar no momento em que o QR Code vencido é cancelado, a cobrança vai a paid com uma devolução já pedida, e o valor volta ao pagador.

O mesmo aviso pode chegar mais de uma vez. Identifique a cobrança por data.id, aja pelo status que vem em data e libere o pedido uma só vez.

Consulte a cobrança

Sem postbackUrl, acompanhe o Pix pela consulta.

bash
curl --request GET \
  --url 'https://api.sandbox.payzu.dev/v1/charges/0b9c4e2a-6f1d-4c8e-9a37-2d5e8f1a4b6c' \
  --header "Authorization: Bearer $PAYZU_TOKEN" \
  --cert "$PAYZU_CLIENT_CERT" --key "$PAYZU_CLIENT_KEY"

Referência: Consultar uma cobrança

A consulta de um Pix pendente busca a situação atualizada no máximo uma vez a cada 30 segundos por cobrança.

Consultas mais frequentes recebem o último estado conhecido, então o postback é o jeito mais rápido de saber do pagamento.

As cobranças Pix também aparecem em Listar cobranças, com cada item no mesmo formato da consulta.

Erros desta operação

CódigoHTTPMensagem
PZ100404Cobrança não encontrada

Os erros de autenticação e de validação e os demais códigos estão no Catálogo de erros.