Fatturazione Basata sui Crediti

​

Cos’è la Fatturazione Basata sui Crediti?

• Piattaforme AI e LLM: assegna token o crediti di generazione per ogni fascia di piano
• Servizi API: alloca crediti per chiamate API con prezzi di overage
• Piattaforme infrastrutturali: emetti ore di calcolo o crediti di storage
• Servizi di comunicazione: fornisci crediti per messaggi o minuti per ogni abbonamento
• SaaS con fasce di consumo: raggruppa l’utilizzo incluso in pool di crediti

​

Concetti chiave

​

Tipi di credito

​

Ciclo di vita dei crediti

​

Fonti di assegnazione

​

Creazione dei crediti

1

Navigate to Credits

Vai su Prodotti nella tua dashboard e seleziona la scheda Crediti. Clicca su Crea credito per iniziare.

2

Configure Basic Information

Inserisci un Nome del credito — è 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 in valuta fiat.

• Unità personalizzata - Definisci la tua metrica (token, chiamate API, ore di calcolo). Richiede un Nome unità (es. “Token della piattaforma”) e una impostazione di Precisione.
• Crediti in valuta fiat - I crediti rappresentano un valore monetario reale. Richiede la selezione di una Valuta dell’unità (USD, EUR, GBP, INR, ecc.).

​

Unit Name

string

Solo per crediti a unità personalizzata. L’etichetta che i clienti vedono per questo credito (es. “Token AI”, “Chiamate API”). Visualizzata nel checkout e nel portale cliente.

​

Precision

number

Solo per crediti a unità personalizzata. Numero di decimali consentiti:

• 0 - Numeri interi (ideale per elementi numerabili come chiamate API)
• 1 - Un decimale (0,0)
• 2 - Due decimali (0,00) - predefinito
• 3 - Tre decimali (0,000)

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

​

Credit Expiry

string

Per quanto tempo i crediti restano validi dopo l’emissione:

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

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

4

Configure Subscription Settings (Optional)

Queste impostazioni controllano il comportamento dei crediti all’interno degli abbonamenti ricorrenti:

​

Rollover

boolean

Consenti ai crediti inutilizzati di essere trasferiti al ciclo successivo. Quando abilitato, configura:

• Percentuale massima di rollover (0–100%) - Limita quanto può essere trasferito
• Intervallo temporale di rollover - Quanto tempo rimangono validi i crediti trasferiti (es. 1 mese)
• Numero massimo di rollover - Numero massimo di rollover consecutivi prima che i crediti vengano annullati

Quando i crediti terminano o l’abbonamento scade:

​

Allow Overage

boolean

Consenti ai clienti di continuare a usare il servizio dopo che il saldo dei crediti è arrivato a zero. Quando abilitato, configura:

• Limite di overage - Massimo di crediti che i clienti possono consumare oltre il saldo
• Prezzo per unità - Costo per credito aggiuntivo quando l’overage è attivo (con selezione della valuta)

​

Overage Behavior

string

obbligatorio

Controlla come gestire l’overage alla fine del ciclo di fatturazione:

• Annulla l’overage al reset (predefinito) - L’utilizzo oltre il limite di credito viene tracciato ma non fatturato. Il saldo si azzera ogni ciclo.
• Addebita l’overage alla fatturazione - L’utilizzo oltre il limite viene addebitato nella prossima fattura, poi il saldo si azzera.
• Riporta il deficit - L’utilizzo oltre il limite viene riportato come saldo negativo nel ciclo successivo.
• Riporta il deficit (auto-ristoro) - Il deficit viene riportato e rimborsato automaticamente dai nuovi crediti nel ciclo successivo.

5

Create Credit

Clicca Crea credito per salvare. Il credito è ora disponibile per essere associato a qualsiasi prodotto.

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

​

Associare i crediti ai prodotti

​

Prodotti in abbonamento

1

Create or Edit a Subscription Product

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

2

Open Entitlements Section

Espandi la sezione Diritti e clicca il pulsante Associa accanto a Crediti.

3

Select Credits to Attach

Si apre un pannello Aggiungi crediti. Puoi selezionare un credito esistente dal menu a discesa o cliccare Crea nuovo credito per definirne uno in quel momento.

Puoi associare fino a 3 crediti per prodotto. Ogni credito può avere la propria configurazione.

4

Configure Credit Settings

Per ogni credito associato, configura:

​

Credits issued per billing cycle

number

obbligatorio

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

​

Low Balance Threshold

number

Notifica quando i crediti scendono al di sotto di questa soglia. Utile per avvisare i clienti prima che finiscano.

​

Credits During Free Trial

number

Imposta un importo diverso di crediti per i periodi di prova. Abilita Scadono i crediti di prova dopo la fine della prova per revocare i crediti inutilizzati quando la prova diventa un abbonamento a pagamento.

​

Allow Proration

boolean

Prorata i crediti rimanenti quando un cliente effettua un upgrade o downgrade del piano di abbonamento.

​

Import Default Credit Settings

boolean

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

5

Review and Add

Rivedi il credito associato mostrando nome, quantità e scadenza. Clicca Aggiungi all’abbonamento per confermare.

​

Prodotti a pagamento singolo

1

Create a One-Time Product

Crea un prodotto con tipo di prezzo Pagamento singolo.

2

Attach Credits

