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

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"
}