# Gestione degli abbonamenti

> La vista del team su chi è abbonato a cosa. Elencare e filtrare gli abbonamenti, vedere lo storico di ciascuno, annullare, riattivare, dare uno sconto, aggiungere componenti, estendere il periodo, inviare un link di pagamento e creare abbonamenti omaggio, tutto con la traccia di chi l'ha fatto.

La **gestione degli abbonamenti** è l'elenco di tutti gli abbonamenti della community, con le azioni del team su ciascuno. La [Fatturazione](/pagamentos/faturamento-do-membro) è la vista di chi paga; la gestione degli abbonamenti è quella di chi amministra.

Si trova in **Membri › Abbonamenti**: *"Chi è abbonato a cosa, quanto paga e quando è il prossimo addebito."* Chi si abbona è una persona, per questo la scheda sta insieme al resto delle persone della community.

> [!NOTE]
> **Spostata il 6 ottobre 2026.** La scheda era in **Monetizzazione**. Il vecchio link (`/monetization?tab=subscribers`) porta direttamente a **Membri › Abbonamenti**.

## A cosa serve

| Il team deve… | Nella gestione degli abbonamenti |
|---|---|
| Sapere chi è in ritardo | Filtrare per **Scaduto** |
| Vedere chi ha annullato questo mese | Filtrare per **In cancellazione** o **Annullato** e per periodo |
| Dare il piano a un relatore o a un partner | Creare un abbonamento **omaggio** |
| Trovare un accordo con chi è in difficoltà | Dare uno **sconto** per un periodo, o **estendere** il periodo |
| Riscuotere da chi è in ritardo | **Invia link di pagamento** |
| Mandare l'elenco all'amministrazione | **Esporta CSV** |

## Chi può

**Proprietario**, **admin** e **finanza**. Tutti e tre vedono tutto e fanno tutte le azioni. Moderatori e membri non hanno accesso.

Finanza ci arriva dalla voce **Membri** del menu: si apre direttamente su **Abbonamenti** e non vede le altre schede di Membri.

Ogni azione viene registrata: chi l'ha fatta, quando, cosa è cambiato, com'era prima e com'è dopo.

## Come funziona

### L'elenco

