Sfoglia la documentazione
Plans & credits

Crediti e misurazione

Come funziona il registro dei crediti, le due salvaguardie che bloccano un superamento, e perché la tua data di rinnovo non è il primo del mese.

BoostEcom è una quota mensile fissa che include crediti. Non c'è una fattura a token da decifrare a fine mese.

Gli importi per livello vivono in Piani e limiti — deliberatamente in un unico posto, così che non possano mai contraddirsi a vicenda.

Il registro

I crediti sono un registro a sola aggiunta, non un contatore che viene sovrascritto. Ogni concessione e ogni consumo è una riga. Il tuo saldo è la somma, il che significa:

  • La cronologia è verificabile: puoi sempre vedere cosa ha consumato cosa.
  • Un bug può aggiungere una riga di correzione, mai riscrivere il passato in silenzio.
  • GET /api/usage legge il registro in tempo reale, non una cifra in cache.

Margine

L'uso del modello viene fatturato a 1,5× il costo del provider sottostante sui livelli a pagamento, e a 1,0× su Custom. Quel moltiplicatore è il margine ed è dichiarato invece di essere nascosto dentro un'unità "credito" opaca.

Le due salvaguardie

Entrambe sono rigide, ed entrambe si applicano a ogni piano e ogni livello di autonomia:

1. Stima prima dello streaming. Prima che una richiesta giri, ne viene stimato il costo. Se la stima supera il tuo saldo, la richiesta viene rifiutata con 402 e nulla viene trasmesso. Non ti viene mai addebitata una richiesta che comunque avrebbe esaurito il saldo.

2. Tetto rigido a metà streaming. Una generazione lunga viene misurata mentre gira. Nel momento in cui il costo in corso raggiunge il tuo saldo, lo streaming viene interrotto. Una richiesta non può mai sforare in un saldo negativo.

Il rinnovo è il tuo anniversario, non il 1°

I crediti mensili si azzerano nel giorno di ancoraggio del tuo abbonamento, il giorno del mese in cui ti sei abbonato, non il primo. Uno store abbonato il 18 si rinnova il 18.

Il cron giornaliero scorre le organizzazioni il cui giorno di ancoraggio è oggi. Ogni concessione è idempotente: il cron, il webhook subscription.created e la rete di sicurezza invoice.paid scrivono tutti attraverso la stessa chiave, quindi tre percorsi verso i crediti dello stesso mese li concedono comunque una sola volta.

Bonus giornaliero

I livelli a pagamento accumulano un piccolo bonus giornaliero oltre all'assegnazione mensile. È per organizzazione, e scade a mezzanotte UTC senza accumularsi. Gli importi sono in Piani e limiti.

Tasse

Stripe Tax è attivo al checkout (IVA UE e sales tax USA). Quando acquisti crediti, la concessione legge l'importo al netto delle tasse. Non ti vengono mai accreditati crediti per la tassa che hai pagato, né sei mai penalizzato per essa.

Leggere il tuo utilizzo

| Superficie | Cosa offre | |---|---| | GET /api/usage | Il registro in tempo reale della tua organizzazione. | | /<org>/~/billing | Stato dell'abbonamento, fatture, piano. | | /<org>/~/billing/activate | Dopo il checkout: lo stato reale di ogni webhook prima di restituire il controllo. |

Quest'ultimo vale la pena conoscerlo. Dopo un checkout, mostra se il pagamento, l'abbonamento, il cambio di piano e la concessione di crediti sono ciascuno effettivamente andati a buon fine, invece di far girare un timer sperando.

Hai costruito con queste docs?

Passa dal forum se qualcosa non è chiaro o è sbagliato. La documentazione migliora più in fretta quando chi legge segnala le lacune.

Apri il forum