# Gestão de subscrições

> A visão da equipa sobre quem assina o quê. Listar e filtrar as subscrições, ver o histórico de cada uma, cancelar, reativar, dar desconto, incluir adicionais, estender o período, enviar link de pagamento e criar subscrições de cortesia, tudo com registo de quem fez.

A **gestão de subscrições** é a lista de todas as subscrições da comunidade, com as ações da equipa sobre cada uma. O [Faturação](/pagamentos/faturamento-do-membro) é a visão de quem paga; a gestão de subscrições é a de quem administra.

Fica em **Membros › Subscrições**: *"Quem assina o quê, quanto paga e quando é a próxima cobrança."* Quem assina são pessoas, por isso o separador fica junto do resto das pessoas da comunidade.

> [!NOTE]
> **Mudou de lugar a 6 de outubro de 2026.** O separador ficava em **Monetização**. O link antigo (`/monetization?tab=subscribers`) leva diretamente a **Membros › Subscrições**.

## Para que serve

| A equipa precisa… | Na gestão de subscrições |
|---|---|
| Saber quem está em atraso | Filtrar por **Em atraso** |
| Ver quem cancelou neste mês | Filtrar por **Cancelando** ou **Cancelada** e pelo período |
| Dar o plano a um palestrante ou parceiro | Criar uma subscrição de **cortesia** |
| Fechar um acordo com quem está em dificuldade | Dar um **desconto** por um tempo, ou **estender** o período |
| Cobrar quem está em atraso | **Enviar link de pagamento** |
| Mandar a lista para o financeiro | **Exportar CSV** |

## Quem pode

**Proprietário**, **administrador** e **financeiro**. Os três veem tudo e fazem todas as ações. Moderador e membro não têm acesso.

O financeiro chega pelo item **Membros** do menu: abre diretamente em **Subscrições** e não vê os outros separadores de Membros.

Toda ação fica registrada: quem fez, quando, o que mudou, como estava antes e como ficou depois.

## Como funciona

### A lista

Cada linha mostra o membro (nome e e-mail), o plano e a opção, o status, o valor (com o desconto, se houver), os adicionais, a forma de pagamento, a próxima cobrança, o contrato e a renovação em aberto, se houver.

| Status | O que significa |
|---|---|
| **Ativa** | Em dia |
| **Em teste** | No período de teste grátis |
| **Em atraso** | A renovação não foi paga |
| **Pausada** | Suspensa pela equipa |
| **Cancelando** | Cancelada, mas com acesso até o fim do período pago |
| **Cancelada** / **Encerrada** | Terminou |
| **Cortesia** | Criada pela equipa, sem cobrança |

As colunas são **Membro**, **Plano · opção**, **Estado**, **Valor**, **Próxima cobrança** e **Método**. Uma subscrição com PIX ou boleto de renovação ainda não pago mostra *"Aguardando pagamento"*.

Os filtros são o status (em pílulas), **Plano ou opção**, **Início a partir de** e **Início até** (pela data de início da subscrição) e **Buscar por nome ou e-mail**. **Exportar CSV** baixa a lista com os mesmos filtros, até 5.000 linhas.

### O detalhe

**Ver detalhes** abre a subscrição: a barra de ações (que muda conforme o status), os adicionais, o histórico de cobranças e a linha do tempo com os eventos (criada, cobrança paga, cobrança recusada, cancelada, encerrada) e cada ação da equipa, dizendo quem fez (*"O dono"*, *"Um admin"*, *"O financeiro"*).

### As ações

| Ação | O que faz |
|---|---|
| **Cancelar subscrição** | **No fim do período** (o membro mantém o acesso até lá e não é cobrado de novo) ou **Agora** (o acesso acaba na hora). O motivo é opcional e fica na linha do tempo. Nada já pago é estornado |
| **Reativar** | Desfaz um cancelamento enquanto o período pago não acabou: a subscrição volta a ser cobrada na próxima data |
| **Aplicar desconto** | Um percentual a partir da próxima cobrança, até uma data ou enquanto a subscrição durar. **Remover desconto** volta ao preço cheio na próxima cobrança |
| **Adicionar extensão** | Soma uma [extensão](/monetizacao/adicionais) sem cobrar agora: ela entra a partir da próxima cobrança do plano |
| **Remover** (adicional) | **No fim do período** ou **Agora**. Só o adicional sai; o plano continua |
| **Estender período** | **Por dias** (de 1 a 3.650) ou **Até uma data**. O tempo extra não é cobrado, e a próxima cobrança anda junto |
| **Enviar link de pagamento** | Manda ao membro um e-mail com **Pagar ou registar cartão**, que leva ao Faturação dele. Nada é cobrado sem a pessoa confirmar |

