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 onde o valor aumenta com o uso.

​
Como Funciona

1

Enviar Eventos de Uso

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

Medidores Agregam Uso

Os medidores agregam eventos em quantidades cobradas usando contagem, soma, máximo ou última agregação.
3

Cobrança Automática

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

​
Conceitos Principais

​
Eventos

Eventos representam ações de uso em seu aplicativo. Cada evento inclui:
  • Nome do Evento: Tipo de uso (por exemplo, api.call)
  • ID do Cliente: Quem usou
  • 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

​
Créditos para Clientes

Dê aos clientes créditos de uso incluídos que se renovam a cada ciclo de cobrança. Os créditos se aplicam antes do uso pago.

​
Início Rápido

1

Criar um Medidor

No seu painel: Medidores → Criar Medidor
  1. Defina o nome do evento (por exemplo, api.call)
  2. Escolha a agregação (Contagem, Soma, Máximo, Último)
  3. Adicione filtros opcionais
2

Adicionar ao Produto

Vincule o medidor a um produto com preços:
Adicionando medidor ao produto
  1. Selecione Cobrança Baseada em Uso
  2. Escolha seu medidor
  3. Defina o preço por unidade e o limite gratuito
3

Enviar Eventos

await fetch('https://test.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.DODO_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

Monitorar Uso

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

​
Casos de Uso

APIs & Infraestrutura

Rastreie chamadas de API, horas de computação, largura de banda, armazenamento. Exemplo: $0.001 por chamada após 10.000 gratuitas.

Rastreamento de Uso de IA

Rastreie tokens, gerações, tempo de processamento. Exemplo: $0.04 por imagem padrão, $0.08 por HD.

Dados & Análise

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

Comunicação

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

​
Próximos Passos

Ingestão de Eventos

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

Guia de Medidores

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

Tutorial Completo

Construa um gerador de imagens de IA completo com cobrança baseada em uso do zero.

Guia de Integração

Guia abrangente para implementar cobrança baseada em uso em seu aplicativo.