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
IssuerTransactionIdO 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.
| Fase | Data | Descrição |
|---|---|---|
| Fase 1 | Vigente | Disponibilizaçã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 2 | A partir de 23/10/2026 | Envio obrigatório do TransactionLinkId no request (MIT). |
Saiba mais em Identificadores da bandeira para adquirente Cielo.
Como habilitar a recorrência?
- Entre em contato com a adquirente para configurar a opção da recorrência;
- 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.
Updated 12 days ago