Create Token

Use to create a card token. Only apply for Merchant using fast pay solution.

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

Example:

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

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	paymentMethod	Alphanumeric(50) mandatory	DOMESTIC or INTERNATIONAL
2	cardNumber	Numeric(19) mandatory	Card Number
2	cardHolderName	Alphanumeric(19) mandatory	Card Holder Name
2	cardExpireDate	Alphanumeric(5) mandatory	Card Expired Date
2	cardVerificationValue	Numeric(3) condition	Card CVV Only required when paymentMethod=INTERNATIONAL

{
  "requestID": "50a7f74d17424e43acf29cd002dfc6ee",
  "requestDateTime": "20230727104246",
  "requestData": {
    "paymentMethod": "INTERNATIONAL",
    "cardNumber": "5506922400634930",
    "cardHolderName": "HUYNH HUU LOC",
    "cardExpireDate": "01/39",
    "cardVerificationValue": "100"
  }
}

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	accountBrand	Alphanumeric(50) mandatory	Card Brand info
2	accountSource	Alphanumeric(50) mandatory	Card Issuer info
2	accountNumber	Alphanumeric(50) mandatory	Card Masked Number
2	accountName	Alphanumeric(50) mandatory	Cardholder name
2	token	Alphanumeric(50) mandatory	Card Token

{
    "requestID": "50a7f74d17424e43acf29cd002dfc6ee",
    "responseDateTime": "20230727104248",
    "responseCode": "200",
    "responseMessage": "Success",
    "responseData": {
        "token": "000138A96154A74E4FDF865116FF70184AA1",
        "accountBrand": "MASTER",
        "accountSource": "",
        "accountNumber": "550692xxxxxx4930",
        "accountName": "HUYNH HUU LOC"
    }
}