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 Nome del Credito - questo è il tuo identificativo 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.

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

​

Unit Name

string

Solo per crediti di Unità Personalizzata. L’etichetta che i clienti vedranno per questo credito (es., “Token AI”, “Chiamate API”). Mostrato in checkout e nel portale clienti.

​

Precision

number

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

• 0 - Numeri interi (ideale per elementi quantificabili come le chiamate API)
• 1 - Una cifra decimale (0,0)
• 2 - Due cifre decimali (0,00) - predefinito
• 3 - Tre cifre decimali (0,000)
• Fino a 10 - Per unità ad alta precisione (ad es. 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:

• Percentuale Massima di Rollover (0–100%) - Limita quanto viene trasferito
• Periodo di Validità del Rollover - Quanto tempo i crediti trasferiti rimangono validi (ad es., 1 Mese)
• Conteggio Massimo di Rollover - Massimo di rollover consecutivi prima che i crediti vengano persi

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:

• Limite di Eccedenza - Massimi crediti che i clienti possono consumare oltre il loro saldo
• Prezzo Per Unità - Costo per credito aggiuntivo quando l’eccedenza è abilitata (con selettore di valuta)

​

Overage Behavior

string

obbligatorio

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

• Perdona l’eccedenza al reset (predefinito) - L’uso oltre il limite di credito è tracciato ma non fatturato. Il saldo si resetta ad ogni ciclo.
• Fattura l’eccedenza alla fatturazione - L’uso oltre il limite di credito è addebitato sulla prossima fattura, poi il saldo si resetta.
• Trasporta il deficit - L’uso oltre il limite di credito viene portato avanti come saldo negativo nel ciclo successivo.
• Trasporta il deficit (ripaga automaticamente) - Il deficit viene portato avanti ed è automaticamente rimborsato con nuovi crediti nel 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 Seleziona metro per aggiungere un metro. Un abbonamento può avere fino a 3 metri.

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

obbligatorio

Il numero di unità che sono gratuite prima che inizi la detrazione 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 ad Uso con Crediti

​

Come Funziona la Detrazione di Crediti Basata su Metro

1. La tua applicazione invia eventi di utilizzo - Ogni evento include un ID cliente, nome dell’evento e metadati
2. I misuratori aggregano gli eventi - Usando Count, Sum, Max, o Last come aggregazione
3. I crediti vengono detratti automaticamente - Un lavoratore in background elabora gli eventi ogni minuto, converte le unità del misuratore in crediti usando il tuo tasso configurato e detrae dal saldo del cliente usando l’ordinamento FIFO (prima i grant più vecchi)
4. L’eccedenza viene monitorata - Se il saldo del credito raggiunge zero e l’eccedenza è abilitata, il sistema monitora l’uso in eccedenza per la fatturazione di fine ciclo

​

Pannello Metri

​

Esperienza del Cliente

​

Checkout

​

Portale del Cliente

• Saldo Disponibile - Saldo attuale di crediti visualizzato in modo prominente
• Schede di Credito - Cambia tra diversi tipi di credito (ad es., “Crediti OpenAI”, “Token di Utilizzo”)
• Transazioni Recenti - Cronologia completa con data, ID transazione, tipo, importo e saldo corrente

​

Dettagli dell’Abbonamento

• Allocazione del credito per ciclo di fatturazione (ad es., “1000 crediti per ciclo”)
• Saldo rimanente (ad es., “7500 crediti rimanenti”)
• Data di rinnovo per la prossima emissione di crediti
• Cronologia dell’uso tab con dettaglio per livello metro che mostra le unità consumate, soglie, prezzi unitari e costi totali

​

Dettagli della Transazione

​

Gestione dei Crediti

​

Visualizzazioni della Dashboard

​

Elenco dei Diritti di Credito

​

Dettagli Crediti Clienti

• Selettore di Credito - Cambia tra diversi diritti di credito
• Saldo Disponibile - Saldo corrente in grande, display prominente
• Applica Credito/Debit - Pulsante per regolare manualmente il saldo del cliente
• Transazioni Recenti - Registro completo con data, ID transazione, tipo, importo e saldo corrente

​

Regolazioni Manuali

​

Registro Crediti

​

Webhooks

​

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

​

Migliori Pratiche

• Inizia semplice: Comincia con un singolo tipo di credito e nessun rollover. Aggiungi complessità basata sul feedback dei clienti e sui modelli di utilizzo.
• Imposta aspettative chiare: Mostra allocazioni di credito, saldi rimanenti e prezzi di eccedenza in modo prominente nelle pagine dei tuoi prodotti e nel portale clienti.
• Usa unità significative: Dai un nome ai crediti basato su ciò che rappresentano (es., “Chiamate API”, “Token AI”) piuttosto che termini generici. Questo aiuta i clienti a capire il valore.
• Configura la scadenza con attenzione: Finestre di scadenza brevi (7 giorni) creano urgenza ma possono frustrare i clienti. Finestre più lunghe (30–90 giorni) sono più adatte ai prodotti SaaS.
• Monitora i saldi bassi: Imposta soglie di saldo basso per avvisare i clienti prima che esauriscano, riducendo i costi di eccedenza a sorpresa.
• Test in modalità di test: Crea crediti, allegali a prodotti di test e simula il ciclo completo (acquisto → uso → detrazione → scadenza) prima di andare live.