> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Trial de assinaturas
> Ofereça um período gratuito, colete o cartão no momento certo e decida o que acontece quando o trial termina.
Um **trial** é um período gratuito no começo da assinatura — a forma de deixar o
cliente experimentar antes de pagar. A assinatura entra no ar agora, o cliente
usa o produto de graça, e a primeira cobrança só acontece quando o trial termina.
O trial é uma ponte entre "interessado" e "pagante". Você reduz o atrito da
primeira cobrança sem perder o controle: define quanto dura, se coleta o cartão
durante o período e o que fazer quando ele chega ao fim.
## O que você consegue fazer
| Possibilidade | O que isso te dá |
| ----------------------------- | ---------------------------------------------------------------------------------------------- |
| **Período por dias** | Ofereça 7, 14, 30 dias — o tempo que combina com seu produto. |
| **Período até uma data fixa** | Encerre o trial num dia específico, útil pra campanhas e datas comuns a vários clientes. |
| **Trial padrão no preço** | Deixe o próprio plano já carregar o período gratuito, sem precisar repetir em cada assinatura. |
| **Cartão coletado no trial** | Garanta a conversão automática no fim do período, sem pedir nada de novo ao cliente. |
| **Começar sem cartão** | Reduza ao máximo o atrito de entrada e colete o pagamento depois. |
| **Decidir o fim do trial** | Escolha o que acontece se o trial terminar sem cartão: cobrar, pausar ou cancelar. |
| **Avisar antes de cobrar** | Receba um aviso quando o trial está perto de acabar para lembrar o cliente. |
## Coletar o cartão durante o período gratuito
Você tem duas estratégias, e a escolha depende de quanto atrito quer na entrada:
* **Com cartão desde já** — o cliente cadastra o cartão ao iniciar o trial.
Quando o período acaba, a Chargefy cobra automaticamente e a assinatura vira
paga sem nenhum passo extra. Maior conversão no fim, um pouco mais de atrito na
entrada.
* **Sem cartão** — o cliente começa o trial sem informar pagamento. Atrito mínimo
pra experimentar, mas você precisa coletar o cartão antes do fim do período (ou
decidir o que fazer sem ele).
Quando a assinatura começa em trial sem cartão, a Chargefy prepara o caminho para
você coletar o pagamento durante o período — assim o cartão fica pronto para a
cobrança automática no fim, sem cobrar o cliente antes da hora.
## O que acontece quando o trial termina
No fim do trial, a Chargefy avalia a situação e age sozinha:
* **Tem cartão salvo** → abre a primeira fatura paga e cobra automaticamente. O
cliente vira pagante sem fazer nada.
* **Não tem cartão** → o resultado é a política que **você** escolheu na hora de
criar a assinatura.
A política para "trial terminou sem cartão" te dá três caminhos:
| Sua escolha | O que acontece |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Cobrar mesmo assim** | A fatura é aberta e fica aguardando pagamento. A assinatura pode entrar em atraso até o cliente pagar. |
| **Pausar** | A assinatura é pausada e nenhuma cobrança é gerada — o cliente fica esperando você retomar quando ele cadastrar um cartão. |
| **Cancelar** | A assinatura é encerrada no fim do trial. |
Isso te deixa decidir o tom do seu produto: insistir na cobrança, segurar o
cliente em pausa ou encerrar de forma limpa.
## Mantenha seu sistema em sincronia
Reaja a eventos para liberar o acesso no início e agir na hora certa perto do
fim do trial:
| Evento | Quando dispara |
| ----------------------------- | -------------------------------------------------------------------------------------------- |
| `subscription.created` | A assinatura foi criada; se nasceu em trial, `data.object.status` vem como `trialing`. |
| `subscription.trial.will.end` | O trial está perto de terminar — ótimo gatilho para lembrar o cliente de cadastrar o cartão. |
| `subscription.updated` | O estado mudou, incluindo virar `active`, entrar em atraso ou trocar o método de pagamento. |
| `subscription.paused` | A política de fim de trial colocou a assinatura em pausa. |
| `subscription.canceled` | A política de fim de trial encerrou a assinatura. |
## Próximos passos
Como o trial se encaixa no ciclo de vida completo da assinatura.
Mudanças de plano no meio do ciclo, depois que o cliente já está pagando.
O contrato técnico do trial: dias, data fixa e política de fim de período.
O cliente e seus métodos de pagamento durante e depois do trial.