Transforme eventos de uso brutos em quantidades faturáveis com agregação e filtragem.
Os medidores convertem eventos brutos em quantidades faturáveis. Eles filtram eventos e aplicam funções de agregação (Count, Sum, Max, Last) para calcular o uso por cliente.
O rótulo da unidade para faturas e relatórios. Exemplos: calls, tokens, GB, hours.
3
Filtering (Optional)
Adicione condições para filtrar quais eventos são contados:
Lógica AND: Todas as condições devem corresponder
Lógica OR: Qualquer condição pode corresponder
Comparadores disponíveis: igual a, diferente de, maior que, maior ou igual a, menor que, menor ou igual a, contém, não contém.Ative a filtragem, escolha sua lógica e adicione condições com uma chave de propriedade, um comparador e um valor.
Por padrão, os medidores cobram dos clientes por unidade em dólares (ou na moeda configurada). Em vez disso, você pode configurar um medidor para deduzir o uso do saldo de créditos de um cliente, fazendo com que o uso consuma créditos em vez de gerar uma cobrança monetária.
A dedução baseada em créditos exige um Credit Entitlement associado ao mesmo produto. Crie primeiro o credit entitlement e, em seguida, vincule-o ao medidor.
Primeiro, crie um credit entitlement em Products → Credits. Defina a unidade (por exemplo, “API Calls”, “Tokens”), a precisão e as configurações do ciclo de vida (expiração, rollover, excedente).Consulte o guia de Faturamento Baseado em Créditos para obter instruções detalhadas.
2
Create or Edit a Usage-Based Product
Acesse seu produto baseado em uso e abra a seção de configuração do Meter.
3
Add a Meter
Clique no botão + para anexar um medidor. Configure o nome do evento, o tipo de agregação e a unidade de medição como de costume.
4
Enable 'Bill Usage in Credits'
Ative Bill usage in Credits na configuração do medidor para revelar as configurações de créditos:
Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.
O número de unidades de uso necessárias para deduzir 1 crédito. Por exemplo:
1 = cada evento do medidor deduz 1 crédito
100 = 100 eventos do medidor deduzem 1 crédito
1000 = 1.000 chamadas de API consomem 1 crédito
5
Free Threshold and Credits
O Free Threshold se aplica a medidores cobrados em dinheiro, não a medidores cobrados em créditos. Quando um medidor cobra em créditos, cada unidade conta para a dedução de créditos.Exemplo: Com meter-units-per-credit igual a 1, um cliente que faça 2.500 chamadas de API terá 2.500 créditos deduzidos.
Uma vez configurado, o pipeline de dedução é executado automaticamente:
Eventos chegam — Seu aplicativo envia eventos de uso por meio da Event Ingestion API.
O medidor agrega — Os eventos são agregados de acordo com a configuração do seu medidor (Count, Sum, Max, Last).
O worker em segundo plano processa — A cada minuto, um worker busca novos eventos desde o último checkpoint.
Os créditos são deduzidos — O uso agregado é convertido em créditos usando a taxa meter_units_per_credit e deduzido usando a ordenação FIFO (as concessões que expiram primeiro são consumidas primeiro).
O excedente é rastreado — Se o saldo chegar a zero, o uso adicional será registrado como excedente e tratado de acordo com o comportamento configurado (perdoado na redefinição, cobrado na próxima fatura ou transferido como déficit). Dodo Payments não bloqueia o uso quando o saldo se esgota. Para interromper o acesso quando o saldo chegar a zero, verifique o saldo no seu aplicativo.
A dedução de créditos é executada de forma assíncrona (aproximadamente a cada 1 minuto). Pode haver um breve atraso entre a ingestão do evento e a dedução do saldo. Projete seu aplicativo para lidar com esse atraso e não dependa de verificações de saldo em tempo real para controlar o acesso em solicitações individuais.
Você pode vincular vários medidores no mesmo produto ao mesmo credit entitlement. Todos os medidores fazem deduções de um saldo compartilhado.Exemplo: uma plataforma de IA com dois medidores:
text.generation — 1 crédito por 1.000 tokens
image.generation — 10 créditos por imagem
Ambos deduzem do mesmo pool “AI Credits”. O cliente vê um único saldo unificado em seu portal.
Use diferentes taxas meter_units_per_credit entre os medidores para expressar custos relativos. Operações caras (geração de imagens) exigem menos unidades de medidor por crédito do que operações baratas (completação de texto).
List Customer Ledger
Veja o histórico completo de dedução de créditos de um cliente.
Get Customer Balance
Verifique o saldo atual de créditos de um cliente via API.
