EBANX Mastercard Transaction Link Identifier support
How the TLID works
A TLID is a network-generated identifier that links an initial customer-initiated transaction (CIT) to later related transactions, such as recurring merchant-initiated transactions (MITs). When EBANX returns the value, Zuora stores the TLID with the stored credential profile, together with the Network Transaction Identifier (NTI).
For an eligible subsequent Mastercard MIT, including a recurring payment, Zuora automatically retrieves the stored TLID and sends it to EBANX. You don't need to enter or send the TLID manually for a supported transaction flow.
The TLID complements the NTI. Zuora continues to use the NTI where required. The TLID doesn't replace the NTI.
Supported scope
TLID support applies to the following:
-
EBANX credit card payment methods that use Mastercard.
-
New and existing Mastercard payment methods.
-
Customer-initiated and merchant-initiated stored credential transactions.
-
3D Secure 2.0 (3DS2) and non-3DS2 payment flows.
-
Recurring merchant-initiated payments and other eligible subsequent transactions that the EBANX integration supports.
How Zuora handles the TLID
Zuora handles the TLID as follows:
-
During a qualifying Mastercard CIT, EBANX returns the TLID when it's available.
-
Zuora stores the TLID with the stored credential profile and retains the existing NTI behavior.
-
For a later eligible Mastercard MIT, Zuora retrieves the stored TLID and includes it in the request to EBANX.
-
If a later qualifying transaction returns a TLID for an existing payment method that doesn't yet have one, Zuora stores the value for subsequent eligible transactions.
Configuration requirements
No separate TLID configuration is required in Zuora. Configure the EBANX gateway and stored credential processing as described in EBANX payment gateway integration and Stored credential transactions.
You must establish the required customer consent agreement for storing payment credentials outside of Zuora, as described in the Stored credential transactions documentation.
For more information, see Overview of support for stored credential transactions.
Limitations
Note the following limitations:
-
TLID handling depends on the Mastercard transaction flow and the TLID that EBANX returns.
-
This enhancement applies to Mastercard credit card transactions through EBANX. It doesn't change the behavior for other card brands or EBANX payment methods, such as PIX.
-
Existing payment methods without a stored TLID require a later qualifying transaction before Zuora can store and reuse a TLID. Zuora doesn't backfill TLIDs proactively.