Explorar a documentação
Plans & credits

Créditos e medição

Como funciona o ledger de créditos, as duas salvaguardas que impedem um excedente, e por que sua data de renovação não é o dia 1 do mês.

BoostEcom é uma mensalidade fixa que inclui créditos. Não há fatura por token para decifrar no fim do mês.

Os valores por nível ficam em Planos e limites: deliberadamente em um único lugar, para que não possam divergir entre si.

O ledger

Créditos são um ledger apenas de inserção, não um contador que é sobrescrito. Toda concessão e todo consumo é uma linha. Seu saldo é a soma, o que significa:

  • O histórico é auditável: você sempre pode ver o que consumiu o quê.
  • Um bug pode adicionar uma linha corretiva, nunca reescrever o passado silenciosamente.
  • GET /api/usage lê o ledger ao vivo, não um número em cache.

Markup

O uso de modelo é cobrado a 1,5× o custo do provedor subjacente nos níveis pagos, e a 1,0× no Custom. Esse multiplicador é a margem, e é declarado em vez de escondido dentro de uma unidade de "crédito" opaca.

As duas salvaguardas

Ambas são rígidas, e ambas se aplicam em todo plano e todo nível de autonomia:

1. Estimativa pré-transmissão. Antes de uma requisição rodar, seu custo é estimado. Se a estimativa exceder seu saldo, a requisição é recusada com 402 e nada é transmitido. Você nunca é cobrado por uma requisição que sempre iria estourar.

2. Teto rígido no meio da transmissão. Uma geração longa é medida enquanto roda. No momento em que o custo corrente atinge seu saldo, a transmissão é abortada. Uma requisição não pode ultrapassar para um saldo negativo.

A renovação é seu aniversário, não o dia 1

Os créditos mensais são renovados no dia âncora da sua assinatura, o dia do mês em que você assinou, não no dia 1. Uma loja que assinou no dia 18 renova no dia 18.

O cron diário percorre organizações cujo dia âncora é hoje. Toda concessão é idempotente: o cron, o webhook subscription.created e o backstop invoice.paid escrevem todos pela mesma chave, então três caminhos para os créditos do mesmo mês ainda assim os concedem apenas uma vez.

Bônus diário

Níveis pagos acumulam um pequeno bônus diário sobre a franquia mensal. É por organização, e expira à meia-noite UTC e não se acumula. Os valores estão em Planos e limites.

Impostos

O Stripe Tax está ativo no checkout (VAT da UE e sales tax dos EUA). Quando você compra créditos, a concessão lê o valor antes de impostos. Você nunca recebe créditos pelo imposto que pagou, e nunca é prejudicado por ele também.

Lendo seu uso

| Superfície | O que entrega | |---|---| | GET /api/usage | O ledger ao vivo da sua organização. | | /<org>/~/billing | Estado da assinatura, faturas, plano. | | /<org>/~/billing/activate | Pós-checkout: o estado real de cada webhook antes de devolver o controle. |

Essa última vale a pena conhecer. Depois de um checkout, ela mostra se o pagamento, a assinatura, a mudança de plano e a concessão de créditos de fato aconteceram, em vez de girar um cronômetro na esperança.

Construiu com estas docs?

Passe pelo fórum se algo não estiver claro ou estiver errado. A documentação melhora mais depressa quando quem lê assinala as lacunas.

Abrir o fórum