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": "[email protected]",
      "shippingAddress": "kha van can",
      "paymentLink": "https://uat-s.galaxypay.vn/dDuwtG28nrbCUWTz9"
    }
  }
}

Last updated