Query saved tokens

Use this endpoint to retrieve all saved tokens associated with a specific merchant user.

Endpoint summary

Path: /tokenization/query-token
Method: POST
Content-Type: application/json

Request parameters

Parameter	Type	Mandatory	Description
merchantId	String	M	Merchant identifier
userId	String(56)	M	Merchant's user identifier, value is case sensitive

Request example

{
  "request": "{\"merchantId\":3,\"userId\":\"user1\"}",
  "signature": "<signature-generated-for-this-exact-payload>"
}

Response parameters

Parameter	Type	Mandatory	Description
responseCode	String	M	Payment Gateway response code
message	String	M	Payment Gateway response message
list	Array	M
list[index].tokenId	Number	M	Token identifier
list[index].userId	String	M	Merchant's user identifier, value is case sensitive
list[index].maskedPan	String	M	Masked card number of the tokenized card

note

• Returns all tokens saved for the specified userId. Results are not paginated; all tokens are returned in a single response.

Response example

{
  "responseCode": "0000",
  "message": "SUCCESS",
  "list": [
    {
      "maskedPan": "4705********8101",
      "userId": "user1",
      "tokenId": 351,
      "cardBrand": "VISA",
      "cardSubBrand": "VISA_CREDIT",
      "expiryDate": "202403"
    },
    {
      "maskedPan": "4000********0028",
      "userId": "user1",
      "tokenId": 375,
      "cardBrand": "VISA",
      "cardSubBrand": "VISA_DEBIT",
      "expiryDate": "202312"
    }
  ]
}