> ## 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.

# Quickstart

> Faça sua primeira cobrança PIX em menos de 5 minutos

## Pré-requisitos

* Uma conta ativa na [Flare Payments](https://flarepayments.com/login)
* Sua API Key (disponível no Dashboard em **Configurações → API Keys**)

***

## Passo 1 — Criar uma Cobrança PIX

Faça um `POST /v1/charges` com o valor em **centavos**:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.flarepayments.com/v1/charges \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "amount": 1000,
      "payment_method": "pix",
      "description": "Pedido #1234",
      "customer": {
        "name": "João Silva",
        "email": "joao@email.com",
        "document": "12345678900"
      }
    }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.flarepayments.com/v1/charges', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      amount: 1000, // R$ 10,00 em centavos
      payment_method: 'pix',
      description: 'Pedido #1234',
      customer: {
        name: 'João Silva',
        email: 'joao@email.com',
        document: '12345678900'
      }
    })
  });

  const charge = await response.json();
  ```

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

  charge = requests.post(
      'https://api.flarepayments.com/v1/charges',
      headers={
          'Authorization': 'Bearer YOUR_API_KEY',
          'Content-Type': 'application/json'
      },
      json={
          'amount': 1000,  # R$ 10,00 em centavos
          'payment_method': 'pix',
          'description': 'Pedido #1234',
          'customer': {
              'name': 'João Silva',
              'email': 'joao@email.com',
              'document': '12345678900'
          }
      }
  ).json()
  ```
</CodeGroup>

<Warning>
  O campo `amount` é sempre em <strong>centavos</strong>. Para cobrar R\$ 10,00, envie `1000`.
</Warning>

**Resposta:**

```json theme={null}
{
  "success": true,
  "uuid": "54e2b712-aca0-4230-b69a-d6dd8542c925",
  "amount": 1000,
  "expires_at": "2026-03-05T19:14:48.549Z",
  "pix_copy_paste": "00020101021226..."
}
```

***

## Passo 2 — Exibir o QR Code para o cliente

Use o campo `pix_copy_paste` para exibir o código PIX copia-e-cola ou gerar o QR Code.

```javascript theme={null}
console.log(charge.pix_copy_paste);
```

***

## Passo 3 — Verificar o Status

Consulte o status da cobrança via polling ou configure um [Webhook](/concepts/webhooks):

```bash theme={null}
curl https://api.flarepayments.com/v1/charges/54e2b712-aca0-4230-b69a-d6dd8542c925/status \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json theme={null}
{
  "uuid": "54e2b712-aca0-4230-b69a-d6dd8542c925",
  "status": "paid",
  "paid": true
}
```

***

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Webhooks" icon="webhook" href="/concepts/webhooks">
    Receba notificações automáticas quando um pagamento for confirmado
  </Card>

  <Card title="Saques" icon="money-bill-transfer" href="/api-reference/withdrawals/create-withdrawal">
    Aprenda a solicitar saques via PIX
  </Card>

  <Card title="UUID da cobrança" icon="shield-check" href="/concepts/idempotency">
    Entenda como a Flare gera a identidade de cada cobrança
  </Card>

  <Card title="Erros" icon="circle-exclamation" href="/concepts/errors">
    Referência completa de códigos de erro
  </Card>
</CardGroup>