Toda ação pede confirmação antes.

Trocar o membro de plano ou de opção de faturação ainda não é uma ação da equipa.

### Criar uma subscrição

Para dar um plano a alguém sem passar pelo checkout:

| Modo | Para quê | O que acontece |
|---|---|---|
| **Cortesia** | Palestrante, parceiro, permuta, bolsa | Sem cobrança e sem lançamento no extrato. Com **Com data de fim**, a subscrição se encerra sozinha em **Cortesia até**, sem cobrar; sem data, segue até a equipa cancelar |
| **Começa a cobrar em** | Pagamento combinado por fora até uma data, ou um período de graça | Grátis até a data escolhida; depois, cobrada como qualquer subscrição, por PIX, boleto ou cartão |

Reativar uma cortesia com data de fim que foi cancelada a transforma em subscrição paga: a partir do fim do período, ela passa a ser cobrada.

A pessoa precisa ser membro da comunidade. Se ela já assina a mesma opção, a criação é recusada: *"Este membro já assina esta opção."*

## Passo a passo: cortesia para um palestrante

*Papel: proprietário, administrador ou financeiro.*

1. **Membros › Subscrições**, **Nova subscrição** (*"Dê uma assinatura a um membro sem passar pelo checkout."*).
2. Em **Membro**, busque por nome ou e-mail.
3. Em **Plano e opção**, escolha *Growth · Mensal*.
4. Em **Como fica a cobrança**, **Cortesia**; marque **Com data de fim** e escolha 31/12 em **Cortesia até**.
5. Se quiser, escreva uma nota (*"Palestrante do congresso"*).
6. Confirme. A subscrição aparece como **Cortesia**, e o palestrante passa a ver os espaços do plano.

## Exemplos

**Ana atrasou e pediu um mês.** O financeiro abre a subscrição dela, **Estender período** em 30 dias, e escreve o motivo. A próxima cobrança passa para o mês seguinte, sem cobrar o mês concedido.

**Desconto de retenção.** Bruno ia cancelar. A equipa usa **Aplicar desconto**: 20% até o fim do ano. As próximas cobranças saem com 20% a menos, e o desconto aparece no Faturação dele.

**Coworking que cobra por fora no primeiro mês.** Um residente pagou o primeiro mês em dinheiro. A equipa cria a subscrição em **Começa a cobrar em**, com a cobrança começando no dia 10 do mês seguinte, no cartão.

## Mensagens

| Mensagem | O que fazer |
|---|---|
| *Este membro já assina esta opção.* | Abra a subscrição que já existe |
| *Esta subscrição já foi encerrada.* | Crie uma subscrição nova |
| *Esta subscrição já vai encerrar no fim do período.* | Para desfazer, use **Reativar** |
| *O período desta subscrição já acabou.* | Não dá para reativar; crie uma nova |
| *O desconto precisa ser maior que 0% e menor que 100%…* | Use um percentual entre 0 e 100, com até duas casas |
| *Este é um adicional; abra a subscrição do plano.* | As ações de adicional ficam na subscrição do plano |
| *A nova data precisa ser depois do fim do período atual.* | Escolha uma data mais distante |
| *Não foi possível enviar o link: o membro não tem e-mail.* | Fale com o membro por outro canal |

## Perguntas frequentes

**A cortesia aparece nas vendas?**
Não. Uma cortesia não gera cobrança nem lançamento no extrato.

**O financeiro também pode cancelar?**
Pode. Proprietário, administrador e financeiro têm as mesmas ações, e todas ficam registradas com o nome de quem fez.

**A equipa vê quanto a operadora de pagamento cobra?**
Não. A gestão de subscrições mostra os valores do membro e da comunidade, com a taxa da plataforma; nunca custos internos.

## Na API

Em `/api/manage/subscriptions`, com a comunidade no header `X-CommunityId`:

- `GET /` lista, com `status`, `productId`, `subscriptionGroupId`, `from`, `to`, `search`, `page` e `limit`.
- `GET /export.csv` exporta.
- `GET /{subscriptionId}` traz o detalhe, com `charges`, `events` e `addOnSubscriptions`.
- `POST /` cria, com `profileId`, `productId`, `mode` (`COMPLIMENTARY` ou `FUTURE_CHARGE`), `complimentaryUntil`, `chargeStartsAt`, `paymentMethod` e `note`.
- As ações são:
  - `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`.

## Relacionados

- [Faturação do membro](/pagamentos/faturamento-do-membro)
- [Pagar agora](/pagamentos/pagar-agora)
- [Renovação](/pagamentos/renovacao)
- [Papéis e permissões](/conceitos/papeis-e-permissoes)