La sfida

Langfuse doveva conciliare il suo impegno open-source con un modello di business cloud sostenibile. Dato che chiunque può ospitare autonomamente il software in modo gratuito, l'offerta cloud doveva avere un prezzo competitivo, essere facile da comprendere e allineata al valore fornito ai clienti. Langfuse aveva iniziato con un sistema di addebito interno basato su una semplice tariffa fissa per evento, ma questa soluzione non garantiva la flessibilità dei prezzi né tracciabilità accurata dei consumi necessaria all'azienda per crescere.

Con la crescita di Langfuse, era chiaro che all'azienda servissero tariffe progressive per evento e piani mensili a più livelli, in modo che i prezzi crescessero proporzionalmente all'utilizzo e riflettessero gli sconti per volumi elevati. I clienti vanno da account che elaborano 100.000 eventi al mese fino a centinaia di milioni, e ciascun evento comporta costi marginali per Langfuse. L'azienda desiderava implementare sconti automatici per volume, così che i prezzi si adattassero all'aumento dell'attività senza necessità di negoziazioni personalizzate.

Il team ha dovuto affrontare anche diversi casi limite legati all'addebito. A volte la procedura di pagamento mostrava 0 USD perché l'utilizzo veniva addebitato successivamente, generando confusione tra i clienti. Le versioni di prova per i clienti enterprise richiedevano l'inserimento anticipato dei dati di pagamento, ma il flusso di checkout standard non lo prevedeva. Le modifiche ai piani potevano interrompere il ciclo di addebito in corso, facendo perdere ai clienti i giorni disponibili già pagati. A Langfuse servivano inoltre strumenti affidabili e di test per gestire correttamente comportamenti complessi di upgrade o downgrade. Inoltre Langfuse desiderava che gli avvisi di spesa fossero espressi in importi monetari anziché in numero di eventi. Allo stesso tempo, l'azienda necessitava di un approccio sicuro per recuperare pagamenti non andati a buon fine senza ricorrere a riscossioni manuali e di una soluzione globale unificata per imposte e pagamenti, in modo da poter effettuare addebiti ai clienti in diverse aree geografiche.

La soluzione

Per consentire un addebito affidabile, scalabile e a consumo che collegasse l'utilizzo al valore, Langfuse ha implementato un modello ibrido con l'addebito a consumo di Stripe Billing. I clienti si abbonano a piani mensili a più livelli e ogni abbonamento include un prodotto separato di uso misurato su Langfuse Cloud che registra gli eventi. I piani a più livelli soddisfano le diverse esigenze dei clienti, mentre il prodotto a utilizzo misurato traccia l'acquisizione degli eventi in modo coerente su tutti i piani, garantendo che i prezzi crescano proporzionalmente all'utilizzo. Langfuse invia il conteggio orario degli eventi dal proprio archivio dati ClickHouse/OLAP all'API di utilizzo misurato di Stripe assicurando un addebito accurato con visibilità quasi in tempo reale.

Il team ha scelto Stripe Checkout per creare abbonamenti e Billing per produrre una fattura unica con voci riga separate: la commissione SaaS anticipata (addebitata all'inizio del ciclo) e l'utilizzo a fine periodo. Ciò elimina i checkout pari a 0 USD e la confusione dei clienti, acquisendo al contempo i dettagli di pagamento durante la registrazione per soddisfare i requisiti di approvazione aziendali. La pianificazione dell'abbonamento e i controlli di ripartizione pro rata di Stripe consentono a Langfuse di applicare immediatamente gli aggiornamenti, preservando l'accumulo di utilizzo, e di programmare i downgrade in modo da garantire l'accesso pagato fino al termine del periodo di fatturazione attuale.

Poiché gli avvisi nativi non rispondevano alle esigenze di Langfuse in termini di importi monetari, il team utilizza la funzione anteprima fatture di Stripe ogni ora per calcolare l'esposizione in denaro. Quando vengono superate le soglie dei clienti, il sistema invia notifiche via email e all'interno dell'app. I webhook sincronizzano lo stato di abbonamenti e pagamenti all'interno del prodotto Langfuse. Per analisi e riconciliazione, Langfuse sincronizza i dati di Stripe su BigQuery tramite Airbyte e li combina con l'analitica del prodotto (dbt, Metabase), gli eventi operativi dei webhook alimentano anche un canale Slack per garantire visibilità in tempo reale.

Per il recupero dei pagamenti, Langfuse utilizza la logica di riprova automatica integrata di Stripe e le email di follow-up, anziché procedere a riscossioni manuali. Il team monitora i pagamenti non andati a buon fine nella Dashboard Stripe e sincronizza lo stato degli abbonamenti (past_due, scaduti non pagati) tramite webhook per visualizzare banner in-app che invitano i clienti ad aggiornare i dettagli di pagamento.

Per gestire le imposte a livello globale, Langfuse utilizza Stripe Tax insieme alla piattaforma di pagamento globale di Stripe, che calcola le imposte applicabili, supporta i metodi di pagamento locali e fornisce un'integrazione unica per l'addebito transfrontaliero.

Risultati

I prezzi sono trasparenti e gli sconti per volume sono automatizzati.

Langfuse ha implementato un modello ibrido chiaro in due settimane: una commissione SaaS anticipata più costi graduali per evento in Stripe. I livelli graduali si applicano automaticamente all'aumentare dell'utilizzo, eliminando la necessità di negoziazioni individuali sul volume.

Gli aggiornamenti vengono ripartiti immediatamente, garantendo al contempo la continuità dell'utilizzo

Grazie alla pianificazione dell'abbonamento e all'addebito flessibile di Stripe, Langfuse ripartisce gli upgrade e fattura immediatamente gli importi proporzionati, mantenendo intatti l'accumulo dell'utilizzo e il progresso nei livelli del piano. I downgrade vengono programmati per entrare in vigore alla fine del periodo di fatturazione, così che i clienti continuino ad avere accesso alle funzioni già pagate fino a quel momento.

Stripe gestisce l'utilizzo misurato su larga scala

Langfuse acquisisce ogni ora il conteggio degli eventi nell'API di utilizzo misurato di Stripe, gestendo fino a 200 milioni di eventi al mese per i singoli account e da centinaia di milioni a miliardi per tutti i clienti. L'addebito a consumo garantisce che l'utilizzo venga registrato e fatturato tramite Stripe.

Gli avvisi di spesa in dollari sfruttano le fatture in anteprima

Langfuse genera fatture di anteprima ogni ora tramite Stripe e confronta gli importi in denaro con le soglie configurate dall'utente, inviando avvisi via email e in-app quando i limiti vengono superati. I webhook di Stripe mantengono sincronizzati i dati relativi agli abbonamenti e allo stato dei pagamenti per i team di prodotto e operativi.

Gli strumenti nativi di Stripe riducono i costi di manutenzione

Il team sta progressivamente sostituendo le funzioni di addebito personalizzate con quelle native di Stripe. L'ultima revisione completa, che ha utilizzato l'addebito flessibile e l'utilizzo misurato di Stripe, ha richiesto un mese.