消费订单通知

{
  "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": 0,
  "message": ""
}

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

触发场景

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

推送参数

string

必填

推送 ID。

string

必填

推送动作，见【附录-常量表】推送动作。

object

必填

推送数据。

data 字段

string

消费单号

string

消费关联单号

string

卡单号

string

持卡人单号

string

消费类型，见【附录-常量表】消费类型

number

消费金额（BigDecimal）

number

原始金额

string

原始币种

number

费用合计（fee_detail 各 amount 之和）

string

备注（来自消费扩展信息）

string

描述（来自消费扩展信息）

array

费用详情列表（字段名为 fee_detail，非 fee_list）

object

商户信息

string

状态，见【附录-常量表】通用状态

number

消费更新时间（Unix 毫秒，取记录 mtime）

fee_detail 字段

string

费用类型，见【附录-常量表】手续费类型

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 字段

string

商户名称

string

商户 MCC

string

商户城市

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
  }
}

商户应答

number

必填

code 码，0 表示成功。

string

失败原因，失败时必填。

{
  "code": 0,
  "message": ""
}

接入指引

API文档

附录

触发场景

推送参数

data 字段

fee_detail 字段

merchant_info 字段

商户应答

​触发场景

​推送参数

​data 字段

​fee_detail 字段

​merchant_info 字段

​商户应答

触发场景

推送参数

data 字段

fee_detail 字段

merchant_info 字段

商户应答