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
  1. Payment Gateway
  2. API Specification
  3. IPN & CALLBACK

Cancel Callback

  • Use for Merchant to redirect customer to cancel payment page.

Note:

Response Signature is create by applying hash algorithm SHA256 the response data with Salt.

signature = SHA256(data + salt)

Body

Level
Field Name
Data Type
Description

1

data

Alphanumeric mandatory

Base-64 string

1

signature

Alphanumeric mandatory

Response Signature signature = SHA256(data + Salt)

Data (Decode Base-64 String)

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

1

responseData

JSON Object mandatory

Response data

2

transactionID

Alphanumeric(38) mandatory

GALAXY PAY transaction ID

2

transactionDateTime

Numeric(14) mandatory

yyyyMMddHHmmss

2

orderID

Alphanumeric(50) mandatory

Transaction ID at Merchant

2

orderNumber

Alphanumeric(20) optional

Order Number or Bill Number

2

orderAmount

Numeric(16) mandatory

Order Amount

2

orderCurrency

Alpha(3) mandatory

Order Currency

2

orderDateTime

Numeric(14) mandatory

Order Date Time

yyyyMMddHHmmss

2

orderDescription

Alphanumeric(250) mandatory

Order Description

2

language

Alpha(2) mandatory

vi or en

vi: Vietnamese

en: English

RESPONSE DATA

{
  "data": "eyJyZXF1ZXN0SUQiOiIxNDY1M2ZhMS0yZjY5LTRmNGYtOWQ0Yi0yNDBlMWJlYmJkZjMiLCJyZXNwb25zZURhdGVUaW1lIjoiMjAyMjA1MDYxMTM1MTciLCJyZXNwb25zZUNvZGUiOiI0OTkiLCJyZXNwb25zZU1lc3NhZ2UiOiJDYW5jZWxlZCBieSB1c2VyIiwicmVzcG9uc2VEYXRhIjp7InRyYW5zYWN0aW9uSUQiOiIyMjA1MDY5OWU2NWQ5YTcxZDU0OGU2YjY3MzIzYWVmMWE0OTRhYyIsInRyYW5zYWN0aW9uRGF0ZVRpbWUiOiIyMDIyMDUwNjExMzUxNyIsIm9yZGVySUQiOiI4ODgyODkiLCJvcmRlck51bWJlciI6IjgyMjYyODg5Iiwib3JkZXJBbW91bnQiOiIxMDkwMDAiLCJvcmRlckRlc2NyaXB0aW9uIjoiU2VjdXJlIFBhZ2UgRGVtbyIsIm9yZGVyQ3VycmVuY3kiOiJWTkQiLCJvcmRlckRhdGVUaW1lIjoiMjAyMjA0MDUyMDIwMDAiLCJsYW5ndWFnZSI6InZpIn19",
  "signature": "be8d2d815d694037d7ec2d9f7ac645d7a6168b692af6b786c1d59da72cd93a5e"
}


VERIFY SIGNATURE

const data = "eyJyZXF1ZXN0SUQiOiIxNDY1M2ZhMS0yZjY5LTRmNGYtOWQ0Yi0yNDBlMWJlYmJkZjMiLCJyZXNwb25zZURhdGVUaW1lIjoiMjAyMjA1MDYxMTM1MTciLCJyZXNwb25zZUNvZGUiOiI0OTkiLCJyZXNwb25zZU1lc3NhZ2UiOiJDYW5jZWxlZCBieSB1c2VyIiwicmVzcG9uc2VEYXRhIjp7InRyYW5zYWN0aW9uSUQiOiIyMjA1MDY5OWU2NWQ5YTcxZDU0OGU2YjY3MzIzYWVmMWE0OTRhYyIsInRyYW5zYWN0aW9uRGF0ZVRpbWUiOiIyMDIyMDUwNjExMzUxNyIsIm9yZGVySUQiOiI4ODgyODkiLCJvcmRlck51bWJlciI6IjgyMjYyODg5Iiwib3JkZXJBbW91bnQiOiIxMDkwMDAiLCJvcmRlckRlc2NyaXB0aW9uIjoiU2VjdXJlIFBhZ2UgRGVtbyIsIm9yZGVyQ3VycmVuY3kiOiJWTkQiLCJvcmRlckRhdGVUaW1lIjoiMjAyMjA0MDUyMDIwMDAiLCJsYW5ndWFnZSI6InZpIn19";
const salt = "GO@2021";
const signature = SHA256(data + salt);


DECODE BASE-64 STRING FOR DATA
{
  "requestID": "14653fa1-2f69-4f4f-9d4b-240e1bebbdf3",
  "responseDateTime": "20220506113517",
  "responseCode": "499",
  "responseMessage": "Canceled by user",
  "responseData": {
    "transactionID": "22050699e65d9a71d548e6b67323aef1a494ac",
    "transactionDateTime": "20220506113517",
    "orderID": "888289",
    "orderNumber": "82262889",
    "orderAmount": "109000",
    "orderDescription": "Secure Page Demo",
    "orderCurrency": "VND",
    "orderDateTime": "20220405202000",
    "language": "vi"
  }
}
PreviousResult & IPN CallbackNextAppendix

Last updated 1 year ago

See for more detail

Response Codes