Skip to main content
Status HTTP: 402

​
O que significa

O workspace não tem saldo de tokens suficiente para cobrir o custo da requisição. Nada foi cobrado e nada será executado (a resposta 402 não retorna um id). A resposta inclui os campos extras required (tokens necessários) e balance (saldo atual). Tokens são debitados na criação (POST /analyses ou POST /operations). No Motor de CPF/CNPJ, required é o custo da análise; no Motor de Borderô, as entidades únicas do arquivo (cedente + sacados únicos) vezes o preço unitário. No CPF/CNPJ, o valor efetivamente cobrado vem no campo tokens_charged da resposta de sucesso; no borderô, a cobrança não aparece no payload — acompanhe pelo extrato de tokens do workspace no app. O preço está em definição durante o beta.

​
Causas comuns

  • Saldo do workspace esgotado ou abaixo do custo da requisição.
  • Volume de análises maior que o previsto no consumo de tokens do workspace.
  • Borderô com mais sacados únicos (e portanto mais entidades cobradas) do que o previsto.

​
Como corrigir

  • Compare required e balance no body do erro para saber quanto falta.
  • Recarregue o saldo no app Sherlocker. A API /v1 usa o mesmo pool de tokens do workspace no app.
  • Depois da recarga, reenvie a requisição com uma nova Idempotency-Key. A tentativa que recebeu 402 não criou nada nem cobrou tokens; reutilizar a mesma key pode retornar 409 idempotency_conflict.

​
Exemplo

Os valores de tokens acima são ilustrativos. No Motor de CPF/CNPJ, o custo real por análise é retornado em tokens_charged na resposta de criação; no Motor de Borderô, consulte o extrato de tokens do workspace no app.

​
Campos extras

​
Relacionado