Refund Transaction

Use to refund a successful transaction.

Conditions

• The transaction must have been successfully completed within 1 year and fully captured (applicable for international cards).

• Refund transactions can be split into multiple requests, provided the total refund amount does not exceed the original transaction amount.

Supported providers for refunds

MOMO ZALOPAY GALAXYPAY	NAPAS MPGS CYBS	APPLE SAMSUNG GOOGLE	DOKU AZUPAY SMARTRO PAYU

API format

Endpoint URL	Route
Base URL	api/v1/transaction/refund

Example:

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

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	transactionID	Alphanumeric(50) mandatory	GALAXY PAY transaction ID
2	orderID	Alphanumeric(50) mandatory	Transaction ID at Merchant
2	orderAmount	Numeric(16) mandatory	Refund amount
2	orderCurrency	Alpha(3) mandatory	Send the code in Currencies
2	orderDateTime	Numeric(14) mandatory	yyyyMMddHHmmss
2	orderDescription	Alphanumeric(250) mandatory	Transaction Description

{
  "requestID": "a9fa54aeca7943b6a32aad47857bf7d7",
  "requestDateTime": "20231116151903",
  "requestData": {
    "transactionID": "2311165672361384300115770",
    "orderID": "17d17e5431a6473bb5ab91cf5a9080a4",
    "orderAmount": 10000,
    "orderCurrency": "VND",
    "orderDateTime": "20231116151903",
    "orderDescription": "DEMO REFUND TRANSACTION"
  }
}

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

{
  "requestID": "a9fa54aeca7943b6a32aad47857bf7d7",
  "responseDateTime": "20231116151903",
  "responseCode": "200",
  "responseMessage": "Success"
}