Skip to main content
The platform sends a POST request to the configured merchant callback URL when a consumption transaction is created, its status changes, or when fees and merchant information are supplemented.

​
Trigger Scenarios

  • Consumption transaction created, transaction status changed (success / failure / reversal / refund).
  • After fee breakdown and merchant information are supplemented, proactively push to the merchant callback address.

​
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
​
consume_relate_no
string
Consumption related 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
Consumption amount (BigDecimal)
​
local_amount
number
Original amount
​
local_currency
string
Original currency
​
fee
number
Total fee (sum of all amount values in fee_detail)
​
remark
string
Remarks (from consumption extension info)
​
detail
string
Description (from consumption extension info)
​
fee_detail
array
Fee detail list (field name is fee_detail, not fee_list)
​
merchant_info
object
Merchant information
​
status
string
Status, see [Appendix - Constants] Common Status
​
time
number
Consumption update time (Unix milliseconds, uses record mtime)

​
fee_detail Fields

​
fee_type
string
Fee type, see [Appendix - Constants] Fee Types
​
amount
number
Fee amount
Fee details differ by integration mode:
  • Credit extension mode: Consume_fee, Exchange_fee, Atm_fee / Apple_auth_fee, Small_fee, Decline_fee (only pushed when amount > 0).
  • Authorization mode: Reserve fund side fees, including Consume_fee, Exchange_fee, Apple_auth_fee, Atm_fee, Small_fee, Refund_fee, Cancel_fee.

​
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": "",
    "consume_relate_no": "",
    "card_no": "",
    "cardholder_no": "",
    "type": "",
    "amount": 0,
    "local_amount": 0,
    "local_currency": "",
    "remark": "",
    "detail": "",
    "fee": 0,
    "fee_detail": [
      {
        "fee_type": "",
        "amount": 0
      }
    ],
    "merchant_info": {
      "merchant_name": "",
      "merchant_mcc": "",
      "city": "",
      "country": ""
    },
    "status": "",
    "time": 0
  }
}

​
Merchant Response

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