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.

Una richiesta ritentata non viene mai rifiutata per gli eventi che ha già registrato: un batch reinviato con le stesse chiavi di idempotenza risponde con gli eventi che aveva creato, anche al limite. E quando la tua organizzazione raggiunge un limite, la sua pagina Billing lo indica sul tuo piano e, se ce n’è uno, segnala il piano adatto al tuo utilizzo.

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.

No. Gli eventi inviati con una chiave di test (mf_test_…) hanno una propria quota mensile, un decimo di quella del piano: 5.000 su Drip, 20.000 su Flow, 70.000 su Stream e 400.000 su Torrent. Non contano mai negli eventi live del piano, e un pacchetto di eventi aumenta solo la quota live. Oltre la quota di test (più lo stesso piccolo margine concesso al traffico live), i nuovi eventi di test vengono rifiutati con un errore che la nomina.

Le chiavi di test sono anche limitate a 60 richieste al minuto (chiavi live: 300), e i dati di test scadono: gli eventi di utilizzo di test vengono cancellati dopo 30 giorni, e un abbonamento di test senza utilizzo da 90 giorni viene cancellato insieme al suo saldo e registro di test. Nessuna delle due regole tocca i dati live.

La pagina Billing e la finestra Usage della tua organizzazione mostrano gli eventi di test del mese rispetto alla loro quota, accanto a quelli live.

Lo storico indica per quanto tempo i tuoi eventi di utilizzo live vengono conservati — da 45 giorni su Drip a 12 mesi su Torrent. Gli eventi più vecchi vengono cancellati, quindi riepiloghi e analisi arrivano fin lì; esportali prima se vuoi conservarli più a lungo. I saldi crediti e il registro delle transazioni live non vengono cancellati con loro, qualunque sia il piano: ogni accredito, addebito e costo resta registrato. I dati di test hanno una scadenza propria, più breve — vedi la domanda precedente.

Community (Drip): la documentazione di questo sito, il forum della community (GitHub Discussions, per entrambi gli SDK) 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 — il pacchetto Node.js non ha dipendenze a runtime, quello Python dipende solo da httpx — 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.

Sì. MeterFlow ospita una pagina che mostra a uno dei tuoi clienti il suo saldo crediti, i movimenti recenti e il piano su cui si trova, con quanto resta di ogni allowance a consumo — con il tuo nome, il tuo logo e i tuoi colori. Il tuo server crea un link con portal.createSession() (in Python create_session()) e ci manda il cliente; non c’è nessuna pagina da costruire o ospitare.

Un link dura un’ora salvo diversa scelta, al massimo un giorno, ed è in sola lettura. Un pulsante Buy more può aprire la tua pagina di pagamento: MeterFlow non incassa mai il pagamento — quando il tuo checkout lo segnala, il tuo server accredita i crediti. Come si incastra il tutto è spiegato nella guida alla dashboard.

Puoi portarli via in qualsiasi momento. Un owner o admin dell’organizzazione può scaricare eventi di utilizzo, registro crediti, abbonamenti e prenotazioni di crediti di qualsiasi progetto in CSV o JSON Lines, un ambiente (live o test) per file — da Esporta dati nella tabella Progetti della dashboard, o dall’API (GET /api/v1/projects/{project_id}/export/{dataset}).

Ogni riga è scritta esattamente come l’API restituisce quel record, e una tabella grande si scarica in una sola richiesta.

Entrambe le cose si fanno dalla dashboard. Per eliminare un’organizzazione, il suo owner sceglie Elimina su di essa nella Dashboard: i suoi progetti vengono disattivati subito, e l’organizzazione con tutto ciò che contiene viene eliminata trascorsi 30 giorni. Un piano a pagamento va prima annullato dalla sua pagina Billing.

Per chiudere il tuo account, apri il tuo profilo (la tua immagine, in alto a destra), scegli Elimina account e inserisci la password. Elimina prima le organizzazioni di cui sei owner; il tuo account viene poi eliminato trascorsi 30 giorni. Fino ad allora puoi accedere e annullare l’una o l’altra cosa. Non riesci ad accedere? Scrivi a support@meter-flow.com.

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.