Skip to main content
Assinaturas são como você transforma um cliente em receita recorrente. Em vez de cobrar uma vez, você descreve o acordo — o que cobrar, com que frequência, em qual moeda e a partir de quando — e a Chargefy passa a faturar e cobrar sozinha, ciclo após ciclo, sem você precisar tocar em cada renovação.
A assinatura é o acordo. Cada ciclo é uma cobrança.A assinatura guarda o relacionamento ao longo do tempo: quem é o cliente, o que ele paga e quando renova. A cada ciclo ela gera automaticamente uma fatura e a cobrança que move o dinheiro. Você cuida do acordo; a Chargefy cuida das cobranças.

Quando usar

Use assinaturas quando existe uma relação contínua com o cliente e a cobrança precisa se repetir sem criar um pagamento manual a cada período. É o modelo adequado para planos de software, mensalidades, comunidades, serviços recorrentes e acesso contínuo a conteúdo. Antes de implementar, defina quatro decisões do seu produto:

O que você consegue fazer

O que você cobra

Toda assinatura tem pelo menos um item — uma linha que é cobrada a cada ciclo. Você monta os itens de dois jeitos, e pode misturar a estratégia conforme a necessidade:
  • A partir do catálogo — quando você já cadastrou o preço e quer reaproveitar valor, moeda e cadência. Bom pra planos padronizados.
  • Valor na hora — quando você quer definir um valor específico para aquele cliente sem precisar criar um preço no catálogo. Bom pra acordos sob medida.
Você pode ter quantidade por item (ex.: 5 licenças do mesmo plano) e somar vários itens numa assinatura só. O cliente recebe uma cobrança por ciclo com o total consolidado.
Como a assinatura tem uma única frequência e uma única moeda, todos os itens compartilham a mesma cadência e a mesma moeda. Pense na assinatura como “uma fatura recorrente” — tudo que está nela vence junto.

O ciclo de vida, sem você cuidar dele

Uma assinatura nasce, é cobrada, renova e um dia termina. A Chargefy move a assinatura entre esses estados automaticamente — você só reage aos que importam pro seu produto (liberar acesso, avisar o cliente, bloquear).
A assinatura fica Ativa quando a primeira fatura é efetivamente paga. Se o cartão passar no create, subscription.created já chega com status: "active"; se ela estava incomplete e for paga depois, subscription.updated traz a transição para active. Libere o produto pelo estado atual do webhook. O caminho completo está em Como ativar assinaturas incompletas.

Cada renovação se cuida sozinha

Quando chega a data da próxima cobrança, a Chargefy abre a fatura do novo ciclo, cobra o método de pagamento padrão e avança o período — tudo automático. Você não precisa agendar nada.
  • Cobrou → a assinatura segue ativa e o período já avançou.
  • Falhou → a assinatura entra em atraso e a cobrança fica disponível para nova tentativa, conforme a política de recuperação.
Isso significa que uma falha pontual de cartão não derruba a assinatura na hora — ela tem margem para se recuperar antes de virar perda.

Trial: ganhe o cliente antes de cobrar

Você pode começar a assinatura com um período gratuito. O cliente entra agora e a primeira cobrança só dispara quando o trial termina. Dá pra coletar o cartão durante o período gratuito (cobrança automática no fim) ou deixar o cliente começar sem cartão e decidir o que acontecer depois.

Conheça o trial

Período gratuito por dias ou data fixa, coleta de cartão durante o trial e o que fazer quando ele termina: cobrar, pausar ou cancelar.

Mudar de plano no meio do ciclo

O cliente quer fazer upgrade hoje, faltando 15 dias pra renovar? A Chargefy calcula o ajuste proporcional automaticamente: cobra só a diferença do tempo que falta no plano novo e credita o tempo não usado do plano antigo. Downgrade gera crédito a favor do cliente para as próximas faturas. Você ainda pode simular o resultado antes de aplicar.

Conheça o pró-rata

Upgrade, downgrade, crédito proporcional e prévia do ajuste antes de gravar.

Encerrar uma assinatura

Cancelar não é uma coisa só — depende da intenção: Você também pode registrar o motivo e o comentário do cancelamento, o que ajuda a entender por que clientes saem.

Mantenha seu sistema em sincronia

Em vez de ficar consultando a API, você reage a eventos. A cada mudança relevante a Chargefy dispara um webhook — esse é o jeito confiável de liberar acesso, avisar o cliente e atualizar seu sistema no momento certo.

Próximos passos

Trial

Período gratuito, coleta de cartão e o que fazer no fim do trial.

Pró-rata

Upgrades, downgrades e crédito proporcional no meio do ciclo.

Como ativar assinaturas incompletas

Como a assinatura sai de “criando” para “ativa” e o que fazer se a primeira cobrança não fechar.

Produtos, preços e descontos

Como modelar valor, moeda e recorrência dos itens da assinatura.

Clientes

O cliente dono da assinatura e seus métodos de pagamento.

Objeto subscription (API)

O contrato técnico completo: todos os campos, status e respostas.