Pay with QR

Use to create a dynamic QR payment request, then customer can scan the QR code and process the payment on any banking mobile applications that supported VietQR.

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/payWithQR

Example:

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

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

apiOperation

Alpha(20) mandatory

PAY

2

orderID

Alphanumeric(50) mandatory

Transaction ID at Merchant

2

orderNumber

Alphanumeric(20) optional

Order Number or Bill Number

2

orderAmount

Numeric(16) mandatory

Transaction Amount

2

orderCurrency

Alpha(3) mandatory

VND

2

orderDateTime

Numeric(14) mandatory

yyyyMMddHHmmss

2

orderDescription

Alphanumeric(250) mandatory

Transaction Description

2

language

Alpha(2) optional

vi or en

vi: Vietnamese

en: English

2

paymentMethod

Alpha(20) mandatory

QRPAY

2

sourceType

Alphanumeric(20) mandatory

QRPAY

2

successURL

Alphanumeric(500) optional

Callback URL when Payment is success

2

failureURL

Alphanumeric(500) optional

Callback URL when Payment is failure

2

cancelURL

Alphanumeric(500) optional

Callback URL when Customer cancel payment

2

ipnURL

Alphanumeric(500) optional

IPN URL

2

extraData

JSON Object optional

Extra data.

Same as API Pay

{
  "requestID": "dc9845fdb2fc4ebfa2563caffe26284a",
  "requestDateTime": "20231222172332",
  "requestData": {
    "apiOperation": "PAY",
    "orderID": "2a43e4b9-c5df-49e6-8b18-42af9bcd150e",
    "orderNumber": "205249008064",
    "orderAmount": 100000,
    "orderCurrency": "VND",
    "orderDateTime": "20231222172332",
    "orderDescription": "DEMO TRANSACTION",
    "paymentMethod": "QRPAY",
    "sourceType": "QRPAY",
    "language": "vi",
    "extraData": {}
  }
}

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

transactionID

Alphanumeric mandatory

GALAXY PAY transaction ID

2

endpoint

Alphanumeric mandatory

Secure Payment URL

(Use for Redirect)

2

qrCode

Alphanumeric mandatory

QR Payment Info

{
    "requestID": "dc9845fdb2fc4ebfa2563caffe26284a",
    "responseDateTime": "20231222172332",
    "responseCode": "200",
    "responseMessage": "Success",
    "responseData": {
        "qrCode": "00020101021238600010A000000727013000069704370116GP000000000069260208QRIBFTTA53037045405100015802VN6304448E",
        "transactionID": "2312225610100119420351813",
        "endpoint": "https://uat-payment.galaxypay.vn/pay/2312225610100119420351813/20231222144449/c81d3beebecdaad145b2a326375914b97ee7eeafc9d52f9f642497e703d29f30/vi"
    }
}

Last updated