Query Tokens

Use to get the list of card tokens for the specified customer.

Endpoint URL	Route
Base URL	api/v1/tokenization/queryTokens

Example:

https://uat-secure.galaxypay.vn/api/v1/tokenization/queryTokens

Request Message

Header

Level	Field Name	Data Type	Description
1	apiKey	Alphanumeric mandatory	Request authenticate
1	signature	Alphanumeric mandatory	Request signature

Body

Level	Field Name	Data Type	Description
1	requestID	Alphanumeric(50) mandatory	Unique ID for each transaction request Recommend: GUID
1	requestDateTime	Numeric(14) mandatory	yyyyMMddHHmmss
1	requestData	JSON Object
2	customerToken	Alphanumeric mandatory	Customer identify information that is use for management the linked payment tokens.

{
  "requestID": "5761427cf75240f399cdf9d3a39580d4",
  "requestDateTime": "20230727095807",
  "requestData": {
    "customerToken": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICI5NXU2MzRKYkZ4VnlBOTVwLVA3ZnpiS3NzcEFhaUFHYmdpcVBmbGktcG9RIn0.eyJleHAiOjE2OTEwMzE0NjMsImlhdCI6MTY5MDQyNjY2MywianRpIjoiMzljNzhhMmMtYTIzOS00ODgyLWIzNTMtMjUyZWVlNTgxYTY2IiwiaXNzIjoiaHR0cHM6Ly9pZC51YXQuZ2FsYXh5am95LnZuL3JlYWxtcy91YXQtbG95YWx0eSIsImF1ZCI6ImFjY291bnQiLCJzdWIiOiIxOTIyZGFmZS03MDZjLTQzNDAtODU1NS1mMzBmNjA0NTk0ZDMiLCJ0eXAiOiJCZWFyZXIiLCJhenAiOiI4MjEwZGFiZi02OWQ1LTQxZGEtYjNjNS1lZGY4M2YyNzJhNGQiLCJzZXNzaW9uX3N0YXRlIjoiNWVhMjNmOWItNDc4MC00MGExLWFiYjMtZTVhMDk5MWQwNWMwIiwiYWNyIjoiMSIsImFsbG93ZWQtb3JpZ2lucyI6WyJodHRwczovL3d3dy5nYWxheHlwYXkudm4iXSwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbIm9mZmxpbmVfYWNjZXNzIiwiZGVmYXVsdC1yb2xlcy11YXQtbG95YWx0eSIsInVtYV9hdXRob3JpemF0aW9uIl19LCJyZXNvdXJjZV9hY2Nlc3MiOnsiYWNjb3VudCI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsIm1hbmFnZS1hY2NvdW50LWxpbmtzIiwidmlldy1wcm9maWxlIl19fSwic2NvcGUiOiJwcm9maWxlIGVtYWlsIiwic2lkIjoiNWVhMjNmOWItNDc4MC00MGExLWFiYjMtZTVhMDk5MWQwNWMwIiwiZW1haWxfdmVyaWZpZWQiOmZhbHNlLCJuYW1lIjoiSkF3Y08gTkdVWUVOIFZBTiIsInByZWZlcnJlZF91c2VybmFtZSI6Iis4NDkwNjQwNDcxNCIsImxvY2FsZSI6InZpIiwiZ2l2ZW5fbmFtZSI6IkpBd2NPIiwiZmFtaWx5X25hbWUiOiJOR1VZRU4gVkFOIiwiZW1haWwiOiJ0aXRyYW4wNjM0NTZAZ21haWwuY29tIn0.fXZU94yL7L4q1DkkTRgzYzivJMIZoB7pc5uQuAeqZqsWGPpOxjGwQQIZ2RaVTgfSArixLIp4NdjpDF4o_ei8YiXk5_QwF7bMQTMiO-ruDMWZzipbZHGBPH7KEd_Qz_kGHdzmU_phBHkVzBB9D7zIU3U69RwyuAC4zPYsrw_tbgF2V3y2WKXwuZJs3whsta4h616EQbh101NCq2dfZw1X_X287EQUie8B8DGLyJEAaMMobzKtnmH9CtWcDfonob54YFnjo8yeA2cGpuSpcA3htan8w_IdoeLhVeHQguuGllw0SocDQkp_OmxiJhbiy1JA6QWpI-0ZT10cJDaMLjaoyQ"
  }
}

Response Message

Header

Level	Field name	Data Type	Description
1	signature	Alphanumeric mandatory	Response signature

Body

Level	Field name	Data type	Description
1	requestID	Alphanumeric(50) mandatory	Original Request ID
1	responseDateTime	Numeric(14) mandatory	yyyyMMddHHmmss
1	responseCode	Numeric(3) mandatory	See Response Codes for more detail
1	responseMessage	Alphanumeric(250) mandatory	Response message
1	responseData	JSON Object mandatory	Response data
2	customerID	Alphanumeric(50) mandatory	Customer ID
2	customerName	Alphanumeric(50) mandatory	Customer Name
2	tokens	JSON Array mandatory	Linked Card Tokens
3	tokenID	Numeric(10) mandatory	Card Token ID
3	accountBrand	Alphanumeric(50) mandatory	Card Brand info
3	accountSource	Alphanumeric(50) mandatory	Card Issuer info
3	accountNumber	Alphanumeric(50) mandatory	Card Masked Number
3	accountName	Alphanumeric(50) mandatory	Cardholder name

{
  "requestID": "5761427cf75240f399cdf9d3a39580d4",
  "responseDateTime": "20230727095809",
  "responseCode": "200",
  "responseMessage": "Transaction is successful.",
  "responseData": {
    "customerID": "1922dafe-706c-4340-8555-f30f604594d3",
    "customerName": "LU THI THIEU HOA",
    "tokens": [
      "tokenID": "784",
      "accountBrand": "VISA",
      "accountSource": "HD BANK",
      "accountNumber": "445653xxxxxx1096",
      "accountName": "LU THI THIEU HOA"
    ]
  }
}