Recorrência

A recorrência permite cobrar automaticamente um cliente em intervalos definidos, sem a necessidade de uma nova ação de pagamento a cada cobrança. Esse modelo é indicado para assinaturas, mensalidades, planos de serviços e qualquer produto com cobrança periódica.

A funcionalidade Recorrência Programada está disponível nos produtos Checkout Cielo e Link de Pagamento, com diferentes formas de configuração e gerenciamento. Na Recorrência Programada, basta que a loja defina que uma transação deve se repetir, que o Checkout vai executá-la novamente no intervalo definido.

Diferença entre transação recorrente e parcelada

Embora ambas gerem cobranças ao longo do tempo, transações recorrentes e parceladas afetam o limite do cartão de formas diferentes.

Critério	Transação recorrente	Transação parcelada
Comprometimento do limite	Apenas o valor da cobrança atual	Valor total da compra
Liberação do limite	Após o processamento de cada cobrança	Conforme as parcelas são pagas
Exemplos	Assinaturas, mensalidades, planos de serviço	Compras de maior valor parceladas

Exemplo de transação recorrente: uma assinatura de seguro de R$ 100,00 cobrada mensalmente durante um ano. A cada ciclo, apenas R$ 100,00 compromete o limite do cartão.

Exemplo de transação parcelada: uma geladeira de R$ 2.000,00 paga em 10 parcelas de R$ 200,00. O valor total da compra compromete o limite do cartão desde a aprovação da transação.

Retentativa em transações recorrentes

Quando uma cobrança recorrente é negada, o sistema realiza automaticamente até quatro retentativas, com intervalo de quatro dias entre cada tentativa. Essas regras são fixas e não podem ser alteradas pela loja.

A retentativa ocorre apenas quando o código de resposta é considerado reversível pela bandeira. Caso contrário, nenhuma nova tentativa é realizada.

⚠️
O excesso de tentativas não aprovadas pode implicar em multas.
Um número excessivo de tentativas não aprovadas pode gerar multas. As bandeiras definem suas próprias regras e valores para esse tipo de ocorrência. Consulte o Programa de Retentativa das Bandeiras.

Recorrência no Checkout Cielo

No Checkout Cielo, a recorrência é criada por meio da API durante a geração da página de pagamento.

Para criar uma cobrança recorrente, inclua o nó Payment.RecurrentPayment na requisição. A recorrência é criada somente se a primeira transação for autorizada.

É possível configurar o intervalo entre transações da recorrência no campo Payment.RecurrentPayment.Interval e definir uma data de finalização da recorrência em Payment.RecurrentPayment.EndDate .

Recorrência no Link de Pagamento

No Link de Pagamento, a recorrência pode ser configurada de três formas:

via site Cielo: ative a opção Cobrança recorrente ao gerar um Link de Pagamento;
via app Cielo Gestão: preencha os campos indicados como obrigatórios para recorrências;
via API: envie o objeto recurrent na requisição para criar um link de pagamento, com os campos recurrent.interval e recurrent.enddate para configurar o intervalo entre transações da recorrência e definir uma data de finalização da recorrência.

Gestão de recorrências

Após criar uma recorrência via Checkout ou Link de Pagamento, você pode acompanhar seu status, atualizar informações ou interromper novas cobranças quando necessário.

As operações de gestão de recorrências estão disponíveis via API e Site Cielo:

via Site Cielo: consulte Relatório de Recorrência para acompanhar, atualizar ou desativar recorrências;
via API:

❗️
Uma vez que a recorrência for desativada, não é possível ativá-la novamente. Por isso, tenha certeza dessa ação antes de realizar a desativação.