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

# Cobrança

> Como as chamadas consomem do seu saldo.

A API é pay-per-use, consumindo do saldo da conta dona do crachá. O saldo é em
**coins** (`1 coin = R$ 1,00`).

## Taxa flat + pass-through

Toda chamada tem até dois componentes de custo:

<Steps>
  <Step title="Taxa flat de plataforma">
    Um valor pequeno por request, debitado da conta. **Só chamada com API key
    paga** — chamada com JWT de sessão (o app) não.
  </Step>

  <Step title="Pass-through (quando aplicável)">
    Se a chamada aciona um provedor externo (transcrição, IA, YouTube), o custo
    real também é debitado — do **dono do recurso**. Leituras simples vêm do
    banco e não têm pass-through.
  </Step>
</Steps>

## Taxa flat por rota

| Rota                                                                                               | Taxa         |
| -------------------------------------------------------------------------------------------------- | ------------ |
| Maioria das leituras (`accounts/me`, `items`, `collections`, `reporters`, `videos`, `discover`, …) | `0,001 coin` |
| `GET /search`                                                                                      | `0,005 coin` |
| `GET /items/{id}/transcript`                                                                       | `0,005 coin` |
| `POST /items` · `POST /collections/{id}/items`                                                     | `0,005 coin` |
| `POST /items/{id}/transcript` (roda o transcriber)                                                 | `0,01 coin`  |

<Note>
  A taxa é debitada **depois** da resposta, best-effort — falha de cobrança nunca
  derruba a chamada. Os preços podem mudar conforme a plataforma evolui.
</Note>

## Saldo insuficiente

Antes de processar uma chamada com API key, a API checa o saldo. Zero ou
negativo → a chamada é rejeitada na entrada:

```json theme={null}
// HTTP 402 Payment Required
{ "erro": "saldo insuficiente — adicione coins na conta" }
```

Um job longo também pode falhar no meio com `402` se uma chamada de pass-through
deixaria o dono do recurso negativo.

## Recarga via Pix

Coins são comprados com **Pix** (`1 coin = R$ 1,00`):

<Steps>
  <Step title="Crie a cobrança">
    `POST /v1/accounts/me/deposit/pix` com `{ amount_coins, cpf }` → devolve o QR
    Code (base64) e o copia-e-cola. Mínimo de **5 coins**.

    ```json theme={null}
    {
      "deposit_id": "…",
      "status": "pending",
      "amount_coins": 50,
      "fee_brl": 1.99,
      "pix": { "qr_code_base64": "iVBORw0KGgo…", "copia_e_cola": "00020101…" }
    }
    ```
  </Step>

  <Step title="Pague">
    Pague o Pix no app do banco. (InfinitePay também está disponível, sem taxa,
    via `POST /v1/accounts/me/deposit/infinitepay`, que devolve um link de
    checkout.)
  </Step>

  <Step title="Crédito automático">
    Na confirmação, o provedor avisa a API e os coins são creditados — você recebe
    um evento `deposit_credited` em tempo real.
  </Step>
</Steps>

## Acompanhar consumo & sacar

* Saldo: `GET /v1/accounts/me`.
* Extrato: `GET /v1/accounts/me/transactions` (filtra por `kind`, `ref_type`).
* Sacar o pool depositado de volta pra BRL: `POST /v1/accounts/me/withdraw`
  (crédito de bônus não é sacável).