# Conta (/docs/pix-processamento/endpoints/account)



A área **Conta** expõe o titular (perfil, permissões, limites, regras de tarifa) e o saldo. Use para validar token, conferir saldo antes de saque e ler limites operacionais.

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/endpoints/account/get_user" title="Dados da conta" method="GET" path="/user" />

  <QuickLink href="/docs/pix-processamento/endpoints/account/get_user_balance" title="Consultar saldo" method="GET" path="/user/balance" />
</QuickLinks>

## Quando usar cada um [#quando-usar-cada-um]

| Pergunta                                          | Endpoint                                                                          |
| ------------------------------------------------- | --------------------------------------------------------------------------------- |
| Token está válido?                                | [`GET /user`](/docs/pix-processamento/endpoints/account/get_user)                 |
| Qual o nome, documento, plano e limites da conta? | [`GET /user`](/docs/pix-processamento/endpoints/account/get_user)                 |
| Saldo disponível agora?                           | [`GET /user/balance`](/docs/pix-processamento/endpoints/account/get_user_balance) |
| Tenho saldo pra fazer este saque?                 | [`GET /user/balance`](/docs/pix-processamento/endpoints/account/get_user_balance) |
| Quanto está bloqueado em transações pendentes?    | [`GET /user/balance`](/docs/pix-processamento/endpoints/account/get_user_balance) |

## Exemplos [#exemplos]

<Accordions type="single">
  <Accordion title="GET /user/balance, verificar saldo antes de saque">
    ```bash
    curl https://api.payzu.processamento.com/v1/user/balance \
      -H "Authorization: Bearer $PAYZU_TOKEN" \
      -H "Content-Type: application/json"
    ```

    Resposta:

    ```json
    {
      "available": 12450.75,
      "blocked": 230.00,
      "total": 12680.75
    }
    ```
  </Accordion>

  <Accordion title="GET /user, validar token e ler limites">
    ```bash
    curl https://api.payzu.processamento.com/v1/user \
      -H "Authorization: Bearer $PAYZU_TOKEN" \
      -H "Content-Type: application/json"
    ```

    Resposta:

    ```json
    {
      "accountNumber": "513579",
      "name": "PAYZU",
      "role": "USER",
      "balanceAvailable": 231.46,
      "balanceBlocked": 0,
      "status": "ACTIVE",
      "allowWithdraw": true,
      "allowDeposit": true,
      "allowInfraction": true,
      "cashInTicketMin": 1,
      "cashInTicketMax": 50000,
      "cashOutTicketMin": 1,
      "cashOutTicketMax": 100000
    }
    ```
  </Accordion>
</Accordions>

## Boas práticas [#boas-práticas]

* **Não polle saldo em loop**: o saldo muda em callbacks. Reaja ao webhook em vez de bater no `GET /user/balance` repetidamente.
* **Cache curto**: para UI, cachear o saldo por 5 a 10 segundos é suficiente. Invalide ao receber callback de transação concluída ou estornada.
* **Saldo disponível ≠ saldo total**: `available` é o que você pode movimentar agora; `blocked` está retido em transações em andamento ou disputas MED.
* **`/user` muda raramente**: cache de 1 hora ou mais é razoável. Invalide quando suporte alterar limites.

## Próximos passos [#próximos-passos]

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/endpoints/pix-operations" title="Cobranças Pix" />

  <QuickLink href="/docs/pix-processamento/endpoints/withdrawals" title="Saques" />

  <QuickLink href="/docs/pix-processamento/webhooks" title="Webhooks" />

  <QuickLink href="/docs/pix-processamento/glossary" title="Glossário" />
</QuickLinks>