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 Link

IPN callback

IPN URL: Use for Merchant to receive payment result and process business workflow.

Method: POST

Content-type: application/json

Body

Level
Field Name
Data Type
Description

1

data

Alphanumeric mandatory

Base-64 string

1

signature

Alphanumeric mandatory

Response Signature

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

See Response Code Table for detail

1

responseMessage

Alphanumeric(250) mandatory

Response message

1

responseData

JSON Object mandatory

Response data

2

orderNo

Alphanumeric mandatory

Reference number tagged to a Payment Link, which is returned in the step of creating a payment link

2

orderReference

Alphanumeric optional

Your order reference

2

orderAmount

Numeric(16) mandatory

Transaction Amount

2

extraData

JSON Object optional

Customer information

3

fullName

Alphanumeric(50) optional

Information input at Payment page

3

phone

Alphanumeric(50) optional

Information input at Payment page

3

email

Alphanumeric(50) optional

Information input at Payment page

3

shippingAddress

Alphanumeric(50) optional

Information input at Payment page

{
  "data": "eyJyZXF1ZXN0SUQiOiJjYWRlYjBmZC1iNTZhLTQyYWMtYWFmZC1iNjhjZjdiYTgzNDQiLCJyZXNwb25zZURhdGVUaW1lIjoiMjAyMzA3MTExNDQ0MDgiLCJyZXNwb25zZUNvZGUiOiIyMDAiLCJyZXNwb25zZU1lc3NhZ2UiOiJHaWFvIGThu4tjaCB0aGFuaCB0b8OhbiB0aMOgbmggY8O0bmcuIiwicmVzcG9uc2VEYXRhIjp7InRyYW5zYWN0aW9uSUQiOiIyMzA3MTE1MDg4ODIxNzQ3MzI2NjMyNDc5Iiwib3JkZXJJRCI6IjMyNTgyMDIzMDcxMTE2ODkwNjEzNTgyNDkiLCJvcmRlck51bWJlciI6ImQwMWYyNTZjZjA4MzQ5M2VhZThkNzIxMWYzM2ZkMjU4Iiwib3JkZXJBbW91bnQiOiIxMTMwMCIsIm9yZGVyRGVzY3JpcHRpb24iOiJtdWEgaGFuZyBvbmxpbmUiLCJvcmRlckN1cnJlbmN5IjoiVk5EIiwib3JkZXJEYXRlVGltZSI6IjIwMjMwNzExMTQ0MzE2IiwiZXh0cmFEYXRhIjp7ImZ1bGxOYW1lIjoiYmluaCB0ZXN0IGxhaSIsInBob25lIjoiMDc3NDc1NDMyMyIsImVtYWlsIjoiYmluaGhudEBnYWxheHlwYXkuY29tIiwic2hpcHBpbmdBZGRyZXNzIjoia2hhIHZhbiBjYW4iLCJwYXltZW50TGluayI6Imh0dHBzOi8vdWF0LXMuZ2FsYXh5cGF5LnZuL2REdXd0RzI4bnJiQ1VXVHo5In0sImxhbmd1YWdlIjoidmkifX0=",
  "signature": "7dc0ad01ccdbdf5dca8031015bfc7d152bc953ccb36ac4997f5e4964e8756438"
}

Signature = Hex(Sha256(data + key))

Decode Base-64 string

{
  "requestId": "a6f3ef642d304098a45cf0597d9ebc12",
  "responseDateTime": "20230711145712",
  "responseCode": "200",
  "responseMessage": "SUCCESS",
  "responseData": {
    "orderNo": "3258202307111689061358249",
    "orderReference": "TS1909",
    "orderAmount": 11300,
    "extraData": {
      "fullName": "John Joe",
      "phone": "0774751234",
      "email": "john@gmail.com",
      "shippingAddress": "kha van can",
      "paymentLink": "https://uat-s.galaxypay.vn/dDuwtG28nrbCUWTz9"
    }
  }
}
PreviousPayment LinkNextArchive

Last updated 1 year ago