# Adicionais

> Extras que só quem tem um plano compra: vendidos junto com o plano num pagamento só, ou somados depois com valor proporcional, e que acompanham o plano quando ele atrasa, pausa ou é cancelado.

Um **adicional** (o upsell) é um produto que só faz sentido por cima de um [plano](/monetizacao/planos): a extensão Coworking por cima do Growth, a mentoria em grupo por cima do plano Aluno, um pacote de membros extras por cima do Scale. Quem não tem o plano não vê o adicional nem consegue comprá-lo.

## Para que serve

| Comunidade | Plano | Adicional | Por quê |
|---|---|---|---|
| SaaS (catálogo da Memberfy) | Starter, Growth, Business, Scale | Extensão Coworking R$ 450/mês · Extensão Planeamento & RH R$ 950/mês | A extensão só existe por cima de um plano |
| SaaS | Scale | Pacote +2.000 membros, R$ 99/mês | Só faz sentido no maior plano |
| Escola online | Aluno | Mentoria em grupo, R$ 100/mês | Quem não é aluno não tem o que mentorar |
| Coworking | Residente | Armário, R$ 60/mês | Só o residente usa armário |

Sem o adicional, o mesmo efeito exigiria um plano novo para cada combinação ("Growth com coworking", "Growth com RH", "Growth com os dois"). Com ele, o plano fica um só e o extra é somado.

## As regras de um adicional

- **Exige o plano**: só quem tem um dos planos ativos vê o adicional e consegue comprá-lo. Sem o plano, o pagamento é recusado: *"Este adicional exige um plano ativo. Assine um dos planos necessários antes de comprá-lo."*
- **Acompanha o plano**: plano em atraso ou pausado **suspende** o adicional (e o devolve quando o plano volta); plano encerrado encerra o adicional.

## Como funciona

### Onde se configura

A lista de adicionais **fica no plano**. Em **Monetização › Planos**, ao criar ou editar um plano, a secção **Adicionais (upsell)** lista os produtos que podem ser somados a ele, e você marca os que valem para aquele plano.

![A secção Adicionais (upsell) na edição do plano](/screens/plano-editar-adicionais.png "Cada adicional mostra o preço mensal e o anual, se é vendido junto, e o link do downsell.")

Para cada adicional da lista, escolha:

| Opção | O que significa |
|---|---|
| **vendido em conjunto** | Aparece na página de preços, logo depois da escolha do plano, para marcar e pagar junto |
| **só para quem tem o plano** | Não aparece na compra do plano; quem já assina compra depois, pelo Faturação |

No separador **Planos** do próprio produto, aparece de quais planos ele é adicional (*"Adicional de: …"*), só para leitura: *"A lista fica no plano: em Monetização › Planos, edite o plano e marque o produto em 'Adicionais'."*

### Regras do adicional

- É uma **opção de faturação mensal**, fora de qualquer plano. Uma opção que já é forma de pagar de um plano não pode ser adicional de outro: *"Um produto que é opção de cobrança de um plano não pode ser adicional de outro."*
- **Preço no ritmo do plano**: no plano mensal, cobra o preço mensal do adicional; no plano anual, cobra **12 vezes** o mensal, dentro do mesmo parcelamento do ano.
- **Planos semanais e diários** não oferecem adicional, e **planos com teste grátis** também não, até o teste acabar.
- A **duração do contrato** do plano não prende o adicional: ele pode ser tirado a qualquer momento.

### Um pagamento só

Comprado junto com o plano, tudo vira **um pedido**: um PIX, um boleto ou uma transação no cartão. Daí em diante, plano e adicionais renovam **na mesma data**, num pedido só. O fixo de R$ 2,49 da taxa da plataforma entra **uma vez por pedido**, não uma vez por item.

### Somar um adicional depois

Quem já assina o plano soma um adicional em **Faturação › Adicionar extensão**:

1. O ecrã mostra o valor **proporcional** até a próxima data do plano (*"Hoje: R$ 225,00 (proporcional até 20/11)"*) e o que vem depois (*"Depois: R$ 450,00 junto com o plano, a cada cobrança"*).
2. Se faltam **menos de 3 dias** para a próxima cobrança, ou o proporcional dá **menos de R$ 10**, nada é cobrado agora: o adicional entra direto na próxima cobrança do plano (*"Sem cobrança agora…"*).
3. O pagamento usa o cartão salvo por padrão; PIX e boleto também servem.

### Tirar um adicional

O cancelamento de um adicional vale **no fim do período**: ele fica até lá e não entra na próxima cobrança (*"Adicionais cancelados ficam até o fim do período e não entram na próxima cobrança."*).

Tirar um produto da lista de um plano que tem subscritores desse adicional é recusado (*"Não é possível tirar este adicional do plano: N assinatura(s) de quem assina o plano seriam canceladas na hora…"*): encerre essas subscrições antes.

### Quem pode

Configurar adicionais no plano: **proprietário** e **administrador**. Comprar: quem tem o plano.

