Piani, limiti e fatturazione — le risposte chiare

Un evento di utilizzo è un singolo dato che la tua applicazione invia a MeterFlow — “il cliente user-842 ha generato 1 immagine”, “42 secondi di video renderizzati”. Ogni dato conta una volta, sia che lo invii singolarmente sia in un’unica chiamata batch.

Gli eventi si contano per organizzazione — su tutti i suoi progetti e tutti i tuoi clienti — per ogni mese di calendario (UTC). Le letture non contano mai: controllare un saldo, elencare i piani o leggere un riepilogo è gratis. Nemmeno accreditare o scalare crediti è un evento di utilizzo.

Come un evento diventa un numero nella pagina di utilizzo di un cliente è spiegato nella guida alla dashboard.

Di solito sì — ed è la leva più efficace che hai. Un evento di utilizzo porta con sé una quantità nel campo value, e un meter con aggregazione Sum somma quei valori. Quindi un solo evento con value 1.300 è un evento sul tuo limite mensile e 1.300 unità sul meter.

Lo stile che consuma un piano è un evento per ogni chiamata API: 1.000 utenti che fanno 100 chiamate al giorno sono circa 3 milioni di eventi al mese. Aggrega nella tua applicazione sulla finestra che puoi permetterti di perdere in caso di crash — una richiesta, un job, un minuto — e poi registra un solo evento con il totale.

Attenzione: il batch non è la stessa cosa. Inviare 100 eventi in un’unica chiamata batch risparmia richieste HTTP, ma ogni evento resta un record a sé e continua a contare. Solo unirli in un singolo evento con un value più grande riduce il conteggio.

Due limiti: funziona con i meter Sum, perché i meter Count ignorano il valore e contano le occorrenze; e non cambia nulla di ciò che si paga, dato che un limite di piano “metered” addebita comunque per unità.

Lo sai molto prima che diventi un problema: inviamo un’email al contatto di fatturazione dell’organizzazione all’80 % e di nuovo al 100 % degli eventi inclusi, e la pagina Fatturazione mostra il consumo del mese rispetto al tuo piano.

Superare il 100 % non blocca subito l’invio: un piccolo margine oltre la quantità inclusa lascia passare il traffico di produzione mentre decidi. Oltre quel margine, i nuovi eventi di utilizzo vengono rifiutati con un errore chiaro “Plan limit reached” (HTTP 403) finché non passi a un piano superiore o non inizia il nuovo mese. Nulla viene perso in silenzio e nulla viene addebitato — MeterFlow non fattura mai eccedenze.

Tutto il resto continua a funzionare: gli eventi già registrati, i saldi crediti, gli abbonamenti, la dashboard e ogni endpoint di lettura. Il contatore si azzera all’inizio di ogni mese di calendario (UTC); un upgrade alza il limite immediatamente, e un pacchetto eventi lo alza per il mese in corso.

La tua applicazione riceve il rifiuto come un normale errore API: trattalo come qualsiasi altro 4xx — registralo e non ritentare alla cieca.

No. Ogni piano ha un prezzo mensile fisso con un numero fisso di eventi inclusi. La riga “Prezzo effettivo / 1.000 eventi” nella pagina dei prezzi è semplicemente quel prezzo diviso per gli eventi inclusi — un valore di confronto omogeneo, non una tariffa che applichiamo.

Se ti servono più eventi di quelli inclusi hai due strade, e nessuna è una fattura a consumo: passare al piano superiore, oppure aggiungere un pacchetto eventi — 100.000 eventi extra per 15 $, dalla pagina Fatturazione, fino a dieci alla volta. Un pacchetto copre il mese in cui lo compri (comprandolo negli ultimi cinque giorni del mese copre anche quello successivo) e non si cumula. È volutamente più caro della tariffa effettiva di ogni piano a pagamento: per una crescita costante conviene l’upgrade, il pacchetto è per il picco imprevisto.

Al momento no — ogni piano è fatturato mensilmente. Se la fatturazione annuale è importante per i tuoi acquisti, scrivici a support@meter-flow.com.

Checkout e fatturazione sono gestiti da Paddle, il nostro merchant of record. I prezzi sono in USD; Paddle mostra la tua valuta locale e l’eventuale IVA al checkout, incassa il pagamento (carte, PayPal, Apple Pay, Google Pay) ed emette la fattura. Le aziende possono inserire la partita IVA al checkout.

Sì, in qualsiasi momento. Gli upgrade alzano i limiti immediatamente. Se disdici, il piano resta attivo fino alla fine del periodo pagato. Il primo pagamento è coperto da una garanzia soddisfatti o rimborsati di 14 giorni — vedi la politica di rimborso.

