Recorrência nativaNa Chargefy, assinaturas são gerenciadas pelo sistema de recorrência nativo da plataforma. Ao criar um produto com preço recorrente e um cliente confirmar o checkout com cartão de crédito, a Chargefy automaticamente configura o plano de recorrência.
Visão Geral
Uma assinatura na Chargefy representa uma relação contínua de cobrança entre um cliente e um produto. Diferente de pagamentos únicos, assinaturas cobram automaticamente o cliente em intervalos regulares.Frequências suportadas
| Frequência | Intervalo | Exemplo |
|---|---|---|
| Diária | Todo dia | R$ 1,99/dia |
| Semanal | Toda semana | R$ 19,90/semana |
| Mensal | Todo mês | R$ 49,90/mês |
| Anual | Todo ano | R$ 399,90/ano |
Assinaturas são cobradas exclusivamente via cartão de crédito. PIX e Boleto não suportam cobranças recorrentes automáticas.
Como funciona
Criação de assinatura
Produto recorrente
Crie um produto com ciclo de cobrança recorrente (mensal, anual, semanal ou diário) no dashboard ou via API.
Checkout
O cliente acessa o checkout (via link, embed ou API) e seleciona cartão de crédito como método de pagamento.
Primeira cobrança
Ao confirmar o checkout, a Chargefy processa a primeira cobrança e cria um plano de recorrência automaticamente.
Fluxo técnico
Ciclo de vida da assinatura
Status
| Status | Descrição |
|---|---|
active | Assinatura ativa, cobranças em dia |
trialing | Em período trial, sem cobrança |
suspended | Temporariamente suspensa (ex: falha de pagamento) |
canceled | Cancelada pelo cliente ou administrador |
revoked | Revogada pelo administrador |
Gerenciamento
Suspender assinatura
Pausa temporariamente as cobranças sem cancelar a assinatura. O cliente perde acesso aos benefícios durante a suspensão.Reativar assinatura
Retoma as cobranças de uma assinatura suspensa. O cliente recupera acesso aos benefícios.Cancelar assinatura
Cancela permanentemente a assinatura. O cliente mantém acesso até o final do período já pago.Com
cancel_at_period_end: true, o cliente mantém acesso até a data de renovação. Com false, o cancelamento é imediato.Alterar plano (Upgrade/Downgrade)
Você pode alterar o produto de uma assinatura para um upgrade ou downgrade. A Chargefy calcula o prorate automaticamente.Período Trial
Assinaturas podem ter um período trial onde o cliente não é cobrado. Ao final do trial, a primeira cobrança é processada automaticamente.- O trial é configurado no produto (ex: 7 dias, 14 dias, 1 mês)
- O cliente precisa fornecer dados do cartão no checkout
- Se o cliente cancelar durante o trial, não há cobrança
Faturamento automático
A cada ciclo de cobrança, a Chargefy automaticamente:- Processa a cobrança no cartão
- Cria um registro de transação (zoop_transaction)
- Dispara webhooks (
subscription.updated,checkout.updated) - Atualiza o acesso do cliente aos benefícios
Webhook events
| Evento | Quando |
|---|---|
subscription.created | Assinatura criada |
subscription.active | Assinatura ativada (após primeiro pagamento ou trial) |
subscription.updated | Qualquer atualização na assinatura |
subscription.canceled | Assinatura cancelada |
subscription.uncanceled | Cancelamento revertido |
subscription.revoked | Assinatura revogada pelo administrador |
Comparação com Stripe Subscriptions
Se você está migrando do Stripe, aqui estão as principais diferenças:| Conceito | Stripe | Chargefy |
|---|---|---|
| Recorrência | Stripe Billing | Sistema de recorrência da Chargefy |
| Métodos de pagamento | Múltiplos | Apenas Cartão de Crédito |
| Moeda | Múltiplas | BRL (Real brasileiro) |
| Invoices | Stripe Invoices | Geração automática Chargefy |
| Proration | Automático | Automático |
| Trials | ✅ | ✅ |
| Parcelamento na recorrência | ❌ | ❌ (apenas pagamento único) |

