Recorrência

O Gateway de Pagamento permite a criação de recorrências para pagamentos com cartão de crédito

Meio de pagamento aceito: cartão de crédito.

O que é recorrência?

A recorrência é um serviço de cobrança periódica para estabelecimentos que precisam cobrar regularmente por seus produtos e/ou serviços. Costuma ser utilizada para assinaturas de revistas, mensalidades e licenças de software, entre outros.

Cada loja pode configurar os parâmetros da recorrência como a periodicidade, data de início e fim, quantidade de tentativas e intervalo entre elas, entre outros.

É possível configurar até quatro tentativas de cobrança para uma transação que não seja aprovada inicialmente.

Benefícios da recorrência

  • O Gateway de Pagamento gerencia as cobranças agendadas;
  • Não sensibiliza o limite de crédito do comprador;
  • É possível ajustar a parametrização sempre que necessário.

Como funciona?

Existem duas formas de realizar pedidos recorrentes:

  • Autorizar uma transação e agendar as próximas recorrências;
  • Agendar uma recorrência.

Características

  • É possível criar transações recorrentes com o meio de pagamento cartão de crédito;
  • Uma transação recorrente não pode ser parcelada;
  • Há custo de contratação e por cada transação analisada pelo antifraude.

Vendas recorrentes com cartão de crédito não exigem CVV.

⚠️

Atenção

  • A recorrência não está disponível para transações de e-wallets devido à necessidade de utilização de chaves temporárias para realizar operações de crédito;
  • Por questões de segurança, a recorrência só é possível para cartões que passem pela checagem do Algoritmo de Luhn, também conhecido como "mod10".

É possível realizar as seguintes operações relacionadas à transações recorrentes:

  • Autorizar recorrência com cartão de crédito;
  • Agendar autorizações futuras;
  • Agendar ajuste de valor na recorrência programada;
  • Deletar ajuste de valor de recorrência programada;
  • Alterar ajuste de valor de uma recorrência programada;
  • Alterar dados do comprador;
  • Alterar a data final da recorrência;
  • Alterar intervalo da recorrência;
  • Alterar o dia da recorrência;
  • Alterar o valor da transação da recorrência;
  • Alterar a data do próximo pagamento;
  • Alterar os dados de pagamento da recorrência;
  • Desabilitar um pedido recorrente;
  • Reabilitar um pedido recorrente.

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 (VerifyCard) e enviado, obrigatoriamente, nas transações recorrentes seguintes de todas as bandeiras. Saiba mais em Identificadores da bandeira para adquirente Cielo.

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.

FaseDataDescrição
Fase 1VigenteDisponibilização do TransactionLinkId na resposta da validação de cartão por VerifyCard, 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 2A partir de 23/10/2026Envio obrigatório do TransactionLinkId no request (MIT).

Saiba mais em Identificadores da bandeira para adquirente Cielo.

Como habilitar a recorrência?

  1. Entre em contato com a adquirente para configurar a opção da recorrência;
  2. Consulte a Referência da API do Gateway de Pagamento para conhecer os detalhes da integração de recorrência e as operações possíveis.

Did this page help you?