> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Uso e créditos

Limites medidos, crédito pré-pago e a superfície de faturação.

## Lê o estado de uso

GET /api/mobile/usage devolve o orçamento de IA como strings decimais em microunidades — budgetMicrounits, committedMicrounits, heldMicrounits e keyMode — o saldo de crédito pré-pago, linhas por medidor com label, used, limit, cap, planLimit e description, e os limites do período atual. A apresentação marca um medidor como aviso aos oitenta por cento e como perigo aos cem.

Os valores são strings decimais, não números JSON — faz parse antes de comparar ou formatar para que orçamentos grandes se mantenham exatos.


## Livro-razão de crédito pré-pago

GET /api/mobile/credits devolve o saldo pré-pago do workspace e as suas últimas cinquenta linhas de livro-razão. O saldo alimenta Configurações → Faturação e o cartão de uso do ecrã inicial; os ids de referência do livro-razão ficam de fora do payload do cliente.


## Superfícies de home e faturação

O ecrã inicial reutiliza GET /api/workspace/metrics — a mesma grelha de estatísticas que o dashboard web renderiza: gasto mensal de IA, contagens de tarefas e threads, membros, convites pendentes, estado do plano e notificações por ler. O seu cartão de uso mostra a linha de IA mais os medidores de limite finito, e os tiles de ação rápida ligam a chat, assistente, conteúdo, comércio, notificações, feedback e configurações.

Configurações → Faturação mostra o plano, a expiração, o saldo de crédito e os medidores de uso, explica a diferença entre faturação de loja e de web e liga ao paywall. Uma schedule do servidor varre os workspaces a cada quinze minutos e notifica owners e admins uma vez por mês aos oitenta e cem por cento do orçamento de IA.


## Verificação e resolução de problemas

Verifica um medidor perto do limite, um saldo de crédito esgotado e um workspace no orçamento predefinido. Uma ação bloqueada tem de apontar para o medidor que a negou, não para um erro genérico.

[Compra e restauro nativos](https://supastack.dev/pt/docs/mobile/revenuecat.md)


## Seguinte

[Gestão de conteúdo](https://supastack.dev/pt/docs/mobile/content.md)
