Result & IPN Callback
Result URL: Use for Merchant to show result for Customer. Support http method POST or GET
IPN URL: Use for Merchant to receive payment result and process business workflow.
Note:
Response Signature is create by applying hash algorithm SHA256 the response data with Salt.
signature = SHA256(data + salt)
Body
1
data
Alphanumeric mandatory
Base-64 string
1
signature
Alphanumeric mandatory
Response Signature signature = SHA256(data + Salt)
Data (Decode Base-64 String)
1
requestID
Alphanumeric(50) mandatory
Original Request ID
1
responseDateTime
Numeric(14) mandatory
yyyyMMddHHmmss
1
responseMessage
Alphanumeric(250) mandatory
Response message
1
responseData
JSON Object mandatory
Response data
2
transactionID
Alphanumeric(38) mandatory
GALAXY PAY transaction ID
2
transactionStatus
Numeric(14) optional
Only available in apiVersion 2 See Response Codes for more detail
2
transactionDescription
Alphanumeric(20) optiona
Only available in apiVersion 2
2
sourceType
Alphanumeric(20) optional
Only available in apiVersion 2 See Payment Method for more detail
2
orderID
Alphanumeric(50) mandatory
Transaction ID at Merchant
2
orderNumber
Alphanumeric(20) optional
Order Number or Bill Number
2
orderAmount
Numeric(16) mandatory
Order Amount
2
orderCurrency
Alpha(3) mandatory
Order Currency
2
orderDateTime
Numeric(14) mandatory
Order Date Time
yyyyMMddHHmmss
2
orderDescription
Alphanumeric(250) mandatory
Order Description
2
language
Alpha(2) mandatory
vi or en
vi: Vietnamese
en: English
2
tokenization
JSON Object optional
Only Return on IPN callback when
· Transaction is successful (ResponseCode = 200)
· APIOperation = PAY_WITH_CREATE_TOKEN
3
accountBrand
Alphanumeric(50) optional
Card Brand info
3
accountSource
Alphanumeric(50) optional
Card Issuer info
3
accountNumber
Alphanumeric(50) optional
Card Masked Number
3
accountName
Alphanumeric(50) optional
Cardholder name
3
token
Alphanumeric(50) optional
Card Token
3
status
Alphanumeric(3) mandatory
Token Creation Result
3
message
Alphanumeric(250) mandatory
Token Creation Message
RESPONSE DATA
{
"data": "eyJyZXF1ZXN0SUQiOiIxNDY1M2ZhMS0yZjY5LTRmNGYtOWQ0Yi0yNDBlMWJlYmJkZjMiLCJyZXNwb25zZURhdGVUaW1lIjoiMjAyMjA1MDYxMTM1MTciLCJyZXNwb25zZUNvZGUiOiIyMDAiLCJyZXNwb25zZU1lc3NhZ2UiOiJUcmFuc2FjdGlvbiBpcyBzdWNjZXNzZnVsLiIsInJlc3BvbnNlRGF0YSI6eyJ0cmFuc2FjdGlvbklEIjoiMjIwNTA2OTllNjVkOWE3MWQ1NDhlNmI2NzMyM2FlZjFhNDk0YWMiLCJ0cmFuc2FjdGlvbkRhdGVUaW1lIjoiMjAyMjA0MDUyMDIwMDAiLCJvcmRlcklEIjoiODg4Mjg5Iiwib3JkZXJOdW1iZXIiOiI4MjI2Mjg4OSIsIm9yZGVyQW1vdW50IjoiMTA5MDAwIiwib3JkZXJEZXNjcmlwdGlvbiI6IlNlY3VyZSBQYWdlIERlbW8iLCJvcmRlckN1cnJlbmN5IjoiVk5EIiwib3JkZXJEYXRlVGltZSI6IjIwMjIwNDA1MjAyMDAwIiwibGFuZ3VhZ2UiOiJ2aSJ9fQ==",
"signature": "724c1f76663cc0b119080e0b53eaae06615dd8586e34c15b3e96e61d6d729dcc"
}
VERIFY SIGNATURE
const data = "eyJyZXF1ZXN0SUQiOiIxNDY1M2ZhMS0yZjY5LTRmNGYtOWQ0Yi0yNDBlMWJlYmJkZjMiLCJyZXNwb25zZURhdGVUaW1lIjoiMjAyMjA1MDYxMTM1MTciLCJyZXNwb25zZUNvZGUiOiIyMDAiLCJyZXNwb25zZU1lc3NhZ2UiOiJUcmFuc2FjdGlvbiBpcyBzdWNjZXNzZnVsLiIsInJlc3BvbnNlRGF0YSI6eyJ0cmFuc2FjdGlvbklEIjoiMjIwNTA2OTllNjVkOWE3MWQ1NDhlNmI2NzMyM2FlZjFhNDk0YWMiLCJ0cmFuc2FjdGlvbkRhdGVUaW1lIjoiMjAyMjA0MDUyMDIwMDAiLCJvcmRlcklEIjoiODg4Mjg5Iiwib3JkZXJOdW1iZXIiOiI4MjI2Mjg4OSIsIm9yZGVyQW1vdW50IjoiMTA5MDAwIiwib3JkZXJEZXNjcmlwdGlvbiI6IlNlY3VyZSBQYWdlIERlbW8iLCJvcmRlckN1cnJlbmN5IjoiVk5EIiwib3JkZXJEYXRlVGltZSI6IjIwMjIwNDA1MjAyMDAwIiwibGFuZ3VhZ2UiOiJ2aSJ9fQ==";
const salt = "GO@2021";
const signature = SHA256(data + salt);
DECODE BASE-64 STRING FOR DATA
{
"requestID": "14653fa1-2f69-4f4f-9d4b-240e1bebbdf3",
"responseDateTime": "20220506113517",
"responseCode": "200",
"responseMessage": "Transaction is successful.",
"responseData": {
"transactionID": "22050699e65d9a71d548e6b67323aef1a494ac",
"transactionDateTime": "20220405202000",
"orderID": "888289",
"orderNumber": "82262889",
"orderAmount": "109000",
"orderDescription": "Secure Page Demo",
"orderCurrency": "VND",
"orderDateTime": "20220405202000",
"language": "vi"
}
}
Response Message (FOR IPN ONLY)
1
ipnStatus
Alphanumeric(50) mandatory
Response Code for IPN Request.
Accepted value:
200: Transaction Success
404: Transaction Not Found
409: Transaction Completed
1
ipnDescription
Alphanumeric(250) optional
Response Description
Last updated