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

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

Last updated