A Nokr debita do saldo pré-pago do seu cliente. Você decide quanto a Nokr precisa saber para fazer a conta: o valor final da cobrança, ou apenas o evento que aconteceu.
Os dois caminhos convivem no mesmo saldo. O seu produto pode começar por um e adotar o outro sem trocar de conta.
Para quando o preço já é conhecido no seu código. Uma chamada, um valor e o débito no saldo — sem tabela de preço do lado de cá.
A mesma chamada repetida não cobra duas vezes: você envia uma chave única em X-Idempotency-Key e o débito acontece uma só.
Para cobrar por token, GB, minuto ou requisição. Você registra o que aconteceu e a Nokr calcula o preço pela tabela que estiver valendo.
O preço por evento fica na tabela de preço, não no seu deploy.
O caminho do valor tem um passo; o do evento tem dois. A diferença é quem faz a conta — não o que o seu cliente vê no extrato.
Quando quem calcula é a Nokr, o modelo da tabela decide o resultado. A mesma quantidade de uso rende três totais diferentes — e é isso que separa um modelo do outro.
| Modelo | Como o preço é aplicado | Total para 50.000 unidades |
|---|---|---|
| Preço fixo por unidade | Um preço só, do primeiro ao último uso. | R$ 600,00 |
| Faixas progressivas | Cada faixa vale só pela quantidade que cai dentro dela. | R$ 480,00 |
| Preço pela faixa do total | A faixa onde o total cai define o preço de tudo que foi consumido. | R$ 450,00 |
No modelo pela faixa do total, o preço vale para a quantidade deste evento. A Nokr não refaz a fatura dos eventos que já passaram: o que foi cobrado fica cobrado, e o novo preço só alcança o consumo seguinte.
Quatro respostas cobrem a cobrança inteira. Todas chegam com um corpo explicando o motivo, para a sua aplicação decidir sem adivinhar.
| Resposta | O que significa | O que a sua aplicação faz |
|---|---|---|
| 202 | Cobrança aceita e debitada. | Segue o fluxo. Nada a reenviar. |
| 402 | Saldo insuficiente, ou o recurso não está liberado para este cliente. | Para antes de executar e chama a recarga. É o paywall. |
| 403 | A conta está bloqueada. | Interrompe o consumo e fala com a Nokr. |
| 429 | Limite de chamadas da chave foi atingido. | Espera e tenta de novo — a cobrança não passou. |
O 402 é o mesmo nas duas causas: falta de saldo e recurso não liberado. Um mecanismo só, e a sua aplicação já sabe o que fazer com ele.
Em desenvolvimento. Quando a Produção abrir, ela vai exigir CNPJ ativo e aprovação cadastral. Um engenheiro acompanha a integração e responde pelo mesmo canal em que você pergunta.