Autoriza uma recorrência com cartão de crédito
Ambiente | Método | Endpoint |
|---|---|---|
Sandbox | post |
|
Produção | post |
|
Saiba mais sobre essa funcionalidade na documentação.
Adicione o nó RecurrentPayment ao nó Payment para configurar uma recorrência ao autorizar uma transação pela primeira vez na série de recorrências.
CNPJs alfanuméricos serão implementados pela Receita Federal em julho de 2026Essa mudança afeta apenas novas inscrições, não havendo mudanças em CNPJs existentes.
O CNPJ alfanumérico já está sendo suportado pela Cielo, sem mudanças na sua integração.
Recomendamos verificar a necessidade de possíveis ajustes nos sistemas próprios de checkout de sua loja.
Identificadores de bandeira: na recorrência programada, os campos
IssuerTransactionIdeTransactionLinkIdsão enviados automaticamente nas transações seguintes. Em sandbox, esses campos só são retornados com o providerSimuladoe cenário de transação autorizada. 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 CIT, usado para vincular as transações MIT relacionadas. O TLID vale para a resposta do VerifyCard (apenas resposta) e para as transações de crédito, débito e recorrência.
Na Mastercard, envie IssuerTransactionId e TransactionLinkId juntos nas transações MIT: os dois parâmetros são obrigatórios.
| Fase | Descrição |
|---|---|
| Fase 1 | Vigente. O campo TransactionLinkId está disponível 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 | Envio obrigatório do TransactionLinkId no request (MIT) a partir de 23/10/2026. |
Recorrência programada: nas transações seguintes, os campos
IssuerTransactionIdeTransactionLinkIdsão enviados automaticamente.
O TransactionLinkId enviado no request deve ter exatamente 22 caracteres (A-Z, a-z, 0-9, hífen e sublinhado). Se o valor estiver fora desse formato, a Cielo o ignora, sem retornar erro. Quando a Cielo envia o TLID à bandeira, a resposta traz também o SentTransactionLinkId, com o valor enviado. O request do VerifyCard não aceita o campo.
Saiba mais em Identificadores da bandeira para adquirente Cielo.
Resposta da transação de pagamento recorrente
A tabela a seguir apresenta os principais parâmetros que podem ser retornados pela API na criação de um pagamento recorrente.
Propriedade | Descrição | Tipo | Tamanho |
|---|---|---|---|
| ID que representa a recorrência, utilizada para consultas e alterações futuras. | string | 36 |
| Data de quando acontecerá a próxima recorrência. | string | 10 |
| Data do fim da recorrência. | string | 10 |
| Intervalo entre as recorrências. | string | 10 |
| Define se a primeira recorrência já irá ser autorizada ou não. | booleano | |
| Retorno de status da conta Mastercard
| string | |
| Identificador da transação gerado pela bandeira e retornado na resposta da transação CIT. Armazene o valor para enviá-lo nas transações MIT seguintes: o envio é obrigatório, para todas as bandeiras, em transações recorrentes, incrementais e reautorizadas. Consulte mais informações em Identificadores da bandeira para adquirente Cielo. | string | 30 |
| Identificador único (TLID) gerado pela Mastercard e retornado na resposta, usado para vincular a transação CIT às transações MIT seguintes. Na Mastercard, envie o Formato: 22 caracteres alfanuméricos (A-Z, a-z), com diferenciação entre maiúsculas e minúsculas e podem incluir hífens (-) e sublinhados (_). | string | 22 |
Campos retornados pelo Renova Fácil
Caso a loja tenha o Renova Fácil ou o ABU habilitado, e exista um novo cartão disponível, os dados atualizados serão retornados no nó NewCard da resposta.
Propriedade | Descrição | Tipo | Tamanho |
|---|---|---|---|
| Novo número do cartão do comprador. | string | 16 |
| Nova data de validade do cartão. | string | 7 |
| Bandeira do cartão. | string | 10 |
| Identifica se o cartão gerou | booleano |
Adquirente Rede
- Para o provider Rede2, a resposta irá retornar o
BrandTransactionId, que é o identificador de transações recorrentes junto às bandeiras na adquirente Rede.- A cada nova transação da sequência de recorrências é necessário informar o
BrandTransactionId.- Para bandeiras Visa ou Elo informe o
BrandTransactionIdrecebido na primeira transação.- Para bandeira Mastercard informe o
BrandTrasactionIdrecebido na primeira transação ou na transação anterior.- O valor do
BrandTransactionIdserá novo a cada resposta da transação recorrente.
Meio de pagamento aceito: cartão de crédito.