Cobrança por uso (usage-based billing, ou pay-as-you-go) é cobrar o cliente pelo que ele consumiu no período: chamadas de API, mensagens enviadas, créditos de IA, SMS, GB armazenados. Quase sempre o consumo vem somado a um plano fixo. No Brasil, a forma automática de fazer isso hoje é no cartão recorrente: na AbacatePay, o Pix Automático não aceita cobrança por uso.
Produto: gateway de pagamento para SaaS · assinaturas.
Cobrança por uso x assinatura fixa
Na assinatura fixa, o cliente paga o mesmo valor todo ciclo, use muito ou pouco. Na cobrança por uso, a fatura acompanha o consumo. A mecânica de renovar sozinho é a mesma do pagamento recorrente; o que muda é o valor de cada cobrança.
| Assinatura fixa | Cobrança por uso | |
|---|---|---|
| Valor do ciclo | Igual todo mês | Varia com o consumo |
| Previsibilidade da sua receita | Alta | Menor (parte variável) |
| Barreira de entrada para o cliente | Paga o plano inteiro desde o início | Começa pagando pouco e cresce com o uso |
| Risco de churn | Cliente que usa pouco sente que paga caro | Cliente que leva susto na fatura cancela |
| Bom para | Software com valor estável (CRM, ERP, área de membros) | API, IA, mensageria, infraestrutura |
Muita empresa fica no meio: plano fixo com uma franquia e cobrança do excedente.
Modelos de cobrança por uso
| Modelo | Como funciona | Quando usar |
|---|---|---|
| Por unidade | Preço fixo por unidade consumida (por chamada, por mensagem) | Consumo fácil de contar e preço simples de explicar |
| Escalonado | O preço da unidade cai por faixa de volume | Clientes grandes que pedem desconto por volume |
| Pré-pago (créditos) | O cliente compra um pacote de créditos e vai gastando | Quer receber antes e tirar o risco de inadimplência |
| Híbrido (plano + excedente) | Plano fixo com franquia; o que passa da franquia é cobrado por unidade | SaaS que quer piso de receita e potencial de crescer com o cliente |
No modelo escalonado, deixe a tabela de faixas na página de preços. O cliente precisa conseguir prever a própria fatura.
Como medir o consumo
A cobrança por uso é tão boa quanto a medição. O básico:
- Registre o evento no seu backend. Cada chamada, mensagem ou crédito gasto vira um registro com cliente, quantidade e horário.
- Garanta idempotência. Um retry do seu sistema não pode contar o mesmo consumo duas vezes. Use um ID único por evento e ignore duplicados.
- Agregue por ciclo. Você pode mandar cada evento para o gateway ou somar no seu lado e registrar em lotes (por hora, por dia).
- Tenha como estornar. Consumo registrado errado (bug, teste, cortesia) precisa ser desfeito antes da cobrança.
- Mostre o consumo ao cliente. Um painel com o uso do mês evita ticket de suporte e contestação.
Como cobrar por uso no Brasil: cartão ou Pix?
Cartão recorrente: o cartão fica salvo na contratação, e a cada ciclo a cobrança sai com o valor do plano mais o uso registrado. É o meio que aceita cobrança variável sem o cliente fazer nada.
Pix Automático: o cliente autoriza uma vez no app do banco, e o valor da cobrança fica fixo na autorização. Por isso a AbacatePay não aceita registro de uso em assinatura no Pix Automático: a API devolve o erro Usage records are not supported on Pix Automático subscriptions.
Quem quer vender no Pix pode usar o modelo pré-pago: vende pacotes de créditos com cobrança Pix avulsa (pela API Pix) e desconta o consumo no seu sistema. O cliente recarrega quando os créditos acabam.
| Cartão recorrente | Pix Automático | Pix avulso (créditos) | |
|---|---|---|---|
| Plano fixo | Sim | Sim | Não se aplica |
| Uso somado na cobrança | Sim | Não | Não se aplica |
| Quem soma o consumo | A AbacatePay, na cobrança do ciclo | Não se aplica | Seu sistema, descontando dos créditos |
Como fazer na AbacatePay
A cobrança por uso funciona pela API de assinaturas. No dashboard não há essa opção. O fluxo, segundo a documentação:
- Crie o plano: um produto com
cycle(semanal, mensal, trimestral, semestral ou anual) e o preço fixo. - Crie o produto da unidade de uso sem
cycle, com o preço de cada unidade. Produto com ciclo é recusado no registro de uso. - A cada consumo, registre o uso em
POST /v2/subscriptions/record-usage(Registrar uso):
{
"id": "subs_abc123xyz",
"productId": "prod_api_calls",
"units": 50,
"action": "add"
}- Para estornar unidades registradas no mesmo ciclo, mande o mesmo corpo com
"action": "subtract". - Na próxima cobrança, a AbacatePay soma o uso ao valor do plano.
A resposta traz installmentNumber (em qual cobrança o uso vai entrar) e unitPrice (o preço da unidade no momento do registro). O uso só pode ser registrado em assinatura ativa, e a chave precisa da permissão SUBSCRIPTION:CREATE.
Exemplo da própria documentação: plano de R$ 49,90 com 120 unidades de R$ 0,10 gera uma cobrança de R$ 61,90. A cobrança nunca fica abaixo de R$ 1,00.
Para o seu sistema acompanhar o resultado, ouça os webhooks subscription.renewed (cobrança paga) e subscription.payment_failed (tentativa recusada). Se o cartão recusar, a retentativa de cobrança segue a retryPolicy do checkout: maxRetry de 1 a 10 tentativas (padrão 3, contando a primeira) e retryEvery de 1 a 30 dias (padrão 1). Conceito e segurança dos eventos: o que é webhook de pagamento. Mais ferramentas: desenvolvedores e AI agents.
Quanto custa cobrar por uso
A cobrança por uso não tem taxa própria. Cada cobrança da assinatura paga a taxa do meio de pagamento:
- Cartão recorrente (ativado sob consulta): A taxa depende do prazo de recebimento que você escolhe na dashboard (D+1, D+7, D+15 ou D+30) e do número de parcelas: quanto mais longo o prazo, menor a taxa. No crédito à vista, vai de 5,42% + R$ 0,60 em D+1 a 3,5% + R$ 0,60 em D+30. O cartão começa em D+1 quando é ativado. Na assinatura vale a linha do crédito à vista, porque a assinatura no cartão não parcela.
- Pix Automático: R$ 0,80 por cobrança confirmada, para a parte fixa do plano (sem uso somado).
- Pix avulso dos pacotes de créditos: R$ 0,80 por cobrança.
Tabela completa: /pricing.
Como evitar susto na fatura
O maior risco da cobrança por uso é o cliente abrir a fatura e não reconhecer o valor. Quatro cuidados:
- Teto de gasto: deixe o cliente definir um limite e pause o serviço (ou peça confirmação) quando chegar nele.
- Alerta de consumo: avise por e-mail ou no app quando o uso passar de 50%, 80% e 100% da franquia.
- Plano mínimo: um valor fixo baixo dá piso de receita e deixa claro que a conta começa ali.
- Fatura explicada: mostre plano, unidades e preço da unidade separados.
O mesmo vale para a virada do teste grátis: o cliente precisa saber quanto vai pagar na primeira cobrança. Veja como montar essa entrada em free trial com ou sem cartão.
Mudança de plano também precisa de clareza: na AbacatePay, a troca fica pendente e vale a partir da próxima cobrança do ciclo, sem cobrança proporcional do ciclo atual (Alterar plano).
Métricas: MRR com parte variável
Com cobrança por uso, separe o MRR em duas linhas: a parte fixa (planos ativos) e a parte variável (uso médio dos últimos ciclos). A fixa mostra a base; a variável mostra se os clientes estão usando mais o produto. Conta e exemplos em o que é MRR.
Acompanhe também a receita líquida por cliente ao longo do tempo: em cobrança por uso, ela cresce quando o cliente usa mais, sem precisar de upgrade. Para mostrar o MRR com fonte na conta de pagamento, use o Trust MRR. Se o produto é enxuto e você opera sozinho, veja o recorte de micro-SaaS.
Checklist completo do gateway: gateway de pagamento para SaaS.
Perguntas frequentes
O que é usage-based billing?
É o nome em inglês da cobrança por uso: o cliente paga pelo que consumiu no período (chamadas, mensagens, créditos, armazenamento), normalmente somado a um plano fixo.
Qual a diferença entre cobrança por uso e assinatura?
Na assinatura fixa, o valor é o mesmo todo ciclo. Na cobrança por uso, o valor acompanha o consumo. As duas podem andar juntas: plano fixo mais o excedente, cobrado na mesma renovação.
Dá para cobrar por uso no Pix Automático?
Não. Na AbacatePay, o registro de uso é recusado em assinatura no Pix Automático, porque o valor fica fixo na autorização do cliente. A cobrança por uso é no cartão recorrente. Quem quer Pix pode vender créditos pré-pagos com cobrança Pix avulsa.
Como estornar um uso registrado errado?
Registre as mesmas unidades com action: "subtract" no mesmo ciclo. O valor estornado sai da próxima cobrança.
Dá para combinar cobrança por uso com teste grátis?
Os dois recursos são do cartão recorrente: o teste grátis existe só no cartão, e a assinatura fica ativa durante o teste. Antes de lançar a combinação, teste no Modo Teste como o uso entra na primeira cobrança depois do teste. Como montar a entrada: free trial com ou sem cartão.
Como calcular o MRR quando parte da receita é variável?
Some os planos ativos (parte fixa) e use a média de uso dos últimos ciclos para a parte variável. Mostre as duas separadas. Detalhes em o que é MRR.
Leia também: free trial com ou sem cartão · gateway de pagamento para SaaS · pagamento recorrente · retentativa de cobrança · o que é MRR · Pix Automático · assinaturas