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.Recurrentigual 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 oCardOnFile; - 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.Recurrentpara recorrência própria eRecurrentPaymentpara 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.
ImportanteO 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 regras das bandeiras as transações recorrentes e com credenciais armazenadas podem exigir campos adicionais de identificação, como o IssuerTransactionId e TransactionLinkId. Saiba mais a seguir.
Identificador das bandeiras: IssuerTransactionId
IssuerTransactionIdO identificador da bandeira é um código de identificação para transações recorrentes ou com credenciais armazenadas retornado na resposta da autorização ou na resposta da validação do cartão (Zero Auth). Saiba mais em Identificadores de bandeira.
TLID Mastercard
O Transaction Link Identifier (TLID) é um identificador único gerado pela bandeira Mastercard durante uma transação. Esse identificador é criado na transação inicial (CIT) e deverá ser utilizado para relacionar todas as transações subsequentes (MIT) do mesmo ciclo.
| Fase | Data | Descrição |
|---|---|---|
| Fase 1 | 30/06/2026 | Disponibilização do TransactionLinkId na resposta da validação de cartão por Zero Auth, criação de pagamento com cartão de crédito ,criação de pagamento com cartão de débito e na consulta por PaymentId. |
| Fase 2 | 23/10/2026 | Envio obrigatório do TransactionLinkId no request (MIT) |
Saiba mais em TLID Mastercard.