> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Fatturazione Basata sull'Uso
> Addebita ai clienti in base a ciò che utilizzano effettivamente con misurazioni flessibili e fatturazione automatizzata.
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
La tua applicazione invia eventi quando si verificano azioni fatturabili.
```javascript theme={null}
{
"event_id": "evt_123",
"customer_id": "cus_abc",
"event_name": "api.call",
"metadata": { "endpoint": "/v1/users" }
}
```
I contatori aggregano gli eventi in quantità fatturabili utilizzando l’aggregazione Count, Sum, Max o Last.
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
### Prodotti con Prezzi Basati sull'Uso
Imposta il prezzo per unità e soglie gratuite opzionali:
**Esempio**: 2.500 chiamate - 1.000 gratuite = 1.500 × $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](/features/credit-based-billing) del cliente. I crediti si rinnovano ad ogni ciclo di fatturazione e vengono applicati prima di eventuali costi aggiuntivi.
## Avvio Veloce
Nel tuo cruscotto: **Meters** → **Create Meter**
1. Imposta il nome dell’evento (es. `api.call`)
2. Scegli l’aggregazione (Count, Sum, Max, Last)
3. Aggiungi filtri opzionali
Collega il contatore a un prodotto con prezzi:
1. Seleziona **Usage-Based Billing**
2. Scegli il tuo contatore
3. Imposta il prezzo per unità e la soglia gratuita
```javascript theme={null}
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" }
}]
})
});
```
Controlla il cruscotto del tuo contatore per visualizzare eventi e aggregazione dell’utilizzo. I clienti vengono fatturati automaticamente a ogni ciclo.
## Casi d'Uso
Traccia chiamate API, ore di calcolo, larghezza di banda, archiviazione. Esempio: \$0.001 per chiamata dopo 10.000 gratuite.
Traccia token, generazioni, tempo di elaborazione. Esempio: \$0.04 per immagine standard, \$0.08 per HD.
Fattura in base ai dati elaborati, query eseguite, record analizzati. Esempio: \$5 per GB oltre i 10 GB gratuiti.
Conta messaggi, minuti, dati trasferiti. Esempio: \$0.01 per SMS inviato.
## Prossimi Passi
Scopri come strutturare e inviare eventi di utilizzo dalla tua applicazione.
Padroneggia la configurazione dei contatori, i tipi di aggregazione e il filtraggio degli eventi.
Costruisci da zero un generatore di immagini AI con fatturazione basata sull’utilizzo.
Guida completa all’implementazione della fatturazione basata sull’utilizzo nella tua applicazione.