TLID Mastercard

O que é o TLID

O Transaction Link Identifier (TLID) é um identificador único gerado pela bandeira Mastercard durante uma transação, usado para estabelecer a continuidade entre transações relacionadas.

Exemplos de uso

O TLID deve ser utilizado em cenários como:

• Pagamentos recorrentes;
• Parcelas futuras;
• Cobranças pós-autorização;
• Transações com cartão armazenado (card-on-file).

Como funciona o TLID na Cielo

Fluxo geral

1. O cliente realiza uma transação inicial (CIT).
2. A transação é autorizada pela bandeira/emissor.
3. A bandeira Mastercard retorna o TLID.
4. A Cielo retorna o TLID na resposta da API.
5. O estabelecimento armazena o TLID.
6. A partir de 23/10/26: Em transações futuras (MIT), o estabelecimento deverá enviar o TLID para manter o vínculo.

ℹ️

Objetivo do TLID: garantir que transações subsequentes sejam reconhecidas como pertencentes ao mesmo contexto transacional, conforme exigido pela bandeira Mastercard.

Fases de implementação

A disponibilização do TLID na Cielo ocorrerá em duas fases:

Fase 1: disponibilização do TLID (01/07/2026)

A partir dessa data:

• O TLID passa a ser retornado nas respostas de transações Mastercard para as seguintes operações:
  • Validação de cartão com Zero Auth ;
  • Transações de cartão de crédito;
  • Transações de cartão de débito;
  • Transação de recorrência;
  • Consulta por PaymentId. A consulta por PaymentId permite recuperar o identificador caso não tenha sido armazenado anteriormente.

Exemplo do campo retornado:

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

Objetivo da fase 1: permitir que o estabelecimento comece a armazenar o TLID para uso futuro.

Fase 2: envio obrigatório do TLID (23/10/2026)

A partir dessa data:

• O envio do TLID passa a ser obrigatório em transações iniciadas pelo estabelecimento (MIT);
• O TLID deve ser enviado na requisição para referenciar a transação anterior, seja ela iniciada pelo portador (CIT) ou pelo estabelecimento (MIT).

Objetivo da fase 2: garantir conformidade com as regras da Mastercard para vínculo transacional.

*Os parâmetros para envio do TLID a partir de outubro serão disponibilizados nas APIs Cielo em breve.

⚠️

O uso do TransactionLinkId não anula a necessidade de envio do IssuerTransactionid . Saiba mais em Identificadores da bandeira