Fatturazione Basata sui Crediti

​

Che cos’è la Fatturazione Basata su Crediti?

• Piattaforme AI e LLM: Concedi token o crediti di generazione per livello di piano
• Servizi API: Allocca crediti di chiamata API con prezzi di eccedenza
• Piattaforme di infrastruttura: Emetti ore di calcolo o crediti di archiviazione
• Servizi di comunicazione: Fornisci crediti di messaggio o minuti per abbonamento
• SaaS con livelli di consumo: Includi il consumo incluso in pool di crediti

​

Concetti di Base

​

Tipi di Credito

​

Ciclo di Vita dei Crediti

​

Fonti di Concessione

​

Creazione di Crediti

1

Navigate to Credits

Vai a Prodotti nella tua dashboard e seleziona la scheda Crediti. Fai clic su Crea Credito per iniziare.

2

Configure Basic Information

Inserisci un Credit Name—questo è il tuo identificatore interno per il credito.

3

Set General Settings

Configura il tipo di credito e le proprietà di visualizzazione:

​

Credit Type

string

obbligatorio

Scegli Unità personalizzata o Crediti Fiat.

• Custom Unit: definisci la tua metrica (token, chiamate API, ore di calcolo). Richiede un Unit Name (ad esempio, “Platform tokens”) e un’impostazione Precision.
• Fiat Credits: i crediti rappresentano un valore monetario reale. Richiede la selezione di una Unit Currency (USD, EUR, GBP, INR, ecc.).

​

Unit Name

string

Solo per i crediti Custom Unit. L’etichetta visualizzata dai clienti per questo credito (ad esempio, “AI Tokens” o “API Calls”). Viene mostrata nel checkout e nel customer portal.

​

Precision

number

Solo per i crediti delle unità personalizzate. Numero di cifre decimali consentite, da 0 a 10:

• 0: numeri interi (ideale per elementi conteggiabili come le chiamate API)
• 1: una cifra decimale (0.0)
• 2: due cifre decimali (0.00)—impostazione predefinita
• 3: tre cifre decimali (0.000)
• Fino a 10: per unità ad alta precisione (ad esempio, token frazionari o micro-utilizzo)

La precisione non può essere modificata dopo la creazione del credito.

​

Credit Expiry

string

Quanto a lungo i crediti rimangono validi dopo l’emissione:

• 7 giorni, 30 giorni (predefinito), 60 giorni, 90 giorni, Personalizzato, o Mai

Seleziona Personalizzato per specificare un numero personalizzato di giorni (minimo 1).

4

Configure Subscription Settings (Optional)

Queste impostazioni controllano il comportamento dei crediti negli abbonamenti ricorrenti:

​

Rollover

boolean

Permetti ai crediti non utilizzati di essere trasferiti al ciclo di fatturazione successivo. Quando abilitato, configuralo:

• Max Rollover Percentage (0–100%): limita la quantità riportabile
• Rollover Timeframe: per quanto tempo rimangono validi i crediti riportati (ad esempio, 1 Month)
• Max Rollover Count: numero massimo di riporti consecutivi prima della perdita dei crediti

Quando i Crediti Terminano o l’Abbonamento Scade:

​

Allow Overage

boolean

Permetti ai clienti di continuare a utilizzare il tuo servizio dopo che il loro saldo di crediti raggiunge zero. Quando abilitato, configuralo:

• Overage Limit: numero massimo di crediti che i clienti possono consumare oltre il saldo
• Price Per Unit: costo per ogni credito aggiuntivo quando l’overage è abilitato (con selettore della valuta)

​

Overage Behavior

string

obbligatorio

Controlla come viene gestita l’eccedenza alla fine del ciclo di fatturazione:

• Forgive overage at reset (impostazione predefinita): l’utilizzo oltre il limite di credito viene tracciato ma non fatturato. Il saldo viene azzerato a ogni ciclo.
• Bill overage at billing: l’utilizzo oltre il limite di credito viene addebitato nella fattura successiva, quindi il saldo viene azzerato.
• Carry over deficit: l’utilizzo oltre il limite di credito viene riportato al ciclo successivo come saldo negativo.
• Carry over deficit (auto-repay): il deficit viene riportato e rimborsato automaticamente mediante i nuovi crediti del ciclo successivo.

