Trasforma eventi di utilizzo grezzi in quantità fatturabili con aggregazione e filtraggio.
I meter convertono gli eventi grezzi in quantità fatturabili. Filtrano gli eventi e applicano funzioni di aggregazione (Count, Sum, Max, Last) per calcolare l’utilizzo per cliente.
L’etichetta dell’unità per fatture e report. Esempi: calls, tokens, GB, hours.
3
Filtering (Optional)
Aggiungi condizioni per filtrare quali eventi vengono conteggiati:
Logica AND: Tutte le condizioni devono corrispondere
Logica OR: Qualsiasi condizione può corrispondere
Comparatori disponibili: uguale, diverso, maggiore di, maggiore o uguale a, minore di, minore o uguale a, contiene, non contiene.Abilita il filtraggio, scegli la logica, quindi aggiungi condizioni con una chiave della proprietà, un comparatore e un valore.
4
Create
Verifica la configurazione e fai clic su Crea meter.
Per impostazione predefinita, i meter addebitano ai clienti un importo per unità in dollari (o nella valuta configurata). In alternativa, puoi configurare un meter affinché detragga dal saldo dei crediti del cliente, in modo che l’utilizzo consumi crediti invece di generare un addebito monetario.
La detrazione basata sui crediti richiede un Credit Entitlement associato allo stesso prodotto. Crea prima il credit entitlement, quindi collegalo al meter.
Per prima cosa, crea un credit entitlement in Products → Credits. Definisci l’unità (ad es. “Chiamate API”, “Token”), la precisione e le impostazioni del ciclo di vita (scadenza, riporto, eccedenza).Consulta la Guida alla fatturazione basata sui crediti per istruzioni dettagliate.
2
Create or Edit a Usage-Based Product
Vai al tuo prodotto basato sull’utilizzo e apri la sezione di configurazione del Contatore.
3
Add a Meter
Fai clic sul pulsante + per collegare un contatore. Configura il nome dell’evento, il tipo di aggregazione e l’unità di misura come sempre.
4
Enable 'Bill Usage in Credits'
Attiva Bill usage in Credits nella configurazione del meter per visualizzare le impostazioni dei crediti:
Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.
Il numero di unità di utilizzo necessario per dedurre 1 credito. Ad esempio:
1 = ogni evento del contatore deduce 1 credito
100 = 100 eventi del contatore deducono 1 credito
1000 = 1.000 chiamate API consumano 1 credito
5
Free Threshold and Credits
La Free Threshold si applica ai meter fatturati in denaro, non ai meter fatturati in crediti. Quando un meter fattura in crediti, ogni unità contribuisce alla detrazione dei crediti.Esempio: con un rapporto di 1 unità del meter per credito, a un cliente che effettua 2.500 chiamate API vengono detratti 2.500 crediti.
Una volta configurata, la pipeline di deduzione viene eseguita automaticamente:
Arrivano gli eventi — La tua applicazione invia gli eventi di utilizzo tramite Event Ingestion API.
Il meter aggrega — Gli eventi vengono aggregati in base alla configurazione del meter (Count, Sum, Max, Last).
Il worker in background elabora — Ogni minuto, un worker recupera i nuovi eventi dall’ultimo checkpoint.
I crediti vengono detratti — L’utilizzo aggregato viene convertito in crediti utilizzando il tasso meter_units_per_credit e detratto secondo l’ordine FIFO (vengono utilizzate per prime le concessioni con scadenza più vicina).
L’eccedenza viene registrata — Se il saldo raggiunge zero, l’utilizzo successivo viene registrato come eccedenza e gestito in base al comportamento configurato (condonato al reset, fatturato alla fattura successiva o riportato come deficit). Dodo Payments non blocca l’utilizzo quando il saldo si esaurisce. Per interrompere l’accesso a saldo zero, verifica il saldo nella tua applicazione.
La detrazione dei crediti viene eseguita in modo asincrono (ogni ~1 minuto). Potrebbe verificarsi un breve ritardo tra l’acquisizione dell’evento e la detrazione dal saldo. Progetta la tua applicazione per gestire questo ritardo e non fare affidamento sui controlli del saldo in tempo reale per il controllo dell’accesso alle singole richieste.
Puoi collegare più meter dello stesso prodotto allo stesso credit entitlement. Tutti i meter detraggono da un unico saldo condiviso.Esempio: una piattaforma AI con due meter:
text.generation — 1 credito ogni 1.000 token
image.generation — 10 crediti per immagine
Entrambi deducono dallo stesso pool “AI Credits”. Il cliente vede un unico saldo unificato nel portale.
Usa tassi meter_units_per_credit differenti tra i contatori per esprimere costi relativi. Le operazioni costose (generazione di immagini) richiedono meno unità del contatore per credito rispetto a quelle economiche (completamento di testo).
List Customer Ledger
Visualizza l’intera cronologia di deduzione dei crediti per un cliente.
Get Customer Balance
Controlla il saldo di crediti attuale di un cliente tramite API.
