Skip to main content
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:
1

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.
2

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.

​
Taxa flat por rota

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.

​
Saldo insuficiente

Antes de processar uma chamada com API key, a API checa o saldo. Zero ou negativo → a chamada é rejeitada na entrada:
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):
1

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.
2

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.)
3

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.

​
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).