Skip to main content

Query Token


  • Description: Obtain details of the related token
  • Path: /tokenization/query-token
  • Method: POST
  • Request Header: Content-Type: application/json

Request Parameters

ParameterTypeRequired/optionalDescription
merchantIdstringRequiredMerchant identifier
userIdstringRequiredMerchant's user identifier, value is case insensitive

Example:

{
  "request": "{\"merchantId\":3,\"userId\":\"user1\"}",
  "signature": "JGV/lwuVGhmSh3y00MzQpXQ9VcOhVwDwSgrOqXyAJl4OVtaJRWWZwqyNPZnRZr3v0I4Ne0ZlOIJPb1Krkqo10+1qmp8b2eaR+FYenWdMf0dDiiVOYycLznTLlvcmyu4pDYpEw10DCwsmblSVsG/wpdVeeB92JEw00sBE8a84Pzl/JmoB8C/yO2NCuxnMfaJsqO3mclGdoo8+IVHZLSSaW3Y6RmZ01HKeCm6akXBr70+PKV5YC9RGJwDDSZcaHXAFnYx2eod8aC10LucJMf88SjBORqdKZBnsJboQqGzBzaul2aactLUNyTKC206LhzleEmK7/Xi9U+FSY10xe54z8Q=="
}

Response Parameters

ParameterTypeRequired/optionalDescription
responseCodestringRequiredPayment Gateway response code
messagestringRequiredPayment Gateway response message
listarrayRequired 
list[index].tokenIdnumberRequiredToken identifier
list[index].userIdstringRequiredMerchant's user identifier, value is case insensitive
list[index].maskedPanstringRequiredMasked card number of the tokenized card

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