> ## Documentation Index
> Fetch the complete documentation index at: https://docs-payment-merchant.keysecure.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Auth 订单通知（授权模式）

平台在授权模式下，会在用户消费授权、需要商户校验金额费用时，POST 至商户配置的回调 URL。

<Note>
  * 仅 **授权模式**（AUTHORIZATION）商户接收该通知。
  * 请求体结构：`{ "id": "...", "action": "...", "data": { ... } }`。
  * 商户须在超时内返回应答；超时或 `code ≠ 0` 时，平台按授权编排策略处理。
</Note>

## 触发场景

* 用户消费授权，校验金额费用。

## 推送参数

<ParamField body="id" type="string" required>
  推送 ID。
</ParamField>

<ParamField body="action" type="string" required>
  推送动作，见 【附录-常量表】 推送动作。
</ParamField>

<ParamField body="data" type="object" required>
  推送数据。
</ParamField>

### data

<ResponseField name="consume_no" type="string">消费单号</ResponseField>
<ResponseField name="card_no" type="string">卡单号</ResponseField>
<ResponseField name="cardholder_no" type="string">持卡人单号</ResponseField>
<ResponseField name="type" type="string">消费类型，见 【附录-常量表】 消费类型</ResponseField>
<ResponseField name="amount" type="number">授权金额（BigDecimal）</ResponseField>
<ResponseField name="local_amount" type="number">原始金额</ResponseField>
<ResponseField name="local_currency" type="string">原始币种</ResponseField>
<ResponseField name="merchant_info" type="object">商户信息</ResponseField>
<ResponseField name="status" type="string">固定为 `Pending`（待商户应答）</ResponseField>
<ResponseField name="time" type="number">通知时间（Unix 毫秒）</ResponseField>

### merchant\_info

<ResponseField name="merchant_name" type="string">商户名称</ResponseField>
<ResponseField name="merchant_mcc" type="string">商户 MCC</ResponseField>
<ResponseField name="city" type="string">商户城市</ResponseField>
<ResponseField name="country" type="string">商户国家</ResponseField>

<RequestExample>
  ```json Request theme={null}
  {
    "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
    }
  }
  ```
</RequestExample>

## 商户应答

<ResponseField name="code" type="number" required>
  code 码，`0` 表示成功。
</ResponseField>

<ResponseField name="message" type="string">
  失败原因，失败时必填。
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "code": 0,
    "message": ""
  }
  ```
</ResponseExample>