Listar cobranças

Diferente da recuperação de uma cobrança específica, este método retorna uma lista paginada com todas as cobranças para os filtros informados.

Listar cobranças de um cliente específico: GET https://api.asaas.com/v3/payments?customer={customer_id}

Filtrar por forma de pagamento: GET https://api.asaas.com/v3/payments?billingType=CREDIT_CARD

Filtrar por status: GET https://api.asaas.com/v3/payments?status=RECEIVED

Filtrar por status e forma de pagamento: GET https://api.asaas.com/v3/payments?status=RECEIVED&billingType=CREDIT_CARD

Filtrar por data de criação inicial e final: GET https://api.asaas.com/v3/payments?dateCreated%5Bge%5D=2017-01-12&dateCreated%5Ble%5D=2017-11-28

Filtrar por data de vencimento inicial e final: GET https://api.asaas.com/v3/payments?dueDate%5Bge%5D=2017-01-12&dueDate%5Ble%5D=2017-11-28

Filtrar por data de recebimento inicial e final: GET https://api.asaas.com/v3/payments?paymentDate%5Bge%5D=2017-01-12&paymentDate%5Ble%5D=2017-11-28

Filtrar apenas cobranças antecipadas: GET https://api.asaas.com/v3/payments?anticipated=true

❗️

Evite fazer polling

Polling é a prática de realizar sucessivas requisições GET para verificar status de cobranças. É considerado uma má prática devido ao alto consumo de recursos que ocasiona. Recomendamos que você utilize nossos Webhooks para receber mudanças de status de cobranças e manter sua aplicação atualizada.

Realizar muitas requisições pode levar ao bloqueio da sua chave de API por abuso.

Leia mais: Polling vs. Webhooks