Gestão de subscrições

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 é 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.

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

#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.

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

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:

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

#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
• Pagar agora
• Renovação
• Papéis e permissões