Apri la sezione Diritti e associa i crediti. Configura il numero di crediti emessi (concessione unica totale) al momento dell’acquisto.

​

Prodotti a fatturazione basata sull’utilizzo

1

Create a Usage-Based Product

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

2

Add a Meter

Clicca il pulsante + nella sezione Seleziona misuratore per aggiungere un misuratore. Un abbonamento può avere fino a 3 misuratori.

3

Enable Credit Billing on the Meter

Attiva Fattura l’utilizzo in crediti per associare un credito al misuratore. Seleziona il diritto di credito dal menu a discesa.

​

Free Threshold

number

obbligatorio

Il numero di unità gratuite prima dell’inizio della deduzione dei crediti.

​

Bill usage in Credits

boolean

Quando abilitato, l’utilizzo del misuratore viene detratto dal saldo crediti del cliente invece di essere addebitato per unità.

​

Meter units per credit

number

obbligatorio

Il numero di unità di utilizzo 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, facoltativamente, personalizza le impostazioni del credito per questo prodotto.

5

Verify Attachment

Una volta configurato, il misuratore mostra il nome del credito allegato, il prezzo unitario e la soglia gratuita.

​

Impostazioni dei crediti

​

Rollover

​

Overage

​

Scadenza

​

Fatturazione basata sull’utilizzo con i crediti

​

Come funziona la deduzione dei crediti basata sui misuratori

1. La tua applicazione invia eventi di utilizzo - Ogni evento include un ID cliente, il nome dell’evento e i metadati
2. I misuratori aggregano gli eventi - Utilizzando aggregazioni Count, Sum, Max, Last o Unique Count
3. I crediti vengono detratti automaticamente - Un worker in background elabora gli eventi ogni minuto, converte le unità del misuratore in crediti utilizzando la tariffa configurata e detrae dal saldo del cliente seguendo l’ordine FIFO (prima concessione più vecchia)
4. L’overage viene tracciato - Se il saldo dei crediti arriva a zero e l’overage è abilitato, il sistema registra l’overage per la fatturazione a fine ciclo

​

Pannello dei misuratori

​

Esperienza cliente

​

Checkout

​

Portale cliente

• Saldo disponibile - Saldo attuale dei crediti mostrato in modo prominente
• Schede dei crediti - Passa tra diversi tipi di credito (es. “Crediti OpenAI”, “Token d’utilizzo”)
• Transazioni recenti - Cronologia completa con data, ID transazione, tipo, importo e saldo progressivo

​

Dettagli dell’abbonamento

• Allocazione di crediti per ciclo di fatturazione (es. “1000 crediti ogni ciclo”)
• Saldo rimanente (es. “7500 crediti rimanenti”)
• Data di rinnovo per la prossima emissione di crediti
• Scheda Cronologia utilizzo con suddivisione a livello di misuratore che mostra unità consumate, soglie, prezzi unitari e costi totali

​

Dettagli delle transazioni

​

Gestione dei crediti

​

Visualizzazioni della dashboard

​

Elenco dei diritti di credito

​

Dettagli dei crediti del cliente

• Selettore di credito - Passa tra diversi diritti di credito
• Saldo disponibile - Saldo attuale in un display grande e prominente
• Applica credito/debito - Pulsante per regolare manualmente il saldo del cliente
• Transazioni recenti - Registro completo con data, ID transazione, tipo, importo e saldo progressivo

​

Regolazioni manuali

​

Registro dei crediti

​

Webhook

​

Gestione 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: 'prod_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 semplice: parti con un unico tipo di credito e nessun rollover. Aggiungi complessità in base al feedback dei clienti e ai modelli di utilizzo.
• Imposta aspettative chiare: mostra l’allocazione dei crediti, i saldi rimanenti e i prezzi dell’overage in modo evidente nelle pagine prodotto e nel portale cliente.
• Usa unità significative: assegna ai crediti nomi che descrivono ciò che rappresentano (es. “Chiamate API”, “Token AI”) invece di termini generici. Aiuta i clienti a percepire il valore.
• Configura la scadenza con attenzione: finestre di scadenza brevi (7 giorni) generano urgenza ma possono infastidire i clienti. Finestre più lunghe (30–90 giorni) sono più customer-friendly per la maggior parte dei prodotti SaaS.
• Monitora i saldi bassi: imposta soglie di saldo basso per avvisare i clienti prima che finiscano, riducendo sorprese da addebiti di overage.
• Testa in modalità di prova: crea crediti, associane di test ai prodotti e simula l’intero flusso acquisto → utilizzo → detrazione → scadenza prima di andare in produzione.

​

Best Practices

• Start simple: Begin with a single credit type and no rollover. Add complexity based on customer feedback and usage patterns.
• Set clear expectations: Display credit allocations, remaining balances, and overage pricing prominently in your product pages and customer portal.
• Use meaningful units: Name credits after what they represent (e.g., “API Calls”, “AI Tokens”) rather than generic terms. This helps customers understand value.
• Configure expiry thoughtfully: Short expiry windows (7 days) drive urgency but may frustrate customers. Longer windows (30–90 days) are more customer-friendly for most SaaS products.
• Monitor low balances: Set low balance thresholds to alert customers before they run out, reducing surprise overage charges.
• Test in test mode: Create credits, attach them to test products, and simulate the full purchase → usage → deduction → expiration cycle before going live.