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:

Request Message

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

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

Last updated