PayZu Conta HubCobrar com Pix

Consultar uma cobrança


Consulte a cobrança pelo id, que é o mesmo paymentId dos webhooks, para conciliar ou quando um aviso não chegar.

Consulte pelo id

bash
curl --url 'https://api.sandbox.payzu.dev/api/v1/transactions/payment/P20261005113205K7Q2M9XB4TC127431' \
  --header 'Authorization: Bearer SEU_TOKEN'

Referência: Consultar uma cobrança e Listar as cobranças

  • payer: quem pagou, preenchido depois do pagamento.
  • pix.endToEndId: o end-to-end do Pix. Guarde-o com o pagador para a conciliação.
  • refundableAmount: o máximo que ainda pode ser devolvido.
  • refunds: as tentativas de devolução da cobrança.

Para achar uma cobrança pelo seu identificador, use Listar as cobranças com externalRef.

Na dúvida entre o aviso e a consulta, vale o status da consulta.

A cobrança passa a REFUNDED quando as devoluções concluídas, somadas ao que um MED procedente devolveu ao pagador, chegam ao valor dela, ou quando o banco parceiro devolve o recebimento por conta própria. Nesse segundo caso chega PAYMENT_REFUNDED, e o valor cheio sai da conta.

Erros desta operação

CódigoHTTPMensagem
PAYMENT_INVALID_CURSOR400Cursor de paginação inválido — recomece da primeira página.
PAYMENT_NOT_FOUND404Pagamento não encontrado.

Todos os códigos do PayZu Conta Hub estão no Catálogo de erros.