Vai al contenuto principale
La fatturazione basata sull’uso ti consente di addebitare ai clienti per ciò che utilizzano effettivamente: chiamate API, archiviazione, token AI o qualsiasi metrica tu definisca. I clienti pagano per il consumo, non per tariffe fisse.
Perfetto per: API, servizi di IA, piattaforme infrastrutturali e qualsiasi prodotto in cui il valore cresce con l’uso.

Come Funziona

1

Send Usage Events

La tua applicazione invia eventi quando si verificano azioni fatturabili.
{
  "event_id": "evt_123",
  "customer_id": "cus_abc",
  "event_name": "api.call",
  "metadata": { "endpoint": "/v1/users" }
}
2

Meters Aggregate Usage

I contatori aggregano gli eventi in quantità fatturabili utilizzando l’aggregazione Count, Sum, Max o Last.
3

Automatic Billing

Imposta il prezzo per unità e le soglie gratuite. I clienti vengono fatturati automaticamente a ogni ciclo.

Concetti Fondamentali

Eventi

Gli eventi rappresentano azioni di utilizzo nella tua applicazione. Ogni evento include:
  • Nome evento: tipo di utilizzo (es. api.call)
  • ID cliente: chi lo ha utilizzato
  • Metadati: proprietà aggiuntive per l’aggregazione

Misuratori

I misuratori aggregano eventi in quantità fatturabili:
  • Conteggio: Totale eventi (chiamate API)
  • Somma: Aggiungi valori (byte totali)
  • Massimo: Valore più alto (utenti di picco)
  • Ultimo: Valore più recente
Interfaccia di creazione del contatore

Prodotti con Prezzi Basati sull’Uso

Imposta il prezzo per unità e soglie gratuite opzionali:
Configurazione dei prezzi
Esempio: 2.500 chiamate - 1.000 gratuite = 1.500 × 0.02=0.02 = 30.00

Deduzione basata su crediti

Anziché addebitare in dollari per unità, puoi configurare i contatori in modo che detraiano dal saldo crediti del cliente. I crediti si rinnovano ad ogni ciclo di fatturazione e vengono applicati prima di eventuali costi aggiuntivi.

Avvio Veloce

1

Create a Meter

Nel tuo cruscotto: MetersCreate Meter
  1. Imposta il nome dell’evento (es. api.call)
  2. Scegli l’aggregazione (Count, Sum, Max, Last)
  3. Aggiungi filtri opzionali
2

Add to Product

Collega il contatore a un prodotto con prezzi:
Aggiunta del contatore al prodotto
  1. Seleziona Usage-Based Billing
  2. Scegli il tuo contatore
  3. Imposta il prezzo per unità e la soglia gratuita
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

Cruscotto del contatore
Controlla il cruscotto del tuo contatore per visualizzare eventi e aggregazione dell’utilizzo. I clienti vengono fatturati automaticamente a ogni ciclo.

Casi d’Uso

APIs & Infrastructure

Traccia chiamate API, ore di calcolo, larghezza di banda, archiviazione. Esempio: $0.001 per chiamata dopo 10.000 gratuite.

AI Usage Tracking

Traccia token, generazioni, tempo di elaborazione. Esempio: $0.04 per immagine standard, $0.08 per HD.

Data & Analytics

Fattura in base ai dati elaborati, query eseguite, record analizzati. Esempio: $5 per GB oltre i 10 GB gratuiti.

Communication

Conta messaggi, minuti, dati trasferiti. Esempio: $0.01 per SMS inviato.

Prossimi Passi

Event Ingestion

Scopri come strutturare e inviare eventi di utilizzo dalla tua applicazione.

Meters Guide

Padroneggia la configurazione dei contatori, i tipi di aggregazione e il filtraggio degli eventi.

Complete Tutorial

Costruisci da zero un generatore di immagini AI con fatturazione basata sull’utilizzo.

Integration Guide

Guida completa all’implementazione della fatturazione basata sull’utilizzo nella tua applicazione.
Last modified on March 3, 2026