5

Create Credit

Fai clic su Crea Credito per salvare. Il credito è ora disponibile per essere allegato a qualsiasi prodotto.

Il tuo diritto di credito è pronto. Allega ai prodotti per iniziare a emettere crediti ai clienti.

​

Allegare Crediti ai Prodotti

​

Prodotti in Abbonamento

1

Create or Edit a Subscription Product

Vai a Prodotti → Crea Prodotto o modifica un prodotto esistente. Seleziona Abbonamento come tipo di prezzo e configura il tuo prezzo ricorrente.

2

Open Entitlements Section

Espandi la sezione Diritti e fai clic sul pulsante Allegare accanto a Crediti.

3

Select Credits to Attach

Si apre un pannello Aggiungi Crediti. Puoi selezionare un credito esistente dal menu a discesa o fare clic su Crea nuovo credito per definirne uno sul posto.

Puoi allegare fino a 5 crediti per prodotto. Ogni credito può avere la propria configurazione.

4

Configure Credit Settings

Configura per ciascun credito allegato:

​

Credits issued per billing cycle

number

obbligatorio

Il numero di crediti concessi al cliente ogni periodo di fatturazione.

​

Low Balance Threshold

number

Notifica quando i crediti scendono al di sotto di questa quantità. Utile per avvisare i clienti prima che esauriscano.

​

Credits During Free Trial

number

Imposta una differente quantità di credito per i periodi di prova. Abilita Scadenza dei crediti di prova al termine della prova per revocare i crediti di prova non utilizzati quando la prova si converte in un abbonamento a pagamento.

​

Allow Proration

boolean

Proteggi i crediti rimanenti quando un cliente aggiorna o degrada il suo piano di abbonamento.

​

Import Default Credit Settings

boolean

Usa le impostazioni predefinite di rollover, eccedenza e scadenza dal diritto di credito. Disattiva questa opzione per personalizzare le impostazioni specificamente per questo prodotto.

5

Review and Add

Rivedi il credito allegato che mostra nome, quantità e scadenza. Fai clic su Aggiungi all’Abbonamento per confermare.

​

Prodotti a Pagamento Unico

1

Create a One-Time Product

Crea un prodotto con il tipo di prezzo Pagamento Singolo.

2

Attach Credits

Apri la sezione Diritti e allega i crediti. Configura il numero di crediti emessi (concessione totale una tantum) all’acquisto.

​

Prodotti con Fatturazione Basata sull’Uso

1

Create a Usage-Based Product

Seleziona Fatturazione Basata sull’Uso come tipo di prezzo. Configura il prezzo base e la frequenza di fatturazione.

2

Add a Meter

Fai clic sul pulsante + nella sezione Select meter per aggiungere un meter. Un abbonamento può avere fino a 50 meters.

3

Enable Credit Billing on the Meter

Attiva Fattura l’uso in Crediti per allegare un credito al metro. Seleziona il diritto di credito dal menu a discesa.

​

Free Threshold

number

Si applica solo quando il meter effettua la fatturazione in denaro. Quando il meter fattura in crediti, ogni unità viene detratta dal saldo dei crediti.

​

Bill usage in Credits

boolean

Quando abilitato, l’uso del metro detrae dal saldo dei crediti del cliente invece di addebitare per unità.

​

Meter units per credit

number

obbligatorio

Il numero di unità di uso necessarie per detrarre 1 credito. Ad esempio, se impostato su 1000, allora 1.000 chiamate API consumano 1 credito.

4

Configure Credit Issuance

Imposta il numero di crediti emessi e personalizza opzionalmente le impostazioni del credito per questo prodotto.

5

Verify Attachment

Una volta configurato, il metro mostra il nome del credito allegato, il prezzo per unità e la soglia gratuita.

​

