跳转到主要内容
平台在消费交易创建、状态变更，或手续费与商户信息补全后，会 POST 至合作方配置的回调 URL。

​
触发场景

  • 消费交易创建、交易状态变更（成功 / 失败 / 撤销 / 退款）。
  • 手续费拆分、商户信息补全后，主动推送至合作方回调地址。

​
推送参数

​
id
string
必填
推送 ID。
​
action
string
必填
推送动作，见【附录-常量表】 推送动作。
​
data
object
必填
推送数据。

​
data 字段

​
consume_no
string
消费单号
​
consume_relate_no
string
消费关联单号
​
card_no
string
卡单号
​
cardholder_no
string
持卡人单号
​
type
string
消费类型，见 【附录-常量表】 消费类型
​
amount
number
消费金额（BigDecimal）
​
local_amount
number
原始金额
​
local_currency
string
原始币种
​
fee
number
费用合计（fee_detail 各 amount 之和）
​
remark
string
备注（来自消费扩展信息）
​
detail
string
描述（来自消费扩展信息）
​
fee_detail
array
费用详情列表（字段名为 fee_detail，非 fee_list）
​
merchant_info
object
商户信息
​
status
string
状态，见【附录-常量表】 通用状态
​
time
number
消费更新时间（Unix 毫秒，取记录 mtime）

​
fee_detail 字段

​
fee_type
string
费用类型，见 【附录-常量表】 手续费类型
​
amount
number
费用金额
费用明细按对接模式区分：
  • 授信模式：Consume_fee、Exchange_fee、Atm_fee / Apple_auth_fee、Small_fee、Decline_fee（金额大于 0 才推送）。
  • 授权模式：备付金侧费用，含 Consume_fee、Exchange_fee、Apple_auth_fee、Atm_fee、Small_fee、Refund_fee、Cancel_fee。

​
merchant_info 字段

​
merchant_name
string
商户名称
​
merchant_mcc
string
商户 MCC
​
city
string
商户城市
​
country
string
商户国家
{
  "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
  }
}

​
商户应答

​
code
number
必填
code 码，0 表示成功。
​
message
string
失败原因，失败时必填。
{
  "code": 0,
  "message": ""
}