> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flarepayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultar Cobrança

> Retorna os dados completos de uma cobrança

## Descrição

Retorna os dados completos de uma cobrança, incluindo status, dados do cliente, PIX e taxas.

***

## Parâmetros de Path

<ParamField path="chargeId" type="string" required>
  ID da cobrança. Aceita formato `ch_flare_xxx`, UUID completo ou ID parcial
</ParamField>

***

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token de autenticação. Formato: `Bearer sk_live_xxx`
</ParamField>

***

## Exemplo de Requisição

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.flarepayments.com/v1/charges/ch_flare_dc7dc11b7f984d2886d2b429 \
    -H "Authorization: Bearer sk_live_sua_chave_aqui"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://api.flarepayments.com/v1/charges/ch_flare_dc7dc11b7f984d2886d2b429',
    {
      headers: {
        'Authorization': 'Bearer sk_live_sua_chave_aqui'
      }
    }
  );
  const charge = await response.json();
  ```

  ```python Python theme={null}
  import requests

  charge = requests.get(
      'https://api.flarepayments.com/v1/charges/ch_flare_dc7dc11b7f984d2886d2b429',
      headers={'Authorization': 'Bearer sk_live_sua_chave_aqui'}
  ).json()
  ```
</CodeGroup>

***

## Resposta `200 OK`

<ResponseField name="id" type="string">
  ID da cobrança no formato `ch_flare_xxx`
</ResponseField>

<ResponseField name="object" type="string">
  Sempre `"charge"`
</ResponseField>

<ResponseField name="amount" type="float">
  Valor em Reais
</ResponseField>

<ResponseField name="amount_cents" type="integer">
  Valor em centavos
</ResponseField>

<ResponseField name="status" type="string">
  Status: `pending`, `paid`, `expired`, `failed`
</ResponseField>

<ResponseField name="customer" type="object">
  Dados do cliente

  <Expandable title="Propriedades">
    <ResponseField name="customer.name" type="string">
      Nome do cliente
    </ResponseField>

    <ResponseField name="customer.email" type="string">
      E-mail do cliente
    </ResponseField>

    <ResponseField name="customer.document" type="string">
      CPF/CNPJ do cliente
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pix" type="object">
  Dados do PIX

  <Expandable title="Propriedades">
    <ResponseField name="pix.qr_code" type="string">
      QR Code em base64
    </ResponseField>

    <ResponseField name="pix.copy_paste" type="string">
      Código copia-e-cola
    </ResponseField>

    <ResponseField name="pix.payment_link" type="string">
      Link de pagamento
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="fee" type="object">
  Dados da taxa

  <Expandable title="Propriedades">
    <ResponseField name="fee.amount" type="float">
      Valor da taxa
    </ResponseField>

    <ResponseField name="fee.net_amount" type="float">
      Valor líquido após taxa
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "ch_flare_dc7dc11b7f984d2886d2b429",
    "object": "charge",
    "amount": 10.00,
    "amount_cents": 1000,
    "currency": "BRL",
    "method": "pix",
    "status": "paid",
    "description": "Pedido #1234",
    "customer": {
      "name": "João Silva",
      "email": "joao@email.com",
      "document": "12345678900"
    },
    "pix": {
      "qr_code": "...",
      "copy_paste": "00020101021226...",
      "payment_link": "https://..."
    },
    "fee": {
      "amount": 0.50,
      "net_amount": 9.50
    },
    "created_at": "2026-03-05T18:14:48.552Z",
    "paid_at": "2026-03-05T18:16:22.000Z",
    "expires_at": "2026-03-05T19:14:48.549Z",
    "metadata": {},
    "livemode": true
  }
  ```
</ResponseExample>

***

## Erros

| Status | Código             | Descrição                      |
| ------ | ------------------ | ------------------------------ |
| `400`  | `missing_id`       | ID da cobrança não informado   |
| `404`  | `charge_not_found` | Cobrança não encontrada        |
| `401`  | `unauthorized`     | Header `Authorization` ausente |