Gestão de assinaturas

A gestão de assinaturas é a lista de todas as assinaturas da comunidade, com as ações da equipe sobre cada uma. O Faturamento é a visão de quem paga; a gestão de assinaturas é a de quem administra.

Fica em Membros › Assinaturas: "Quem assina o quê, quanto paga e quando é a próxima cobrança." Quem assina é gente, por isso a aba fica junto com o resto das pessoas da comunidade.

Mudou de lugar em 6 de outubro de 2026. A aba ficava em Monetização. O link antigo (/monetization?tab=subscribers) leva direto para Membros › Assinaturas.

#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: ele abre direto em Assinaturas e não vê as outras abas 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, Status, Valor, Próxima cobrança e Método. Uma assinatura 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 assinatura) 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 assinatura: 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 equipe, 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 cobrança ainda não é uma ação da equipe.

#Criar uma assinatura

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

Reativar uma cortesia com data de fim que foi cancelada a transforma em assinatura 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 › Assinaturas, Nova assinatura ("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 assinatura 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 assinatura 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 equipe usa Aplicar desconto: 20% até o fim do ano. As próximas cobranças saem com 20% a menos, e o desconto aparece no Faturamento dele.

Coworking que cobra por fora no primeiro mês. Um residente pagou o primeiro mês em dinheiro. A equipe cria a assinatura 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 equipe vê quanto a operadora de pagamento cobra? Não. A gestão de assinaturas 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

• Faturamento do membro
• Pagar agora
• Renovação
• Papéis e permissões