Conta
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.
Quando usar cada um
| Pergunta | Endpoint |
|---|---|
| Token está válido? | GET /user |
| Qual o nome, documento, plano e limites da conta? | GET /user |
| Saldo disponível agora? | GET /user/balance |
| Tenho saldo pra fazer este saque? | GET /user/balance |
| Quanto está bloqueado em transações pendentes? | GET /user/balance |
Exemplos
Boas práticas
- Não polle saldo em loop: o saldo muda em callbacks. Reaja ao webhook em vez de bater no
GET /user/balancerepetidamente. - 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;blockedestá retido em transações em andamento ou disputas MED. /usermuda raramente: cache de 1 hora ou mais é razoável. Invalide quando suporte alterar limites.