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

