Mastercard Transaction Link Identifier (TLID)

🚧

Mandatory for all lifecycle transaction starting from October 23, 2026

The Transaction Link Identifier (TLID) is a unique identifier assigned by Mastercard to link related transactions together across the lifecycle of a payment. Our gateway will automatically apply the mapping from the referenced transaction to the original transaction in case of:

• Incremental / decremental preauthorization
• Preauthorization completion
• Partial / full refund
• Reversal (void)
• Recurring transactions scheduled via the gateway

In case of merchant-initiated transactions (MIT) (see link) the gateway is technically not able to include the TLID.

Therefore, you will need to include the TLID in the referenced transaction.

Response to original transaction:

In REST API you will receive the TLID in transactionLinkIdentifier of the transactionResponse

Request for a referenced transaction:

You will need include the TLID from the original transaction in storedCredential.referencedTransactionLinkIdentifier.