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

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

Last updated