Impostazioni del Credito

​

Rollover

​

Eccedenza

​

Scadenza

​

Fatturazione basata sull’utilizzo con i crediti

​

Come funziona la detrazione dei crediti basata sui meter

1. La tua applicazione invia eventi di utilizzo: ogni evento include un ID cliente, il nome dell’evento e i metadati
2. I meter aggregano gli eventi: utilizzando l’aggregazione Count, Sum, Max o Last
3. I crediti vengono detratti automaticamente: un worker in background elabora gli eventi ogni minuto, converte le unità del meter in crediti utilizzando il tasso configurato e detrae l’importo dal saldo del cliente secondo l’ordine FIFO (prima le assegnazioni con scadenza più imminente)
4. L’overage viene tracciato: se il saldo dei crediti raggiunge zero e l’overage è abilitato, il sistema traccia l’utilizzo in overage per la fatturazione a fine ciclo

​

Pannello Meters

​

Esperienza del cliente

​

Checkout

​

Customer Portal

• Available Balance: saldo corrente dei crediti visualizzato in evidenza
• Credit Tabs: consente di passare da un tipo di credito all’altro (ad esempio, “OpenAI Credits” o “Usage Tokens”)
• Recent Transactions: cronologia completa con data, ID transazione, tipo, importo e saldo progressivo

​

Dettagli dell’abbonamento

• Credit allocation per ciclo di fatturazione (ad esempio, “1000 credits each cycle”)
• Remaining balance (ad esempio, “7500 credits remaining”)
• Renewal date per la prossima emissione di crediti
• Scheda Usage History con suddivisione a livello di meter che mostra unità consumate, soglie, prezzi unitari e costi totali

​

Dettagli della transazione

​

Gestione dei crediti

​

Visualizzazioni della dashboard

​

Elenco degli entitlements di credito

​

Dettagli dei crediti del cliente

• Credit Selector - consente di passare da un entitlement di credito all’altro
• Available Balance - saldo corrente visualizzato in modo ampio e in evidenza
• Apply Credit/Debit - pulsante per modificare manualmente il saldo del cliente
• Recent Transactions - registro completo con data, ID transazione, tipo, importo e saldo progressivo

​

Modifiche manuali

​

Registro dei crediti

​

Webhook

​

Gestione tramite API

​

Esempio di integrazione

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode', // defaults to 'live_mode'
});

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_ai_pro_plan',
      quantity: 1,
    }
  ],
  customer: { email: 'customer@example.com' },
  return_url: 'https://yourapp.com/success'
});

await client.usageEvents.ingest({
  events: [{
    event_id: `gen_${Date.now()}`,
    customer_id: 'cus_abc123',
    event_name: 'ai.generation',
    timestamp: new Date().toISOString(),
    metadata: { model: 'gpt-4', tokens: 1500 }
  }]
});

​

Esempi reali

​

Best practice

• Inizia in modo semplice: comincia con un singolo tipo di credito e senza rollover. Aggiungi complessità in base al feedback dei clienti e ai modelli di utilizzo.
• Definisci aspettative chiare: mostra in evidenza nelle pagine del prodotto e nel customer portal le assegnazioni di crediti, i saldi rimanenti e i prezzi dell’overage.
• Usa unità significative: assegna ai crediti il nome di ciò che rappresentano (ad esempio, “API Calls” o “AI Tokens”) anziché termini generici. Questo aiuta i clienti a comprenderne il valore.
• Configura attentamente la scadenza: finestre di scadenza brevi (7 giorni) favoriscono l’urgenza, ma possono frustrare i clienti. Finestre più lunghe (30–90 giorni) sono più adatte ai clienti per la maggior parte dei prodotti SaaS.
• Monitora i saldi bassi: imposta soglie di saldo basso per avvisare i clienti prima che i crediti si esauriscano, riducendo gli addebiti imprevisti per overage.
• Esegui i test in test mode: crea crediti, associali a prodotti di test e simula l’intero ciclo acquisto → utilizzo → detrazione → scadenza prima di andare in produzione.