Ogni riga mostra il membro (nome ed email), il piano e l'opzione, lo stato, l'importo (con lo sconto, se c'è), i componenti aggiuntivi, il metodo di pagamento, il prossimo addebito, il contratto e il rinnovo in sospeso, se c'è.

| Stato | Cosa significa |
|---|---|
| **Attivo** | In regola |
| **In prova** | Nel periodo di prova gratuita |
| **Scaduto** | Il rinnovo non è stato pagato |
| **In pausa** | Sospeso dal team |
| **In cancellazione** | Annullato, ma con accesso fino alla fine del periodo pagato |
| **Annullato** / **Terminato** | Concluso |
| **Omaggio** | Creato dal team, senza addebito |

Le colonne sono **Membro**, **Piano · opzione**, **Stato**, **Importo**, **Prossimo addebito** e **Metodo**. Un abbonamento con un PIX o un boleto di rinnovo non ancora pagato mostra *"In attesa di pagamento"*.

I filtri sono lo stato (a pillole), **Piano o opzione**, **Iniziato dal** e **Iniziato fino al** (per data di inizio dell'abbonamento) e **Cerca per nome o email**. **Esporta CSV** scarica l'elenco con gli stessi filtri, fino a 5.000 righe.

### Il dettaglio

**Vedi dettagli** apre l'abbonamento: la barra delle azioni (che cambia in base allo stato), i componenti aggiuntivi, lo storico degli addebiti e la cronologia con gli eventi (creato, addebito pagato, addebito rifiutato, annullato, terminato) e ogni azione del team, con chi l'ha fatta (*"Il proprietario"*, *"Un admin"*, *"L'amministrazione"*).

### Le azioni

| Azione | Cosa fa |
|---|---|
| **Annulla abbonamento** | **A fine periodo** (il membro mantiene l'accesso fino ad allora e non riceve altri addebiti) oppure **Ora** (l'accesso termina subito). Il motivo è facoltativo e resta nella cronologia. Nulla di già pagato viene rimborsato |
| **Riattiva** | Revoca un annullamento finché il periodo pagato non è finito: l'abbonamento viene addebitato di nuovo alla prossima data |
| **Applica sconto** | Una percentuale dal prossimo addebito, fino a una data o finché dura l'abbonamento. **Rimuovi sconto** torna al prezzo pieno dal prossimo addebito |
| **Aggiungi componente** | Aggiunge un [componente aggiuntivo](/monetizacao/adicionais) senza addebitare ora: entra dal prossimo addebito del piano |
| **Rimuovi** (componente) | **A fine periodo** oppure **Ora**. Esce solo il componente; il piano resta |
| **Estendi periodo** | **Per giorni** (da 1 a 3.650) oppure **Fino a una data**. Il tempo extra non viene addebitato, e il prossimo addebito si sposta di conseguenza |
| **Invia link di pagamento** | Invia al membro un'email con **Paga o registra la carta**, che porta alla sua Fatturazione. Nulla viene addebitato senza la sua conferma |

Ogni azione chiede prima una conferma.

Spostare il membro su un altro piano o un'altra opzione non è ancora un'azione del team.

### Creare un abbonamento

Per dare un piano a qualcuno senza passare dal checkout:

| Modalità | Per cosa | Cosa succede |
|---|---|---|
| **Omaggio** | Relatore, partner, scambio, borsa di studio | Nessun addebito e nessuna voce nell'estratto conto. Con **Con data di fine**, l'abbonamento termina da solo in **Omaggio fino al**, senza addebiti; senza data, continua finché il team non lo annulla |
| **Inizia ad addebitare il** | Pagamento concordato per altre vie fino a una data, o un periodo di grazia | Gratis fino alla data scelta; poi addebitato come qualsiasi abbonamento, con PIX, boleto o carta |

Riattivare un omaggio con data di fine che è stato annullato lo trasforma in un abbonamento a pagamento: dalla fine del periodo viene addebitato.

La persona deve essere membro della community. Se è già abbonata alla stessa opzione, la creazione viene rifiutata: *"Questo membro è già abbonato a questa opzione."*

## Passo dopo passo: un omaggio per un relatore

*Ruolo: proprietario, admin o finanza.*

1. **Membri › Abbonamenti**, **Nuovo abbonamento** (*"Dai un abbonamento a un membro senza passare dal checkout."*).
2. In **Membro**, cerca per nome o email.
3. In **Piano e opzione**, scegli *Growth · Mensile*.
4. In **Come funziona l'addebito**, **Omaggio**; spunta **Con data di fine** e scegli il 31/12 in **Omaggio fino al**.
5. Se vuoi, scrivi una nota (*"Relatore del congresso"*).
6. Conferma. L'abbonamento compare come **Omaggio**, e il relatore inizia a vedere gli spazi del piano.

## Esempi

**Ana è in ritardo e ha chiesto un mese.** L'amministrazione apre il suo abbonamento, usa **Estendi periodo** di 30 giorni e scrive il motivo. Il prossimo addebito passa al mese successivo, senza addebitare il mese concesso.

**Uno sconto di fidelizzazione.** Bruno stava per annullare. Il team usa **Applica sconto**: 20% fino a fine anno. I prossimi addebiti escono del 20% più bassi, e lo sconto compare nella sua Fatturazione.

**Un coworking che incassa il primo mese per altre vie.** Un residente ha pagato il primo mese in contanti. Il team crea l'abbonamento con **Inizia ad addebitare il**, con l'addebito che parte il 10 del mese successivo, con carta.

## Messaggi

| Messaggio | Cosa fare |
|---|---|
| *Questo membro è già abbonato a questa opzione.* | Apri l'abbonamento che esiste già |
| *Questo abbonamento è già terminato.* | Crea un nuovo abbonamento |
| *Questo abbonamento termina già alla fine del periodo.* | Per annullarlo, usa **Riattiva** |
| *Il periodo di questo abbonamento è già terminato.* | Non si può riattivare; creane uno nuovo |
| *Lo sconto deve essere maggiore di 0% e minore di 100%…* | Usa una percentuale tra 0 e 100, con al massimo due decimali |
| *Questo è un componente aggiuntivo; apri l'abbonamento del piano.* | Le azioni sui componenti si trovano nell'abbonamento del piano |
| *La nuova data deve essere successiva alla fine del periodo attuale.* | Scegli una data più lontana |
| *Impossibile inviare il link: il membro non ha un'email.* | Contatta il membro per altre vie |

## Domande frequenti

**L'omaggio compare nelle vendite?**
No. Un omaggio non genera addebiti né voci nell'estratto conto.

**Anche l'amministrazione può annullare?**
Sì. Proprietario, admin e finanza hanno le stesse azioni, e tutte vengono registrate con il nome di chi le ha fatte.

**Il team vede quanto addebita il gestore dei pagamenti?**
No. La gestione degli abbonamenti mostra gli importi del membro e della community, con la commissione della piattaforma; mai costi interni.

## Nell'API

In `/api/manage/subscriptions`, con la community nell'header `X-CommunityId`:

- `GET /` elenca, con `status`, `productId`, `subscriptionGroupId`, `from`, `to`, `search`, `page` e `limit`.
- `GET /export.csv` esporta.
- `GET /{subscriptionId}` restituisce il dettaglio, con `charges`, `events` e `addOnSubscriptions`.
- `POST /` crea, con `profileId`, `productId`, `mode` (`COMPLIMENTARY` o `FUTURE_CHARGE`), `complimentaryUntil`, `chargeStartsAt`, `paymentMethod` e `note`.
- Le azioni sono:
  - `POST /{id}/cancel` e `POST /{id}/reactivate`;
  - `PUT` e `DELETE /{id}/discount`;
  - `POST /{id}/add-ons` e `DELETE /{id}/add-ons/{addOnSubscriptionId}`;
  - `POST /{id}/extend`;
  - `POST /{id}/payment-link`.

## Correlati

- [Fatturazione del membro](/pagamentos/faturamento-do-membro)
- [Paga ora](/pagamentos/pagar-agora)
- [Rinnovo](/pagamentos/renovacao)
- [Ruoli e permessi](/conceitos/papeis-e-permissoes)