Token Migration

Migrate Mastercard tokens

post

Migrate mastercard M4M tokens to Secure Card on File

ETP contacts the Scheme TSP to migrate the network token.

Parámetros de ruta

oldTokenIdstring · máx: 128Requerido

Old token identifier.

Parámetros de encabezado

authorizationstring · mín: 1 · máx: 512Requerido

Technical identifier pre-defined at on-boarding that identifies the API consumer. Format shall be the string 'APIKEY' followed by a space and the api key value.
Example: APIKEY c03f88fe-01ba-11e8-ba89-0ed5f89f718b

x-correlation-idstring · mín: 1 · máx: 36Requerido

Technical identifier used for troubleshooting.
It helps on customer support when needed.
Each API request must be identified with a unique correlation Id.
It correlates the response and the request and eventually a notification if any.

Respuestas

201

OK

application/json

newTokenIdstring · mín: 1 · máx: 128Requerido

The token identifier.

Pattern: ^[a-zA-Z0-9_-]+$

cardLastDigitsstring · máx: 5Opcional

The card last digits.

Example: 2366

cardExpiryDatestring · máx: 4Opcional

The card expiry date in format MMYY.

Example: 0420

tokenStatestring · enum · máx: 64Requerido

Token state.

Example: ACTIVEValores posibles:

tokenLastDigitsstring · máx: 5Opcional

The token last digits.

Example: 5589

tokenExpiryDatestring · máx: 4Opcional

The token expiry date in format MMYY. This information can be missing. It is intended for display only at this step.
Rely on token expiry date in create transaction response for storage.

Example: 1022

parstring · máx: 29Opcional

Payment Account Reference returned by the Scheme TSP.

Example: 5001a9f027e5629d11e3949a0800a

creationTimestampstring · máx: 64Requerido

Token creation timestamp compliant with ISO 8601.

Example: 2025-11-10T09:08:24.479Z

400

Bad request - Not Retryable

application/json

401

Unauthorized - Not Retryable

404

Not Found - Not Retryable

429

Too Many Requests - Retryable

500

Internal Server Error - Not Retryable

503

Service Unavailable - Retryable

post/tokens/migration/{oldTokenId}

HTTPcURLJavaScriptPython

POST /tsh-cof/tokens/migration/{oldTokenId} HTTP/1.1
Host: thales.api.com
authorization: text
x-correlation-id: text
Accept: */*

{
  "newTokenId": "COFTG-MS-ce464906-cf39-4990-b4a8-c160e67c603a",
  "cardLastDigits": "2366",
  "cardExpiryDate": "0426",
  "tokenLastDigits": "5589",
  "tokenExpiryDate": "1036",
  "tokenState": "ACTIVE",
  "par": "5001a9f027e5629d11e3949a0800a",
  "cardProduct": {
    "issuerName": "Bank Name",
    "cardType": "DEBIT",
    "cardDescription": "The card description.",
    "cardArts": {
      "foregroundColor": "7FB8C8",
      "cardImageUrl": "https://stage.assets.mc.com/card-art/combined-image-asset/MyBank-mastercard.png"
    }
  },
  "creationTimestamp": "2025-11-10T09:08:24.479Z"
}