Skip to main content
Ofertas recorrentes permitem que você cobre seus clientes de forma automática em intervalos definidos, ideal para assinaturas de cursos com mensalidade, plataformas SaaS, clubes de conteúdo e qualquer modelo que dependa de receita previsível. Ao usar charge_type: "recurring", a Ticto gerencia todo o ciclo de cobrança: tentativas automáticas, notificações ao assinante e cancelamentos.

​
O objeto recurrence

Quando charge_type é "recurring", o campo recurrence é obrigatório. Ele define as regras de cobrança da assinatura.
​
string
required
Frequência com que o cliente será cobrado. Valores aceitos: monthly, quarterly, semiannually, annually.
​
integer
Número de dias de acesso gratuito antes da primeira cobrança. Use 0 para não oferecer período trial. Quando definido, o cliente tem acesso imediato ao produto mas só é cobrado após o período de trial expirar.
​
integer | null
Número total de cobranças antes de encerrar a assinatura automaticamente. Use null para uma assinatura sem data de término (infinita). Exemplo: cycles: 12 em um plano mensal resulta em exatamente 12 meses de cobrança.

​
Exemplo: plano anual com trial

O exemplo abaixo cria um plano anual de R$ 497,00 com 7 dias de acesso gratuito e sem limite de ciclos. A assinatura se renova anualmente até ser cancelada.
A resposta 201 Created confirma a criação da oferta, já ativa e com o link de checkout disponível. O corpo de resposta é o mesmo de qualquer oferta: o preço e a recorrência que você enviou não são repetidos no retorno.

​
Intervalos disponíveis

Escolha o intervalo que melhor se adapta ao seu modelo de negócio. Você pode criar múltiplas ofertas para o mesmo produto com intervalos diferentes, como um plano mensal e um anual com desconto.

​
Período de trial

Quando trial_days é maior que 0, o cliente recebe acesso imediato ao produto sem ser cobrado. A primeira cobrança ocorre somente após o período trial expirar. Isso reduz a fricção na conversão e permite que o assinante experimente antes de pagar.
Nesse exemplo, o cliente tem 7 dias gratuitos e, em seguida, é cobrado R$ 97,00 todo mês até cancelar.

​
Ciclos limitados

Por padrão, assinaturas com cycles: null renovam indefinidamente até que o assinante ou o vendedor cancele. Quando você precisa de uma assinatura com prazo determinado, como um parcelamento ou um plano de 12 meses fixos, defina cycles como um inteiro positivo.
Nesse exemplo, o cliente é cobrado 12 vezes de R$ 47,00 (totalizando R$ 564,00) e a assinatura é encerrada automaticamente após o último ciclo, sem necessidade de cancelamento manual.
A cobrança recorrente é uma configuração da oferta (charge_type: "recurring"), não do produto. Qualquer produto digital da v2 pode ter ofertas recorrentes. O intervalo aceito é monthly, quarterly, semiannually ou annually.

Referência: Criar Oferta

Veja todos os campos aceitos, validações e exemplos de resposta na documentação completa do endpoint.

Criar Oferta Única

Prefere cobrar uma única vez? Veja como criar ofertas de pagamento único com checkout imediato.