Pay with Option

Use to create a payment request with payment options, then customer can select the payment methods at GALAXY PAY

See information of Pay with option here

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

Example:

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

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

apiVersion

Numeric(5) optional

Specify the api version. Current supported version is 2. If this field is omitted, the default value of apiVersion is 1

2

apiOperation

Alpha(20) mandatory

PAY or PAY_WITH_CREATE_TOKEN

PAY_WITH_CREATE_TOKEN: Only use for request payment and create token.

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

Send the code in Currencies

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

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": "20230726172332",
  "requestData": {
    "apiOperation": "PAY",
    "orderID": "2a43e4b9-c5df-49e6-8b18-42af9bcd150e",
    "orderNumber": 205249008064,
    "orderAmount": 100000,
    "orderCurrency": "VND",
    "orderDateTime": 20230726172332,
    "orderDescription": "DEMO TRANSACTION",
    "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)

{
  "requestID": "dc9845fdb2fc4ebfa2563caffe26284a",
  "responseDateTime": "20230726172332",
  "responseCode": "200",
  "responseMessage": "Success",
  "responseData": {
    "transactionID": "2307264944869814641620077",
    "endpoint": "https://uat-payment.galaxypay.vn/payWithOption/2307264944869814641620077/20230726172332/993c33d5640b80c4b9ee5f7a0bc6169e6621d032c345b91babb5b2973b75158f"
  }
}

Last updated