Il downgrade non cancella mai nulla: se la tua organizzazione supera i limiti del piano inferiore, ciò che esiste continua a funzionare; semplicemente non puoi aggiungere altro finché non rientri nei limiti.

Un progetto, quasi sempre. Un progetto è un prodotto o un’app: ha le sue chiavi API, i suoi meter, i suoi piani, i saldi e l’utilizzo dei suoi clienti, e i progetti non vedono mai i dati l’uno dell’altro. Tutti i progetti di un’organizzazione condividono una sola quota di eventi e una sola fattura — ogni piano a pagamento ne include 20.

Un’organizzazione è il confine di fatturazione: il suo piano, la sua quota di eventi, la sua fattura, il suo team. Creane una seconda solo quando ti serve davvero una fatturazione separata o un team separato — due aziende, ad esempio. Ogni organizzazione è fatturata sul proprio piano, e quelle aggiuntive partono gratis su Drip.

Una sola organizzazione, con un progetto per prodotto o cliente. Paghi una volta e la quota di eventi è condivisa tra tutti. Più organizzazioni significa più fatture.

Dai a un cliente la sua organizzazione solo se deve ricevere una fattura propria e gestire un proprio team — quell’organizzazione avrà poi il proprio piano.

No. Gli utenti del team sono i tuoi colleghi nella dashboard — tu più le persone che inviti. I tuoi utenti finali non accedono mai a MeterFlow: esistono solo come ID cliente nel tuo progetto, sono illimitati su ogni piano e non hanno alcun costo per cliente.

No. Il limite sulle organizzazioni conta solo quelle che possiedi. In un’organizzazione in cui sei stato invitato vale il piano del suo proprietario — per tutti i membri.

Sì, e i numeri sono pubblicati: 20 progetti, 75 meter per progetto, 10 chiavi API per progetto e ambiente, 30 endpoint webhook per progetto — uguali su ogni piano a pagamento. Sono soglie di piattaforma dimensionate perché un’integrazione reale non le incontri mai, non leve di upsell: l’upgrade non le sposta. Se la tua integrazione ha davvero bisogno di più, scrivi a support@meter-flow.com.

Il piano gratuito Drip ha limiti più piccoli per la valutazione (2 progetti, 5 meter, 4 chiavi API per ambiente, 3 webhook); lì l’upgrade li alza davvero. Il limite sulle chiavi API resta volutamente contenuto anche a pagamento: ogni chiave attiva è una credenziale con il proprio limite di richieste, quindi è una soglia di sicurezza — revoca le chiavi che non usi più.

L’azione di creazione viene rifiutata con un messaggio che indica il limite — nulla di ciò che esiste già viene toccato. Su Drip il messaggio ti invita all’upgrade, perché i limiti a pagamento sono più alti; su un piano a pagamento ti rimanda all’assistenza, perché l’upgrade non cambierebbe il limite e non vogliamo promettere il contrario.

No — ogni piano include entrambi. Le chiavi di test (mf_test_…) e live (mf_live_…) scrivono su dati completamente isolati: saldi, abbonamenti e utilizzo non si mescolano mai, mentre meter e piani sono configurazione condivisa che definisci una volta sola. Il limite sulle chiavi API vale per ambiente: un progetto ha il numero pieno di chiavi live e il numero pieno di chiavi di test.

Lo storico indica quanto indietro nel tempo il tuo storico di utilizzo resta interrogabile per riepiloghi e analisi — da 45 giorni su Drip a 12 mesi su Torrent. I saldi crediti e il registro delle transazioni non vengono mai cancellati, qualunque sia il piano: ogni accredito, addebito e costo resta registrato.

Community (Drip): la documentazione di questo sito e gli issue tracker dei repository pubblici degli SDK (Node.js, Python) — consultabili sempre, con risposta quando possiamo e senza garanzie. Email (Flow): scrivi a support@meter-flow.com (o usa il modulo di aiuto) e ti risponde una persona. Prioritario (Stream e Torrent): i tuoi messaggi passano avanti nella coda.

Nessun piano include ancora uno SLA contrattuale — non ne stamperemo uno finché non potremo rispettarlo.

Node.js (npm install meterflow, documentazione) e Python (pip install meterflow, documentazione). Entrambi sono completamente tipizzati, hanno una sola dipendenza e coprono le stesse operazioni: crediti, eventi di utilizzo, abbonamenti, piani e verifiche di entitlement, più una vista in sola lettura dei tuoi endpoint webhook e delle loro ricevute di consegna. Qualsiasi altro linguaggio chiama direttamente l'API REST — gli SDK sono sottili involucri sopra di essa, non un insieme di funzioni a parte.

La guida alla dashboard spiega ogni finestra campo per campo con esempi concreti, e il tour della dashboard mostra le schermate. Questa pagina riguarda solo piani e fatturazione.