Listar cobranças

Devolve as cobranças criadas pela API, da mais recente para a mais antiga.

GET/v1/chargesescopo: charge:read

Query

limit
inteiro, 1 a 100opcional
Padrão 20.
starting_after
uuidopcional
Id do último item da página anterior.
status
stringopcional
Filtra por estado: processing, pending, paid, expired, canceled, failed, refunded, charged_back, infraction.
method
stringopcional
Filtra por meio de pagamento.
created_after
ISO 8601opcional
Só cobranças criadas depois deste instante.
created_before
ISO 8601opcional
Só cobranças criadas antes deste instante.
cURL
curl "https://api.transakto.io/v1/charges?status=paid&limit=50" \
  -H "x-api-key: sk_live_..."
Resposta 200
{
  "object": "list",
  "data": [
    {
      "id": "8f1c2a90-1f4b-4f0e-9d33-5a2c1b7e9a10",
      "object": "charge",
      "status": "paid",
      "amount": 4990,
      "currency": "BRL",
      "method": "pix",
      "reference": "pedido-1042",
      "paid_at": "2026-07-28T14:12:31.000Z",
      "created_at": "2026-07-28T14:00:00.000Z"
    }
  ],
  "has_more": false
}

Conciliação

Para sincronizar o que mudou desde a última rodada, filtre por created_after com o instante da execução anterior e pagine até has_more ficar falso. Para acompanhar pagamento, prefira o webhook: a listagem serve para fechar o dia, não para descobrir que alguém acabou de pagar.