PayZu PaymentsCobranças

Listar cobranças


Liste as cobranças de um período para conciliar as vendas ou achar uma cobrança cuja resposta se perdeu.

Liste as cobranças

  • Período: startDate e endDate filtram pela data de criação e comparam instantes. Entram as cobranças criadas a partir de startDate e até endDate, inclusive.
  • Paginação: avance page, a partir de 1 (padrão 1), até totalPages. limit vai de 1 a 100, com padrão 10.
  • Pix: as cobranças Pix entram na mesma lista, com paymentType igual a pix.
bash
curl --request GET \
  --url 'https://api.sandbox.payzu.dev/v1/charges?startDate=2026-06-01T00:00:00-03:00&endDate=2026-06-30T23:59:59.999-03:00&limit=10&page=1' \
  --header "Authorization: Bearer $PAYZU_TOKEN" \
  --cert "$PAYZU_CLIENT_CERT" --key "$PAYZU_CLIENT_KEY"

Referência: Listar as cobranças

Uma data sem hora vale 00:00 em UTC.

Com endDate=2026-06-30, quase todo o dia 30 fica de fora. Mande o instante completo, com o fuso.

Não há filtro por externalId.

Para achar um pedido, liste o período em que a cobrança foi criada, com endDate no instante atual quando ela pode ser de hoje, e compare externalId nos itens de charges.

Para ler uma cobrança pelo id, veja Consultar uma cobrança. Os erros de autenticação e de validação e os demais códigos estão no Catálogo de erros.