Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
MDES Token Connect [Beta]

Get eligible token requestors

Retrieve information about token requestors that have been enabled for one or more of the issuer's account ranges.

Pismo acts as a proxy for the <a href="https://developer.mastercard.com/mdes-token-connect/documentation/api-reference/" target="_blank">Mastercard Token Connect API</a>

For more information, refer to the MDES Token Connect guide.

post/v1/token-connect

Headers

access_tokenstring required

Access token. Tokens can expire quickly, which can result in a 401 Unauthorized error.

x-tenantstring required

Pismo organization/tenant ID

Request body

accountsstring[] required

Account ranges to check for eligibility.

The starting numbers are numeric strings between 9 and 19 in length. If the starting numbers are less than 19, MDES zero pads the starting numbers to 19 in length. The padded value must exactly match the account range start number enabled for the token requestor.

Example request

{
  "accounts": [
    "5412346789",
    "5412346780"
  ]
}

Response

Successful response

Example response

{
  "token_requestors": [
    {
      "token_requestor_id": "01234567890",
      "name": "Acme Widgets, Inc.",
      "consumer_facing_entity_name": "Acme Widgets Online",
      "token_requestor_type": "MERCHANT",
      "wallet_id": "123",
      "available_push_methods": [
        {
          "type": "WEB",
          "uri": "https://tokenize.example.com"
        }
      ]
    }
  ]
}