Skip to main content
Online Payments

Payment brand changes

This page shows all the payment brand changes for Commerce platform and when they are going live.

October 1, 2026

Mastercard’s Transaction Link Identifier (TLID) is a 22-character unique identifier assigned to every new transaction (e.g. aRyU-3Ti981f_6WvBaqM03). The TLID is used to track and link related transaction activities across the payments lifecycle. 

The Online Payments API is adding the following fields to ensure compliance and reduce potential issuer declines:

TLID fields
Field name Description Format Location
transactionLinkId

The Mastercard-assigned unique identifier for the transaction.

  • Store this value and send it as the originalTransactionLinkId on any subsequent transactions linked to it.
  • Along with originalNetworkTransactionId and networkTransactionId, it supports Mastercard transaction-linking requirements.
Alphanumeric string that can contain hyphens (-) and underscores (_).

Response:

paymentMethodType.card.networkResponse

originalTransactionLinkId

The Mastercard transactionLinkId returned for the original transaction.

  • Use this value to link a merchant-initiated transaction to the original cardholder authorization. 
  • Along with originalNetworkTransactionId and networkTransactionId, it supports Mastercard transaction-linking requirements.
Alphanumeric string that can contain hyphens (-) and underscores (_).

Request:

paymentMethodType.card

paymentMethodType.consumerProfile

Attention

Starting December 1, 2026, deposit transactions will be considered non-compliant if the TLID is missing or incorrect. You must ensure to store and use the TLID in all subsequent related transactions. Mastercard will continue to support Trace ID, Banknet reference number, and switch serial number until further notice.

To learn more about how Mastercard TLID works across various transaction types and use cases, refer to Mastercard transaction link identifier.

Is this page helpful?