## Passo a passo: vender um adicional junto com o plano

*Papel: proprietário ou administrador.*

1. **Crie o adicional** em **Monetização › Opções › Criar opção de faturação**: nome (ex.: *Extensão Coworking*), preço mensal (R$ 450), intervalo **Mensal**, métodos de pagamento. **Não** marque plano nenhum no separador **Planos**.
2. Abra **Monetização › Planos**, e no plano (ex.: *Growth*) abra o menu da linha e **Editar**.
3. Em **Adicionais (upsell)**, marque *Extensão Coworking* e deixe **vendido em conjunto**.
4. **Guardar**.
5. Repita nos outros planos que devem oferecer o adicional.

### O que o comprador vê

Na página de preços, depois de escolher o plano e a opção, aparece **Adicionais para este plano** (*"Cobrados junto com o plano, no mesmo pagamento e na mesma data."*). Cada adicional mostra o valor no ritmo da opção: *+ R$ 450,00/mês* no mensal; *+ 12× de R$ 450,00 · R$ 5.400,00 por ano* no anual. O resumo do pagamento lista o plano e cada adicional, e o total.

![Plano mensal com um adicional marcado](/screens/pricing-mensal-com-adicional.png "Growth Mensal + Extensão Coworking: R$ 579,00 num pagamento só.")

## Exemplos com números

A taxa é 6,99% sobre o total + R$ 2,49 uma vez por pedido.

**Growth Mensal (R$ 129) + Extensão Coworking (R$ 450), comprados juntos.**
Total de **R$ 579,00** por mês. Taxa: R$ 40,47 + R$ 2,49 = R$ 42,96. Ficam **R$ 536,04** por mês.

**Os mesmos dois, comprados separados.**
Dois pedidos, dois fixos: (R$ 9,02 + R$ 2,49) + (R$ 31,46 + R$ 2,49) = R$ 45,46. Ficam R$ 533,54. Vender junto deixa **R$ 2,50 a mais por mês** para a comunidade, e uma data de cobrança só para o membro.

**Growth Anual (R$ 1.188) + Extensão Coworking no anual (12 × R$ 450 = R$ 5.400).**
Total de **R$ 6.588,00** por ano, em até 12× no cartão. Taxa: R$ 460,50 + R$ 2,49 = R$ 462,99. Ficam **R$ 6.125,01**.

**Somar o Coworking no meio do mês.**
O Growth renova dia 20; no dia 5, faltam 15 de 30 dias. Hoje: R$ 450 × 15/30 = **R$ 225,00**. A partir do dia 20, R$ 579,00 por mês, num pedido só.

## Erros comuns e como resolver

| Mensagem | O que fazer |
|---|---|
| *Este adicional exige um plano ativo…* | A pessoa precisa assinar um dos planos antes |
| *Esta opção do plano não aceita adicionais.* | A opção é semanal ou diária, ou tem teste grátis |
| *Este adicional não está na lista do plano escolhido.* | Marque o produto em **Adicionais** no plano |
| *Este adicional não pode ser comprado junto com o plano.* | Ele está como **só para quem tem o plano**: compre depois, pelo Faturação |
| *Você já assina este adicional.* | Nada a fazer: ele já está na subscrição |
| *Só é possível somar adicionais a um plano ativo, sem cancelamento agendado.* | Regularize ou reative o plano antes |
| *Um dos adicionais não existe nesta comunidade ou foi eliminado.* | Tire o produto eliminado da lista do plano |

## Perguntas frequentes

**O adicional pode ter teste grátis?**
O teste é do plano. Um plano com teste não oferece adicional até o teste terminar.

**Se o membro cancelar o plano, o adicional continua?**
Não. Plano cancelado no fim do período faz o adicional também parar de renovar; plano encerrado na hora encerra o adicional junto.

**Posso dar desconto num adicional?**
Sim: com um [cupão](/monetizacao/cupons) que inclua o adicional, ou com um [downsell](/monetizacao/downsell) para quem não o levou.

**No plano anual, o adicional também é anual?**
É: ele acompanha o ritmo do plano e cobra 12 vezes o preço mensal, no mesmo pagamento e no mesmo parcelamento do ano. Na renovação do plano, renova junto.

**Um adicional pode valer para vários planos?**
Pode. Marque-o na secção **Adicionais** de cada plano que deve oferecê-lo.

**O adicional libera espaços?**
Sim, como qualquer produto: ponha-o em **Quem tem acesso › Produtos** do espaço.

## Na API

`PUT /api/subscription-groups/{id}` com `addOnProductIds`; `POST /api/checkout` com `addOnProductIds`; `POST /api/subscriptions/{id}/add-ons/quote` e `POST /api/subscriptions/{id}/add-ons`. Ver [Subscriptions](/api/referencia/subscriptions) e [Checkout](/api/referencia/checkout).

## Relacionados

- [Planos](/monetizacao/planos)
- [Downsell](/monetizacao/downsell)
- [Faturação do membro](/pagamentos/faturamento-do-membro)