Payment Link
Use to create a dynamic payment link.
Integration
See integration detail in General integration steps
Base URL
api/v1/transaction/createPaymentLink
Example:
Request Message
Header
1
apiKey
Alphanumeric mandatory
Request authenticate
1
signature
Alphanumeric mandatory
Request signature
Body
1
requestID
Alphanumeric(50) mandatory
Unique ID for each transaction request
Recommend: GUID
1
requestDateTime
Numeric(14) mandatory
yyyyMMddHHmmss
1
requestData
JSON Object
2
orderID
Alphanumeric(50) mandatory
Transaction ID at Merchant
2
orderName
Alphanumeric(250) mandatory
Transaction Reference
2
orderAmount
Numeric(16) mandatory
Transaction Amount
2
orderDescription
Alphanumeric(250) mandatory
Transaction Description
2
expiryDuration
Integer mandatory
Payment link expiration
2
expiryUnit
Alpha optional
DAY or HOUR or MINUTE Default = DAY
2
paymentMethods
JSON Array mandatory
[
"GALAXYPAY",
"MPGS",
"QRPAY",
"MOMO",
"ZALOPAY",
"NAPAS"
]
2
paymentFields
JSON Array mandatory
[
"email",
"fullname",
"phone",
"shippingAddress"
]
2
ipnURL
Alphanumeric(500) optional
IPN URL
2
language
Alpha(2) optional
vi or en
vi: Vietnamese
en: English
{
"requestID": "7543669308d942569694bc2eb9e1117b",
"requestDateTime": 20250410094723,
"requestData": {
"orderID": "a8f400e2f53744f1a72f6676988a677a",
"orderName": "Payment for API Playground",
"orderAmount": 100000,
"orderCurrency": "VND",
"orderDescription": "API Playground Demo",
"expiryDuration": 3,
"expiryUnit": "DAY",
"paymentMethods": [
"GALAXYPAY",
"MPGS",
"QRPAY",
"MOMO",
"ZALOPAY",
"NAPAS"
],
"paymentFields": [
"mail",
"fullname",
"phone",
"shippingAddress"
],
"ipnURL": "https://uat-merchant.galaxypay.vn/api/ipn",
"language": "vi"
}
}'
Response Message
Header
1
signature
Alphanumeric mandatory
Response signature
Body
1
requestID
Alphanumeric(50) mandatory
Original Request ID
1
responseDateTime
Numeric(14) mandatory
yyyyMMddHHmmss
1
responseData
JSON Object mandatory
Response data
2
orderNo
Alphanumeric mandatory
GALAXY PAY order no
2
shortLink
Alphanumeric mandatory
Payment Link URL
1
responseMessage
Alphanumeric(250) mandatory
Response message
{
"requestID": "307826170e3e4a1b80430e074c7ba762",
"responseDateTime": 20250410094723,
"responseData": {
"orderNo": "3258202405201716180392818",
"shortLink": "https://example-payment..."
},
"responseCode": "200",
"responseMessage": "Success"
}
Last updated