Fast pay
Only apply for International card.
APIOperation = FAST_PAY
See information of Fast Pay here
Integration
See integration detail in General integration steps
Base URL
api/v1/transaction/pay
Example:
https://uat-secure.galaxypay.vn/api/v1/transaction/pay
Request Message
Header
1
apiKey
Alphanumeric mandatory
Request authenticate
1
signature
Alphanumeric mandatory
Request signature
Body
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
FAST_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
orderDateTime
Numeric(14) mandatory
yyyyMMddHHmmss
2
orderDescription
Alphanumeric(250) mandatory
Transaction Description
2
paymentMethod
Alpha(20) mandatory
INTERNATIONAL: International Card
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
sourceOfFund
Alpha(50) optional
CARD or TOKEN Required when paymentMethod = DOMESTIC or INTERNATIONAL
2
cardNumber
Numeric(19) condition
Required when
sourceOfFund = CARD
2
cardHolderName
Alphanumeric(19) condition
Required when
sourceOfFund = CARD
2
cardExpireDate
Alphanumeric(5) condition
Required when
sourceOfFund = CARD
Format: MM/YY
2
cardVerificationValue
Numeric(3) condition
Required when
sourceOfFund = CARD Only use for International Card
2
token
Alphanumeric(50) condition
Required when
sourceOfFund = TOKEN
Sample request
{
"apiVersion": "1",
"language": "vi",
"billNumber": "74118",
"orderAmount": "10,000",
"orderCurrency": "VND",
"orderDescription": "Secure Page Demo",
"paymentMethod": "INTERNATIONAL",
"sourceType": "",
"extraData": {
},
"cardNumber": "5123450000000008",
"cardHolderName": "Nguyen Van A",
"cardExpireDate": "12/39",
"cardVerificationValue": "111",
"integrationMethod": "HOSTED",
"apiOperation": "FAST_PAY",
"merchantID": "9339",
"successURL": "https://uat-demo.galaxypay.vn/api/result",
"cancelURL": "https://uat-demo.galaxypay.vn/api/cancel",
"ipnURL": "https://uat-demo.galaxypay.vn/api/ipn",
"baseUrl": "https://uat-demo.galaxypay.vn/",
"sourceOfFund": "CARD",
"isAutoCapture": true,
"isUseOtp": false
}
Response message
Header
1
signature
Alphanumeric mandatory
Response signature
Body
1
requestID
Alphanumeric(50) mandatory
Original Request ID
1
responseDateTime
Numeric(14) mandatory
yyyyMMddHHmmss
1
responseMessage
Alphanumeric(250) mandatory
Response message
1
responseData
JSON Object mandatory
Response data
2
transactionID
Alphanumeric(38) mandatory
GALAXY PAY transaction ID
2
endpoint
Alphanumeric mandatory
Secure Payment URL (Use for Redirect)
Sample response
{
"requestID": "d1f49f187e0344d3a9b020af15b6dc78",
"responseDateTime": "20241111152140",
"responseData": {
"transactionID": "2411115365746677264803951",
"qrCode": null,
"endpoint": "http://uat-demo.galaxypay.vn/success?transactionID=2411115365746677264803951"
},
"responseCode": "200",
"responseMessage": "Success"
}
Last updated