Billing

Ultimo aggiornamento: 2026-03-26 Owner: Product Writer Audience: owner, admin tenant, billing_admin

Scopo

Spiegare come usare il modulo Billing per controllare piano tenant, stato abbonamento, rinnovo, checkout e sincronizzazione con il provider pagamenti.

Prerequisiti

• ruolo autorizzato sul layer commerciale tenant
• tenant selezionato correttamente

Ruoli ammessi nel runtime corrente:

• owner
• admin
• billing_admin

Cosa mostra il modulo

Il modulo espone almeno questi elementi:

• piano attivo
• stato abbonamento
• ultimo pagamento noto
• prossimo rinnovo previsto
• profilo billing business-first
• catalogo piani disponibili
• storico recente dei cambi piano
• azioni di sync, cancel o resume quando consentite
• dettagli tecnici provider solo in area secondaria

Stati commerciali che puoi incontrare:

• In prova
• Checkout in corso
• Attivo
• Pagamento in ritardo
• Sospeso
• Cancellato
• Scaduto

Passi operativi

1. Apri Billing dal workspace.
2. Controlla piano attivo, stato abbonamento, ultimo pagamento e prossimo rinnovo.
3. Usa il profilo billing per leggere il quadro commerciale del tenant.
4. Avvia il checkout quando devi cambiare piano, solo se il ruolo puo amministrare davvero la subscription.
5. Usa sync, cancel o resume solo quando devi riallineare lo stato tenant con il provider pagamenti.
6. Se compare Riprendi checkout, usa quella CTA prima di aprire un nuovo checkout.
7. Se il tenant e gia attivo, il catalogo chiarisce se stai facendo upgrade, downgrade o semplice aggiornamento piano.
8. Per tenant gia attivi, il nuovo canone ricorrente si applica dal prossimo rinnovo utile, senza nuovo checkout.
9. Se compare Riallinea con provider, usala quando il tenant o il pagamento richiedono una verifica esterna.
10. Apri i dettagli tecnici provider solo se devi fare supporto o verifiche operative.
11. Dopo il checkout, attendi il webhook/provider update per la conferma finale dello stato.
12. Se lo stato e Pagamento in ritardo, controlla anche la fine del grace period prima che il tenant venga sospeso.
13. Usa Storico cambi piano per capire gli ultimi cambi commerciali gia registrati sul tenant.
14. Leggi anche l'origine evento per distinguere se il cambio e stato avviato dal tenant, dal control plane o dal provider.

Risultato atteso

Il tenant mantiene allineati piano commerciale, stato abbonamento e rinnovi senza esporre come contenuto primario i riferimenti tecnici del provider.

Errori frequenti

• Rientro da checkout ma stato non ancora aggiornato
• causa: il redirect applicativo e arrivato prima del webhook provider
• soluzione: attendi la sincronizzazione automatica o usa sync se previsto dal processo operativo

• Esiste un pagamento aperto ma non vuoi riaprire un nuovo checkout
• causa: un checkout precedente e rimasto open
• soluzione: usa Riprendi checkout per riaprire il payment gia esistente

• Lo stato tenant non sembra coerente con il provider
• causa: il provider puo essere avanzato prima del riallineamento applicativo
• soluzione: usa Riallinea con provider per forzare la verifica runtime

• Azione non disponibile
• causa: il ruolo puo vedere il billing ma non amministrare la subscription
• soluzione: coinvolgi owner, admin o billing_admin autorizzato

• Accesso negato da un ruolo tenant operativo
• causa: hr_admin, manager e user non fanno parte del perimetro subscription/payments
• soluzione: coinvolgi owner, admin o billing_admin

• Dati provider non coerenti
• causa: disallineamento temporaneo tra tenant e provider esterno
• soluzione: riesegui sync e verifica i dettagli tecnici provider solo se serve supporto

• Workspace ridotto dopo sospensione
• causa: il tenant e passato a Sospeso o Scaduto
• soluzione: usa Billing per il recovery commerciale se il tuo ruolo e owner, admin o billing_admin; anche le API tenant principali sono ora coerenti con questa restrizione

FAQ

Cambiare piano attiva sempre un checkout?

Non sempre. In alcuni casi il sistema puo aggiornare direttamente la subscription senza nuovo checkout.

Upgrade e downgrade quando diventano effettivi?

Per tenant gia attivi, il nuovo canone ricorrente viene applicato dal prossimo rinnovo utile.

Il modulo billing e la stessa cosa del billing globale platform?

No. Questo modulo riguarda il tenant corrente, non la governance multi-tenant della piattaforma SaaS.

Come legge NBN la timeline globale dei cambi piano?

Nel control plane Platform Billing, NBN usa filtri dedicati su stato tenant, tenant, evento, direzione e finestra temporale, cosi la timeline globale recente resta coerente con il portfolio attualmente in analisi.

NBN puo esportare la timeline globale filtrata?

Si. Platform Billing espone una CTA Esporta timeline CSV che usa gli stessi filtri attivi della vista, cosi il file esportato resta coerente con il perimetro che NBN sta controllando.

Cosa significa l'origine evento nella timeline?

La timeline usa label leggibili come Utente tenant, Operatore platform, Webhook provider o Sistema, cosi NBN e il tenant possono capire subito chi ha originato il cambio senza leggere un codice tecnico.

Quando il sistema conosce l'attore umano, la timeline mostra direttamente nome o email operativa invece di una label generica.

Quando il ruolo e il perimetro sono verificabili, la timeline mostra anche il contesto governance dell'attore, ad esempio Owner tenant, Billing admin tenant o Super admin platform.

I riferimenti Mollie sono sempre visibili?

No. Restano disponibili solo come dettaglio tecnico secondario e non come contenuto principale della pagina.

Cosa significa `Checkout in corso`?

Significa che il checkout e stato avviato o il rientro applicativo e avvenuto, ma la conferma definitiva resta in attesa del webhook/provider update.

Cosa significa `Pagamento in ritardo`?

Significa che il tenant non e ancora sospeso, ma esiste un rinnovo o un incasso che richiede attenzione commerciale.

Cosa succede durante il grace period?

Il tenant puo restare operativo per una finestra limitata. Se il pagamento non viene recuperato entro la scadenza del grace period, lo stato commerciale puo passare a Sospeso.