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

# Saldo da Carteira

> Consulte o saldo disponível da sua carteira, por moeda

Retorna o saldo da carteira da sua conta, separado por moeda, em centavos: o que já está
**disponível** e o que ainda está **pendente** de liberação.

<Note>
  A rota é escopada à sua chave e não recebe parâmetros: devolve **sempre a carteira da sua
  própria conta**. Se a sua conta opera em mais de uma moeda, cada uma aparece como um item
  em `balances`.
</Note>

<Warning>
  **Escopo desta rota.** Ela devolve apenas o saldo. **Saque não é feito por API** e o
  **extrato/conciliação de recebíveis não sai por rota**. A conciliação é entregue por
  arquivo. Para o detalhamento de cada recebível, use o arquivo de conciliação, não esta rota.
</Warning>

## Exemplos de Requisição

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET https://pay.autorizou.dev/api/v1/wallet \
      -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc"
  ```

  ```javascript JavaScript theme={null}
  const wallet = await fetch('https://pay.autorizou.dev/api/v1/wallet', {
    headers: { 'Authorization': 'Bearer 4eC39HqLyjWDarjtT1zdp7dc' }
  }).then(r => r.json());

  const brl = wallet.balances.find(b => b.currency === 'BRL');
  console.log('Disponível (R$):', (brl.available / 100).toFixed(2));
  ```

  ```php PHP theme={null}
  <?php

  $curl = curl_init();
  curl_setopt_array($curl, [
      CURLOPT_URL => 'https://pay.autorizou.dev/api/v1/wallet',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_HTTPHEADER => ['Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc'],
  ]);

  $wallet = json_decode(curl_exec($curl), true);
  $available = $wallet['balances'][0]['available'];
  ?>
  ```
</CodeGroup>

## Resposta

<ResponseField name="balances" type="array">
  Um item por moeda em que a conta tem carteira.

  <Expandable title="propriedades">
    <ResponseField name="currency" type="string">
      Moeda no padrão ISO 4217, ex.: `BRL`.
    </ResponseField>

    <ResponseField name="available" type="integer">
      Saldo disponível **em centavos**. Ex.: `1050` equivale a R\$ 10,50. É o valor já
      liberado, líquido de taxas.
    </ResponseField>

    <ResponseField name="pending" type="integer">
      Saldo pendente **em centavos**: o que ainda vai ser liberado nas datas de recebimento.

      É o **valor líquido projetado**, ou seja, já com as taxas que serão descontadas na
      liberação. Uma venda de R$ 144,00 com taxa de R$ 11,88 aparece aqui como `13212`
      (R\$ 132,12), que é o que efetivamente vai cair na carteira, e não o valor bruto.
    </ResponseField>
  </Expandable>
</ResponseField>

```json Resposta theme={null}
{
  "balances": [
    { "currency": "BRL", "available": 1050, "pending": 13212 }
  ]
}
```

<Note>
  `available` e `pending` são o mesmo par de números que o lojista enxerga no painel, pela
  mesma regra de cálculo. Se divergirem, é bug: reporte.
</Note>

## Erros

| Status | Quando acontece                                                    |
| ------ | ------------------------------------------------------------------ |
| `403`  | Chave de API ausente ou inválida.                                  |
| `401`  | Conta não está aprovada.                                           |
| `503`  | Serviço de carteira temporariamente indisponível. Tente novamente. |