Sobre a recorrência

O que é a recorrência?

A recorrência é um modelo de cobrança periódica, geralmente mensal, e usada para serviços ou produtos programados/contínuos, como serviços de streaming, assinaturas e mensalidades para cobrar seus clientes de forma mais prática.

Qual é o impacto do uso no meu negócio?

Ao usar a recorrência, a loja tem a facilidade de gerar cobranças periódicas sem a necessidade do portador do cartão participar do processo mais do que uma vez. Com isso, a recorrência pode aumentar a conversão.

Como usar a recorrência?

Existem dois tipos de recorrência:

• Recorrência própria: quando a loja cria a própria inteligência de repetição de compra e armazena os dados do cartão. A loja deve criar a transação recorrente nas datas acordadas com o comprador. As transações recorrentes enviadas pela loja precisam ter a marcação de recorrência (Payment.Recurrent igual a true);
• Recorrência programada Cielo: quando a Cielo é responsável pela inteligência da repetição e armazenamento dos dados do cartão. A loja envia os detalhes de cobrança, período (mensal, semestral, anual etc) e a data final de recorrência. Com estas informações, a Cielo cria a recorrência e o valor da transação será cobrado na periodicidade escolhida até a data final.

Saiba mais sobre Recorrência Própria e Recorrência Programada.

Solicite a habilitação da funcionalidade para Suporte E-commerce.

ℹ️

Meios de pagamento aceito:

• Recorrência própria: cartão de crédito e débito;
• Recorrência programada Cielo: cartão de crédito.

O que não fazer?

• Não envie a primeira transação da recorrência sem o CVV ou o CardOnFile: a primeira transação da recorrência deve obrigatoriamente informar o CVV ou o CardOnFile;
• Não envie a transação com a função parcelada (mais de uma parcela) e recorrente ao mesmo tempo;
• Não envie pedidos recorrentes sem a marcação de recorrência (Payment.Recurrent para recorrência própria e RecurrentPayment para recorrência programada);
• Não envie uma transação recorrente usando cartão inválido: sempre valide o cartão no Zero Auth antes de criar a recorrência.

ℹ️

Importante

O motor de recorrência Cielo possui configurações de retentativas, podendo reprocessar transações negadas (exceto as irreversíveis) já considerando as regras do Programa de Retentativa das Bandeiras.

Identificadores de transações com credenciais armazenadas

Conforme as regras das bandeiras, as transações recorrentes exigem o envio de campos de identificação que vinculam cada cobrança à transação CIT original: o IssuerTransactionId (todas as bandeiras) e o TransactionLinkId (Mastercard). Na recorrência própria, envie também o Payment.OriginalRecurrentAmount. Na recorrência programada, os campos IssuerTransactionId e TransactionLinkId são enviados automaticamente nas transações seguintes.

Identificador das bandeiras: IssuerTransactionId

O identificador da bandeira (IssuerTransactionId) é um código retornado na resposta da transação CIT ou da validação do cartão (Zero Auth) e enviado, obrigatoriamente, nas transações recorrentes seguintes de todas as bandeiras. Saiba mais em Identificadores de bandeira.

TLID Mastercard

O Transaction Link Identifier (TLID), enviado e retornado no campo TransactionLinkId, é um identificador único gerado pela bandeira Mastercard durante uma transação. Esse identificador é criado na transação CIT e deve ser enviado, junto com o IssuerTransactionId, para relacionar todas as transações subsequentes (MIT) do mesmo ciclo.

Saiba mais em Identificadores de bandeira.