Skip to main content
In authorization mode, the platform sends a POST request to the configured merchant callback URL when a user initiates a consumption authorization and the merchant needs to verify the amount and fees.
  • Only merchants in authorization mode (AUTHORIZATION) receive this notification.
  • Request body structure: { "id": "...", "action": "...", "data": { ... } }.
  • The merchant must return a response within the timeout; if timeout occurs or code ≠ 0, the platform handles it according to the authorization orchestration strategy.

​
Trigger Scenarios

  • User initiates a consumption authorization, requiring amount and fee verification.

​
Push Parameters

​
id
string
required
Push ID.
​
action
string
required
Push action, see [Appendix - Constants] Push Actions.
​
data
object
required
Push data.

​
data

​
consume_no
string
Consumption order number
​
card_no
string
Card order number
​
cardholder_no
string
Cardholder order number
​
type
string
Consumption type, see [Appendix - Constants] Consumption Type
​
amount
number
Authorization amount (BigDecimal)
​
local_amount
number
Original amount
​
local_currency
string
Original currency
​
merchant_info
object
Merchant information
​
status
string
Fixed to Pending (awaiting merchant response)
​
time
number
Notification time (Unix milliseconds)

​
merchant_info

​
merchant_name
string
Merchant name
​
merchant_mcc
string
Merchant MCC
​
city
string
Merchant city
​
country
string
Merchant country
{
  "id": "",
  "action": "",
  "data": {
    "consume_no": "",
    "card_no": "",
    "cardholder_no": "",
    "type": "",
    "amount": 0,
    "local_amount": 0,
    "local_currency": "",
    "merchant_info": {
      "merchant_name": "",
      "merchant_mcc": "",
      "city": "",
      "country": ""
    },
    "status": "Pending",
    "time": 0
  }
}

​
Merchant Response

​
code
number
required
Response code. 0 indicates success.
​
message
string
Failure reason, required when failing.
{
  "code": 0,
  "message": ""
}