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	orderDescription	Alphanumeric(250) mandatory	Transaction Description
2	paymentDays	Numeric(2) mandatory	Transaction expired in days
2	paymentMethods	JSON Array mandatory	[ "GPAY", "MPGS", "QRPAY", "MOMO", "ZALOPAY", "NAPAS" ]
2	paymentFields	JSON Array mandatory	[ "email", "fullname", "phone", "shippingAddress" ]
2	ipnURL	Alphanumeric(500) optional	IPN URL

{
  "requestID": "66d33e93e4594238a863c7a848bc1385",
  "requestDateTime": "20240520114632",
  "requestData": {
    "orderId": "41a5d0f157e0487e9657013aead72b85",
    "orderAmount": 10000,
    "orderName": "Thanh toán hoá đơn ORDER123",
    "orderDescription": "Demo Link",
    "PaymentDays": 3,
    "PaymentMethods": [
      "GPAY",
      "MPGS",
      "QRPAY",
      "MOMO",
      "ZALOPAY",
      "NAPAS"
    ],
    "PaymentFields": [
      "email",
      "fullname",
      "phone",
      "shippingAddress"
    ],
    "ipnUrl": "http://merchant-ipn.com.vn"
  }
}

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	orderNo	Alphanumeric mandatory	GALAXY PAY order no
2	shortLink	Alphanumeric mandatory	Payment Link URL

{
    "requestID": "66d33e93e4594238a863c7a848bc1385",
    "responseDateTime": "20240520114634",
    "responseCode": "200",
    "responseMessage": "Success",
    "responseData": {
        "orderNo": "3258202405201716180392818",
        "shortLink": "https://uat-s.galaxypay.vn/c4MZkAGAhhdSmNc18"
    }
}