Recorrência

Diferente dos pagamentos com cartão de crédito tradicionais, os pagamentos recorrentes se repetem automaticamente por períodos e em intervalos determinados, cobrando sempre o mesmo valor de um mesmo cartão ou conta.

A recorrência é muito usada para assinaturas de revistas, mensalidades, licenças de software, entre outros. Além da integração técnica, é necessário que seu estabelecimento comercial esteja habilitado na adquirente para receber pagamentos recorrentes.

O lojista conta com recursos diferenciados para modelar sua cobrança de acordo com o seu negócio, tais como: parametrização e alteração de periodicidade, data de início e fim, quantidade de tentativas e intervalo entre tentativas.

⚠️

Atenção: O Cartão Protegido não salva o CVV do cartão.

Portanto:

• O comprador deverá preencher o CVV a cada transação, ou
• A sua loja pode realizar transações sem o CVV desde que esteja autorizada pela adquirente.

ℹ️

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".

Para submeter uma transação recorrente, envie a requisição conforme as orientações desta seção. A solicitação de split de uma transação com recorrência deve acontecer no momento pós-transacional.

Não é possível solicitar o split de uma transação recorrente no momento transacional.

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.

⚠️

Atenção: Não envie o valor do IssuerTransactionId no parâmetro TransactionLinkId, nem o valor do TransactionLinkId no parâmetro IssuerTransactionId. Os identificadores não são intercambiáveis e o envio trocado pode impactar a conversão da venda junto à bandeira.

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.

Notificação de transações recorrentes

Se a loja cadastrar uma URL de notificação no Post de Notificação, ela recebe uma notificação a cada transação gerada pelo motor de recorrência, conforme o exemplo a seguir.

{
   "RecurrentPaymentId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
   "ChangeType": 2,
   "PaymentId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}