Payment Link

Use to create a dynamic payment link.

Integration

See integration detail in General integration steps

Refer to the Code Samples and API Playground for detailed sample code and API testing.

Endpoint URL	Route
Base URL	api/v1/transaction/createPaymentLink

Example:

https://uat-secure.galaxypay.vn/api/v1/transaction/createPaymentLinkuat-secure.galaxypay.vn

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	orderID	Alphanumeric(50) mandatory	Transaction ID at Merchant
2	orderName	Alphanumeric(250) mandatory	Transaction Reference
2	orderAmount	Numeric(16) mandatory	Transaction Amount
2	orderCurrency	Alpha(3) mandatory	Send the code in Currencies
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
2	subMerchant	JSON Object optional	Only use for master merchant scope
3	identifier	String(50) optional	Sub-merchant

{
    "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

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	responseData	JSON Object mandatory	Response data
2	orderNo	Alphanumeric mandatory	GALAXY PAY order no
2	shortLink	Alphanumeric mandatory	Payment Link URL
1	responseCode	Numeric(3) mandatory	See Response Codes for more detail
1	responseMessage	Alphanumeric(250) mandatory	Response message

{
  "requestID": "307826170e3e4a1b80430e074c7ba762",
  "responseDateTime": 20250410094723,
  "responseData": {
    "orderNo": "3258202405201716180392818",
    "shortLink": "https://example-payment..."
  },
  "responseCode": "200",
  "responseMessage": "Success"
}