Fast pay

Only apply for International card.

APIOperation = FAST_PAY

See information of Fast Pay 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/pay

Example:

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

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	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	orderCurrency	Alpha(3) mandatory	Send the code in Currencies
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
2	extraData	JSON Object optional	Extra data. Same as API Pay

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

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