GALAXY PAY - API Reference Guide
  • Payment Gateway
    • Payment solution
      • General integration steps
      • Modal checkout
        • Integration Guide for Web Desktop & Mobile Browser
      • Merchant checkout
      • Merchant Hosted Checkout
      • Pay with option
      • Pay with token
      • Fast pay
      • Pay with QR
      • Pay with E-Wallet
    • Demo
    • API Specification
      • Integration Keys
      • Definitions
        • Message Structure
        • Signature Algorithm
      • Data Flight
      • PAYMENT
        • Pay
        • Pay with create token
        • Pay with token
        • Pay with Option
        • Pay with QR
        • Checkout(for modal checkout)
        • Payment Link
        • Fast pay
      • TOKENIZATION
        • Merchants
          • Delete Token
        • Customers
          • Query Tokens
          • Remove Token
      • MANAGEMENT
        • Query Transaction
        • Refund Transaction
        • Void Transaction
        • Capture Transaction
      • IPN & CALLBACK
        • Result & IPN Callback
        • Cancel Callback
    • Appendix
      • Response Codes
      • Currencies
      • Domestic Banks
      • International Card Brands
      • eWallets
      • Payment Hubs
        • Apple Pay Validation
      • QR Payment Providers
      • Buy Now Pay Later
      • Test Information
      • Glossary
  • Payment Link
    • IPN callback
  • Archive
    • QR Payment (Old version)
      • API create QR
      • API query status
      • How to test
    • API create PaymentLink
Powered by GitBook
On this page
  • Conditions
  • Supported providers for refunds
  • API format
  • Request Message
  • Response Message
  1. Payment Gateway
  2. API Specification
  3. MANAGEMENT

Refund Transaction

Use to refund a successful transaction.

PreviousQuery TransactionNextVoid Transaction

Last updated 25 days ago

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:

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

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

1

responseMessage

Alphanumeric(250) mandatory

Response message

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

Send the code in

See for more detail

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