> ## Documentation Index
> Fetch the complete documentation index at: https://opendocs.xft.xin/llms.txt
> Use this file to discover all available pages before exploring further.

# 商户信息变更

## 功能说明

商户进件成功（`apply_status=SUCCESS`）后，通过本接口提交商户信息变更申请（基础信息、法人信息、联系人信息、结算信息）。变更申请由平台审核，**审核通过后生效**，审核通过后平台同步至支付机构，无需渠道商在第三方系统操作。

* 仅支持已进件成功的商户（`apply_status=SUCCESS`）变更；
* 按变更类型（`change_type`）提交，一次提交一种类型的变更，仅上送需修改的字段（未上送字段保持不变）；
* 图片变更沿用进件引用方式：`pictures` 数组（`category` + `key`，见[商户进件提交](../merchant/apply-create#⑦-附件信息-pictures)），`key` 7 天内有效，过期需重新上传；
* 变更申请被驳回后可重新提交（同 `out_apply_no` 覆盖重提），重新进入审核；
* 同一 `out_apply_no` 重复提交返回原变更申请单当前状态（幂等），不重复创建。

## 请求地址

`POST https://gw.xft.xin/openapi/v1/merchant/update`

## 请求参数

| 字段                | 是否必选 | 字段类型        | 字段说明                                                                                            |
| ----------------- | ---- | ----------- | ----------------------------------------------------------------------------------------------- |
| `out_apply_no`    | 是    | String(≤64) | 申请单号，业务幂等键，同一渠道商下唯一；驳回重提沿用同一单号                                                                  |
| `merchant_code`   | 是    | String      | 平台商户号，进件成功后在通知与[进件状态查询](../merchant/apply-query)中下发                                             |
| `change_type`     | 是    | String      | 变更类型：`02`=基础信息变更、`03`=法人信息变更、`04`=联系人信息变更、`05`=结算信息变更                                           |
| `basic_info`      | 否    | Object      | 基础信息，`change_type=02` 时必填，字段同[商户进件提交](../merchant/apply-create#②-基础信息-basic_info)的 `basic_info` |
| `legal_person`    | 否    | Object      | 法人信息，`change_type=03` 时必填，字段同进件 `legal_person`                                                  |
| `contact_info`    | 否    | Object      | 联系人信息，`change_type=04` 时必填，字段同进件 `contact_info`，变更后原联系人被本次提交覆盖                                  |
| `settlement_info` | 否    | Object      | 结算信息，`change_type=05` 时必填，字段同进件 `settlement_info`                                               |
| `pictures`        | 否    | Array       | 附件列表（`category` + `key`），按变更类型引用对应图片；变更后原附件被本次提交覆盖                                              |

字段必填与校验规则同[商户进件提交](../merchant/apply-create#请求参数)。

## 响应参数

| 字段              | 是否必选 | 字段类型   | 字段说明                                                   |
| --------------- | ---- | ------ | ------------------------------------------------------ |
| `out_apply_no`  | 是    | String | 申请单号，原样返回                                              |
| `modify_code`   | 是    | String | 平台变更申请单号，供渠道商向平台报障时使用                                  |
| `modify_status` | 是    | String | 变更申请状态：`AUDITING`=审核中、`SUCCESS`=审核通过已生效、`REJECTED`=已驳回 |
| `timestamp`     | 是    | int64  | 提交时间，秒级时间戳                                             |

## 审核流程

提交后进入审核：`AUDITING`（平台审核）→ `SUCCESS`（审核通过，平台同步至支付机构后生效）或 `REJECTED`（驳回，附 `reject_reason`）。审核结果可通过[变更状态查询](../merchant/modify-query)获取。

## 示例

**请求（结算账户变更，`change_type=05`）**

```json theme={null}
{
  "out_apply_no": "M202608150001M1",
  "merchant_code": "M202608150001",
  "change_type": "05",
  "settlement_info": {
    "settlement_subject": "2",
    "bank_account_name": "张三",
    "bank_account_no": "6222000011112222333",
    "bank_name": "招商银行",
    "bank_code": "308331001118",
    "bank_branch": "招商银行杭州西湖支行",
    "account_type": "2",
    "bank_account_phone": "13800000000",
    "account_id_no": "330100199001010011"
  },
  "pictures": [
    { "category": "8", "key": "f_20260815Q1R2S3" }
  ]
}
```

**响应**

```json theme={null}
{
  "out_apply_no": "M202608150001M1",
  "modify_code": "MMA2026081500001",
  "modify_status": "AUDITING",
  "timestamp": 1755342000
}
```

**失败示例（商户不存在）**

```json theme={null}
{
  "code": 400,
  "reason": "MERCHANT_NOT_EXIST",
  "message": "商户号不存在",
  "metadata": {}
}
```

<Note>
  审核通过后变更生效：结算账户变更后新结算按新账户执行，旧账户停止使用；交易中的订单不受影响。结算账户变更可能影响后续结算，请确保新账户信息准确。
</Note>