Identificadores de bandeira

Algumas bandeiras retornam identificadores na resposta da autorização ou da validação de cartão (Zero Auth). Esses identificadores vinculam transações relacionadas ao longo do ciclo de pagamento, melhorando a taxa de aprovação em cenários de recorrência e credenciais armazenadas (Card on File).

Armazene sempre os identificadores retornados pela API para uso em transações subsequentes.

Identificador	Campo na API	Bandeiras
Identificador do emissor	`IssuerTransactionId`	Visa, Mastercard, Elo, American Express
Identificador de vínculo transacional	`TransactionLinkId` (TLID)	Mastercard

IssuerTransactionId

O IssuerTransactionId é um identificador gerado pelo emissor para associar uma transação original a operações futuras do mesmo portador. Ele melhora a taxa de aprovação porque o emissor reconhece o vínculo com uma transação anterior iniciada pelo portador (CIT).

Atenção: o valor do IssuerTransactionId pode mudar a cada nova autorização ou validação de cartão. Sempre armazene o identificador retornado na transação mais recente e use-o nas transações subsequentes.

Bandeiras: Visa, Mastercard, Elo e American Express.

Disponível nas respostas de: autorização de crédito, débito, recorrência, Zero Auth e consulta por PaymentId.

Exemplo de resposta:

{
  "Payment": {
    "Type": "CreditCard",
    "IssuerTransactionId": "580027442382078"
  }
}

TransactionLinkId (TLID)

O TransactionLinkId (TLID) é um identificador da bandeira Mastercard para vincular transações relacionadas dentro de um mesmo ciclo transacional. O envio do TLID é independente do IssuerTransactionId — ambos podem ser exigidos na mesma transação.

Bandeira: Mastercard.

Disponível nas respostas de: autorização de crédito, débito, recorrência, Zero Auth e consulta por PaymentId.

Exemplo de resposta:

{
  "Payment": {
    "TransactionLinkId": "mK8vT2qA-9LpX7dWc3Rf_HsD1Z"
  }
}

Fases de implementação do TLID

A implementação do TLID ocorre em duas fases:

Fase 1 — Disponibilização do TLID (em breve)

O TransactionLinkId passa a ser retornado nas respostas da API para transações Mastercard. Ação necessária: comece a armazenar o TLID para uso futuro.

Fase 2 — Envio obrigatório do TLID (23/10/2026)

O envio do TransactionLinkId passa a ser obrigatório em transações iniciadas pelo estabelecimento (MIT), referenciando a transação anterior (CIT ou MIT anterior).

Os parâmetros de envio do TLID nas requisições MIT serão disponibilizados nas APIs Cielo antes de outubro de 2026.

Uso em cenários CIT e MIT

Em cenários de credenciais armazenadas e recorrência:

CIT (Cardholder-Initiated Transaction): transação iniciada pelo portador — gera o identificador.
MIT (Merchant-Initiated Transaction): transação iniciada pelo estabelecimento — deve referenciar o identificador da CIT original ou da MIT anterior.