Termos de Cobrança
Os termos de cobrança definem como e quando o cliente é cobrado pela assinatura.
Ciclos de Cobrança
| Ciclo | Frequência | Duração |
|---|---|---|
monthly | Mensal | 1 mês |
quarterly | Trimestral | 3 meses |
semiannual | Semestral | 6 meses |
annual | Anual | 12 meses |
Âncora de Cobrança
A billingCycleAnchor define a data de referência para o cálculo dos períodos de cobrança. É definida automaticamente como a data de ativação da assinatura.
Período Atual
currentPeriodStart: Início do período de cobrança atualcurrentPeriodEnd: Fim do período de cobrança atual
Métodos de Cobrança
| Método | Geração de Fatura | Cobrança |
|---|---|---|
charge_automatically | Automática | Automática |
manual_charge | Automática | Manual |
manual_invoice | Manual | Manual |
Cobrança Automática (charge_automatically)
- A fatura é gerada automaticamente pelo worker
- Na finalização, o sistema tenta cobrar automaticamente usando o método de pagamento padrão do cliente
- Para cartão: cobrança imediata
- Para boleto/PIX: gera a cobrança e aguarda confirmação via webhook
- Em caso de falha: agenda tentativas de retry (dunning)
Cobrança Manual com Fatura Automática (manual_charge)
- A fatura é criada automaticamente pelo worker
- O cliente recebe a fatura por e-mail
- O pagamento é realizado manualmente (boleto, PIX) ou o operador aciona a cobrança
Fatura e Cobrança Manual (manual_invoice)
- Nenhuma fatura é gerada automaticamente
- O operador cria as faturas manualmente quando necessário
- Útil para cobranças avulsas ou faturamento irregular
Comportamento de Proration
Configura como a mudança de plano no meio do ciclo é tratada:
| Comportamento | Descrição |
|---|---|
create_prorations | Cria créditos e cobranças proporcionais (padrão) |
none | Nenhum ajuste proporcional |
always_invoice | Sempre gera fatura para a diferença |
Período de Trial
- Configurável de 0 a 90 dias
- Durante o trial, a assinatura fica no status
trialing - Ao fim do trial, a assinatura muda para
activee o período de cobrança começa
Permissões da Assinatura
| Configuração | Descrição |
|---|---|
allowPause | Se o cliente pode pausar a assinatura |
allowCancel | Se o cliente pode cancelar a assinatura |
Essas configurações podem ser definidas por assinatura e controlam as opções disponíveis no portal do cliente.