> ## 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.

# 卡变动通知

平台在卡状态变更时，POST 至商户配置的回调 URL。

## 触发场景

* 卡状态发生变更。

## 推送参数

<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="card_no" type="string">卡单号</ResponseField>
<ResponseField name="before_status" type="string">变动前状态，见 【附录-常量表】卡状态</ResponseField>
<ResponseField name="after_status" type="string">变动后状态，见 【附录-常量表】 卡状态</ResponseField>
<ResponseField name="reason" type="string">变动原因</ResponseField>
<ResponseField name="time" type="number">变动时间（时间戳）</ResponseField>

<RequestExample>
  ```json Request theme={null}
  {
    "id": "",
    "action": "",
    "data": {
      "card_no": "",
      "before_status": "",
      "after_status": "",
      "reason": "",
      "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>