Consultar cobrança

Busque uma cobrança pelo id ou liste as cobranças da sua conta, com filtro por status.

GET/v1/charges/{id}

Devolve a cobrança se ela for sua. Cobranças de outras contas respondem 404

cURL

curl https://api-sandbox.carecapay.com/v1/charges/txn_8f2c1a9b \
  -H "Authorization: Bearer SUA_CHAVE_SECRETA"

GET/v1/charges

Filtros da listagem

Parâmetro	Tipo	Descrição
`status`	string	Filtra por status: pending, paid, expired ou failed.
`limit`	integer	Quantidade máxima de itens. Padrão 50, teto 100.

200 OK

{
  "data": [
    {
      "id": "txn_8f2c1a9b",
      "status": "paid",
      "method": "pix",
      "amount_cents": 1990,
      "currency": "BRL",
      "qr_code": "00020126580014br.gov.bcb.pix...",
      "qr_code_base64": "iVBORw0KGgoAAAANSUhEUgAA...",
      "provider_charge_id": "b6f0e3...",
      "external_reference": "order_42",
      "created_at": "2026-07-09T12:00:00Z",
      "paid_at": "2026-07-09T12:03:11Z"
    }
  ],
  "count": 1
}

Como saber que foi paga

Configure um Webhook: o CarecaPay faz um POST assinado na SUA API no momento em que a cobrança é paga (evento charge.paid) — sua aplicação reage na hora, sem consultar a gente. Use este GET para reconciliação e para exibir detalhes, não para descobrir o pagamento.

Não marque um pedido como pago sem confirmação: ou pelo evento charge.paid do webhook (com a assinatura ou o token conferidos), ou vendo status paid neste GET. O QR Code exibido não garante pagamento.