Pular para o conteúdo principal
A cobrança baseada em uso permite que você cobre os clientes pelo que eles realmente utilizam—chamadas de API, armazenamento, tokens de IA ou qualquer métrica que você definir. Os clientes pagam pelo consumo, não por taxas fixas.
Perfeito para: APIs, serviços de IA, plataformas de infraestrutura e qualquer produto cujo valor escala com o uso.

​
Como Funciona

1

Send Usage Events

Seu aplicativo envia eventos quando ações faturáveis ocorrem.
{
  "event_id": "evt_123",
  "customer_id": "cus_abc",
  "event_name": "api.call",
  "metadata": { "endpoint": "/v1/users" }
}
2

Meters Aggregate Usage

Os medidores agregam eventos em quantidades faturáveis usando agregação Count, Sum, Max ou Last.
3

Automatic Billing

Defina o preço por unidade e limites gratuitos. Os clientes são cobrados automaticamente a cada ciclo.

​
Conceitos Principais

​
Eventos

Os eventos representam ações de uso no seu aplicativo. Cada evento inclui:
  • Nome do Evento: Tipo de uso (por exemplo, api.call)
  • ID do Cliente: Quem o utilizou
  • Metadados: Propriedades adicionais para agregação

​
Medidores

Os medidores agregam eventos em quantidades cobradas:
  • Contagem: Total de eventos (chamadas de API)
  • Soma: Adicionar valores (total de bytes)
  • Máximo: Maior valor (usuários de pico)
  • Último: Valor mais recente
Interface de criação de medidor

​
Produtos com Preços Baseados em Uso

Defina preços por unidade e limites gratuitos opcionais:
Configuração de preços
Exemplo: 2.500 chamadas - 1.000 gratuitas = 1.500 × 0.02=0.02 = 30.00

​
Dedução Baseada em Créditos

Em vez de cobrar por unidade em dólares, você pode configurar medidores para deduzirem do saldo de créditos do cliente. Os créditos são renovados a cada ciclo de cobrança e são aplicados antes de quaisquer cobranças por excedentes.

​
Início Rápido

1

Create a Meter

No seu painel: Meters → Create Meter
  1. Defina o nome do evento (por exemplo, api.call)
  2. Escolha a agregação (Count, Sum, Max, Last)
  3. Adicione filtros opcionais
2

Add to Product

Vincule o medidor a um produto com precificação:
Adicionando medidor ao produto
  1. Selecione Usage-Based Billing
  2. Escolha seu medidor
  3. Defina o preço por unidade e o limite gratuito
3

Send Events

await fetch('https://test.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.DODO_PAYMENTS_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    events: [{
      event_id: "unique_event_id",
      customer_id: "cus_abc123",
      event_name: "api.call",
      metadata: { endpoint: "/v1/users" }
    }]
  })
});
4

Monitor Usage

Painel do medidor
Verifique o painel do seu medidor para ver os eventos e a agregação de uso. Os clientes são cobrados automaticamente a cada ciclo.

​
Casos de Uso

APIs & Infrastructure

Acompanhe chamadas de API, horas de computação, largura de banda e armazenamento. Exemplo: $0,001 por chamada após 10.000 gratuitas.

AI Usage Tracking

Acompanhe tokens, gerações, tempo de processamento. Exemplo: $0,04 por imagem padrão, $0,08 por HD.

Data & Analytics

Cobre por dados processados, consultas executadas, registros analisados. Exemplo: $5 por GB após 10 GB gratuitos.

Communication

Conte mensagens, minutos, dados transferidos. Exemplo: $0,01 por SMS enviado.

​
Próximos Passos

Event Ingestion

Aprenda como estruturar e enviar eventos de uso do seu aplicativo.

Meters Guide

Domine a configuração de medidores, tipos de agregação e filtragem de eventos.

Complete Tutorial

Crie um gerador de imagens com IA completo com faturamento baseado em uso do zero.

Integration Guide

Guia abrangente para implementar faturamento baseado em uso no seu aplicativo.