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

Os períodos de cobrança são calculados inteiramente a partir de current_period_start e current_period_end, que avançam a cada renovação. O dia de cobrança do ciclo fica em cycle_billing_date, definido na ativação da assinatura.

Período Atual

• current_period_start: Início do período de cobrança atual
• current_period_end: 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 active e o período de cobrança começa

Permissões da Assinatura

Configuração	Descrição
allow_pause	Se o cliente pode pausar a assinatura
allow_cancel	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.