---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012761102.md"
title: "修改结算账户"
doc_id: 4012761102
---

>更新时间：2025.01.22

服务商/电商平台（不包括支付机构、银行），可使用本接口，修改其进件且已签约特约商户/二级商户的结算银行账户。

注意：

1、提交结算银行账户修改申请后，应答代码为“200”且系统返回申请单号，需通过"[查询结算账户修改申请状态API](https://pay.weixin.qq.com/doc/v3/partner/4012760660.md)"查询申请单处理结果。申请单状态存在如下情况：

① 审核中：修改的银行结算账户还在审核中、账户尚未生效，需继续等待审核结果，在此期间无法再次提交修改申请；审核过程中，系统可能会向结算银行账户付款0.01元进行验证。

② 审核驳回：申请已驳回，请检查驳回原因、并重新发起修改。

③ 审核成功：银行结算账户更新成功。

2、如需查询当前生效中的银行结算账户，请使用“[查询结算账户API](https://pay.weixin.qq.com/doc/v3/partner/4012760642.md)”。

3、特约商户/二级商户每天仅能提交5次修改申请，如需继续申请，请等到次日0点后重新发起。

4、修改结算银行卡接口调用频率限制：20/min。




## 接口说明

支持商户：【普通服务商】　【平台商户】

请求方式：【POST】 `/v3/apply4sub/sub_merchants/{sub_mchid}/modify-settlement`

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/partner/4012082567.md)

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/partner/4012365870.md#%E8%AF%B7%E6%B1%82%E6%8E%A5%E5%8F%A3%E5%90%8E%E7%AB%AF%E7%AD%BE%E5%90%8D) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
| Content-Type | string | true | 请设置为 `application/json` |
| Wechatpay-Serial | string | true | 【微信支付公钥ID】或【微信支付平台证书序列号】请求参数中的敏感字段，需要使用微信支付公钥加密（推荐），请参考[获取微信支付公钥ID说明](https://pay.weixin.qq.com/doc/v3/partner/4013038589.md#Q%3A-%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96%E5%BE%AE%E4%BF%A1%E6%94%AF%E4%BB%98%E5%85%AC%E9%92%A5ID%3F)以及[微信支付公钥加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059044.md)，也可以使用微信支付平台证书公钥加密，参考[获取平台证书序列号](https://pay.weixin.qq.com/doc/v3/partner/4013059181.md)、[平台证书加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059053.md) |
### Path 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| sub_mchid | string(32) | true | 【特约商户/二级商户号】 请填写本服务商负责进件的特约商户/二级商户号。 |
### Body 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| account_type | string | true | 【账户类型】 根据特约商户号/二级商户号的主体类型，可选择的账户类型如下：<br>1、小微主体：经营者个人银行卡<br>2、个体工商户主体：经营者个人银行卡/ 对公银行账户<br>3、企业主体：对公银行账户<br>4、党政、机关及事业单位主体：对公银行账户<br>5、其他组织主体：对公银行账户<br>可选取值<br><ul><li>`ACCOUNT_TYPE_BUSINESS`:  对公银行账户</li><li>`ACCOUNT_TYPE_PRIVATE`:  经营者个人银行卡</li></ul> |
| account_bank | string(128) | true | 【开户银行】 请填写开户银行名称。<br>对私银行调用： [查询支持个人业务的银行列表API](https://pay.weixin.qq.com/doc/v3/partner/4012697583.md)<br>对公银行调用： [查询支持对公业务的银行列表API](https://pay.weixin.qq.com/doc/v3/partner/4012697626.md) |
| bank_name | string(128) | false | 【开户银行全称（含支行）】 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行，开户银行全称（含支行）和开户银行联行号二选一。<br>2、详细需调用 [查询支行列表API](https://pay.weixin.qq.com/doc/v3/partner/4012697673.md) 查看查询结果。 |
| bank_branch_id | string(128) | false | 【开户银行联行号】 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行，开户银行全称（含支行）和开户银行联行号二选一。<br>2、详细需调用 [查询支行列表API](https://pay.weixin.qq.com/doc/v3/partner/4012697673.md) 查看查询结果。 |
| account_number | string(1024) | true | 【银行账号】 1、数字，不超过 32 个字符<br>2、该字段需要使用微信支付公钥加密（推荐），请参考[获取微信支付公钥ID说明](https://pay.weixin.qq.com/doc/v3/partner/4013038589.md#Q%3A-%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96%E5%BE%AE%E4%BF%A1%E6%94%AF%E4%BB%98%E5%85%AC%E9%92%A5ID%3F)以及[微信支付公钥加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059044.md)，也可以使用微信支付平台证书公钥加密，参考[获取平台证书序列号](https://pay.weixin.qq.com/doc/v3/partner/4013059181.md)、[平台证书加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059053.md) |
| account_name | string | false | 【开户名称】 1、不需要修改开户名称时，可以不填写或填写当前绑定的结算银行卡户名；<br>2、支持将开户名称修改为当前商户对应的主体名称（对公银行账户）或经营者名称（个人银行账户），支持修改开户名称中括号的全半角；<br>3、该字段需要使用微信支付公钥加密（推荐），请参考[获取微信支付公钥ID说明](https://pay.weixin.qq.com/doc/v3/partner/4013038589.md#Q%3A-%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96%E5%BE%AE%E4%BF%A1%E6%94%AF%E4%BB%98%E5%85%AC%E9%92%A5ID%3F)以及[微信支付公钥加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059044.md)，也可以使用微信支付平台证书公钥加密，参考[获取平台证书序列号](https://pay.weixin.qq.com/doc/v3/partner/4013059181.md)、[平台证书加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059053.md) |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| application_no | string(64) | true | 【修改结算账户申请单号】 提交二级商户修改结算账户申请后，由微信支付返回的单号，作为查询申请状态的唯一标识。 |
## 错误码

### 公共错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/partner/4012081726.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/partner/4012082324.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |

### 业务错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 403 | NO\_AUTH | 商户权限异常 | 该商户不是本服务商进件的子商户，无权限操作 |
| 400 | INVALID\_REQUEST | 无效请求 | 请根据接口返回的详细信息进行检查 |
| 400 | INVALID\_REQUEST | 你的开户名称与主体名称不一致，请修改后重试 | 请修改为同名结算账户后重试。如商户主体类型为企业/政府机关/事业单位/社会组织且需使用非同名结算账户时，可前往[非同名银行结算账户修改页面](https://pay.weixin.qq.com/xdc/mchsettlementinfoweb/index.php/xphp/csettlementinfo/diffname)提交信息。如为托管子商户，需通过服务商联系对应的微信支付行业运营协助处理。 |
| 429 | FREQENCY\_LIMIT | 频率超限 | 请求量不要超过接口调用频率限制 |

请求示例

- [curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4012761102-curl.md)
- [Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4012761102-java.md)
- [Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4012761102-go.md)


应答示例

> 200 OK

```
{
  "application_no" : "102329389XXXX"
}

```
