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

# 商户信息变更

> [!WARNING]
>
> **该接口暂未开放。** 当前开放平台未上线此接口，以下内容为规划稿，请勿据此接入；开放时间以平台通知为准。

## 功能说明

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

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

## 请求路径

`POST /openapi/v1/merchant/update`

## 请求参数

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

字段必填与校验规则同[商户进件提交](https://opendocs.xft.xin/open/payment/merchant/add.md#请求参数)。

## 响应参数

| 字段 | 是否必填 | 字段类型 | 字段说明 |
| - | - | - | - |
| `out_apply_no` | 是 | String | 申请单号，原样返回 |
| `modify_code` | 是 | String | 平台变更申请单号，供渠道商向平台报障时使用 |
| `modify_status` | 是 | String | 变更申请状态：`AUDITING`=审核中、`SUCCESS`=审核通过已生效、`REJECTED`=已驳回 |
| `timestamp` | 是 | String | 提交时间，格式 `yyyy-MM-dd HH:mm:ss`（北京时间） |

## 审核流程

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

## 示例

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

```json theme={"system"}
{
  "out_apply_no": "M202608150001M1",
  "merchant_code": "M202608150001",
  "change_type": "SETTLEMENT_INFO",
  "settlement_info": {
    "settlement_subject": "LEGAL_PERSON",
    "bank_account_name": "张三",
    "bank_account_no": "6222000011112222333",
    "bank_name": "招商银行",
    "bank_code": "308331001118",
    "bank_branch": "招商银行长沙岳麓支行",
    "bank_account_phone": "13800000000",
    "account_id_no": "430104199001010011"
  },
  "pictures": [
    { "category": "8", "key": "f_20260815Q1R2S3" }
  ]
}
```

**响应**

```json theme={"system"}
{
  "out_apply_no": "M202608150001M1",
  "modify_code": "MMA2026081500001",
  "modify_status": "AUDITING",
  "timestamp": "2026-10-18 14:00:00"
}
```

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

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

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.