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.
TLID Mastercard
O Transaction Link Identifier (TLID) é um identificador único gerado pela bandeira Mastercard durante uma transação, utilizado para estabelecer a continuidade entre transações relacionadas.
| Fase | Descrição |
|---|---|
| Fase 1 | Em breve disponibilizaremos o campo 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 | Envio obrigatório do TransactionLinkId no request a partir de 23/10/2026 (MIT). |
Saiba mais em Indicadores de bandeira.
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; deve ser enviado para referenciar a transação original/anterior em operações relacionadas, como em recorrências. Consulte mais informações em Identificadores da bandeira para adquirente Cielo | string | 30 |
| 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.