API Changelog - 2026-07-17: Summary
Maestro and Mastercard payment method schemas now include a Transaction
Link Identifier (TLID) field. A new schemeTransactionLinkId field is
available in payment request bodies, and a new transactionLinkId field
appears in payment and transaction responses for these card schemes.
POST /v1/payments — Maestro Payment Request
The Maestro payment request body now supports a new
schemeTransactionLinkId field. This is the Transaction Link Identifier
(TLID) provided by Mastercard to link economically related transactions.
It is required for merchant-initiated transactions (MIT) in some regions
and must not be included for cardholder-initiated transactions (CIT).
| Property | Details |
|---|---|
| Name | paymentMethod.maestro.schemeTransactionLinkId |
| Location | Request body |
| Type | string |
| Required | No (required for MIT in some regions) |
| Format | 22-char alphanumeric (A-Z, a-z, 0-9), may include -, _ |
| Example | "7R9d3L2-Q9vS6pP1_WzEh" |
The Mastercard payment request body now supports a new
schemeTransactionLinkId field. This is the Transaction Link Identifier
(TLID) provided by Mastercard to link economically related transactions.
It is required for merchant-initiated transactions (MIT) in some regions
and must not be included for cardholder-initiated transactions (CIT).
| Property | Details |
|---|---|
| Name | paymentMethod.mastercard.schemeTransactionLinkId |
| Location | Request body |
| Type | string |
| Required | No (required for MIT in some regions) |
| Format | 22-char alphanumeric (A-Z, a-z, 0-9), may include -, _ |
| Example | "7R9d3L2-Q9vS6pP1_WzEh" |
GET /v1/payments/{paymentId} — Maestro Payment Response
The Maestro payment method detail in the payment response now includes a
transactionLinkId field in the scheme details object. This identifier
is assigned by the card scheme and links related transactions to the
original transaction. The field is only present when returned by the
scheme in the authorization response.
| Property | Details |
|---|---|
| Name | paymentMethod.scheme.transactionLinkId |
| Location | Response body |
| Type | string |
| Required | No (present only when returned by the scheme) |
| Format | 22-character string |
| Example | "7R9d3L2-Q9vS6pP1_WzEh" |
GET /v1/payments/{paymentId} — Mastercard Payment Response
The Mastercard payment method detail in the payment response now includes
a transactionLinkId field in the scheme details object. This identifier
is assigned by the card scheme and links related transactions to the
original transaction. The field is only present when returned by the
scheme in the authorization response.
| Property | Details |
|---|---|
| Name | paymentMethod.scheme.transactionLinkId |
| Location | Response body |
| Type | string |
| Required | No (present only when returned by the scheme) |
| Format | 22-character string |
| Example | "7R9d3L2-Q9vS6pP1_WzEh" |