For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /it/docs/web/billing.md (or send Accept: text/markdown).
Pagamenti e abbonamenti
Checkout Stripe, gestione dei piani e il confine degli entitlement.
Scegli e testa il tuo servizio di pagamento
La fatturazione gestisce i pagamenti. Le autorizzazioni di accesso vengono archiviate separatamente come diritti. Completa la configurazione dell'account persistente, quindi apri /billing nell'app Web in esecuzione per visualizzare l'interfaccia del piano. Con BILLING_PROVIDER=local esplori il comportamento locale anziché raccogliere denaro reale.
Scegli un fornitore di servizi di pagamento supportato, segui la relativa guida di configurazione, crea il tuo prodotto e prezzo di prova e copia le impostazioni del server denominato in apps/web/.env.local. Salva e riavvia il server Web. Completa un checkout utilizzando le istruzioni sandbox del provider, quindi controlla lo stato di accesso dell'area di lavoro dopo l'arrivo del webhook del provider. Un webhook è il messaggio firmato dal fornitore al tuo server relativo a un evento di pagamento.
Una pagina di successo da sola non sblocca funzionalità. Se il pagamento viene completato ma l'accesso rimane inattivo, controlla la consegna del webhook del provider e l'elaborazione degli eventi del tuo server prima di ripetere il pagamento. Testare anche la cancellazione e l'accesso scaduto. Gli acquisti tramite telefono utilizzano la configurazione separata RevenueCat/negozio, non questo pagamento Web.
Fatturazione web
L'applicazione Web supporta il fornitore di fatturazione selezionato con BILLING_PROVIDER; La striscia è un'opzione. Apertura/fatturazione per piani Web e gestione abbonamenti. Segui la guida del fornitore selezionato per impostare le credenziali solo del server, gli ID prodotto o prezzo e le impostazioni di verifica del webhook nell'ambiente di test o live corrispondente.
Autorizza tramite i permessi
Un redirect di checkout non è prova di accesso attivo. Il permesso lato server decide se un workspace può usare una capacità a pagamento. Controlla quel permesso alla frontiera dell'azione anche quando l'interfaccia nasconde già l'azione.
Verifica il ciclo di vita
Usa gli eventi sandbox per verificare attivazione, aggiornamenti, cancellazione ed elaborazione dei webhook. Mantieni gli eventi ripetuti sicuri e assicurati che un permesso inattivo blocchi le operazioni a pagamento. Gli acquisti nativi mobile restano una frontiera di integrazione RevenueCat separata.
Installazione e configurazione
Il catalogo dei piani vive in src/product-plans.ts e guida la superficie /billing e il passo di onboarding /choose-plan. La fatturazione si configura lato server con BILLING_PROVIDER=stripe, STRIPE_SECRET_KEY, i price id per ogni piano e intervallo, e STRIPE_WEBHOOK_SECRET. Lemon Squeezy è disponibile come adattatore alternativo.
I piani basati sui posti usano i selettori modificabili dei posti (src/seat-count.ts); la quantità viaggia con la sessione di checkout in modo che i posti fatturati corrispondano al workspace. I piani possono anche dichiarare meteredUsage in src/product-plans.ts affinché il job orario billing.usage-report invii i delta di usage_counter ai contatori di fatturazione Stripe, mentre i proprietari impostano budget IA mensili e tetti rigidi per contatore in Impostazioni → Utilizzo (USAGE_METERS in src/usage-meters.ts).
Checkout: POST /api/billing/checkout
Portal: POST /api/billing/portal
Webhook: POST /api/billing/webhook (signature-verified)Flusso di implementazione
Un redirect di checkout è solo un'intenzione in sospeso — l'accesso cambia quando arriva il webhook firmato e l'entitlement di proprietà del server si aggiorna. Controlla le azioni a pagamento con la verifica dell'entitlement al confine server (entitlement-gate.tsx / entitlement-check.ts) anche quando l'interfaccia le nasconde già.
Il portale clienti gestisce cambi di piano, cancellazione e metodi di pagamento. Mantieni lo stato dell'abbonamento leggibile dai membri del workspace e gli acquisti mobile nativi dietro il confine separato di RevenueCat.