修改结算帐号API

最新更新时间:2019.09.09 版本说明


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

注意:

1、本接口无需传银行开户名称参数。
   ① 若账户类型为“经营者个人银行卡”,则系统自动拉取特约商户的经营者姓名为开户名称。
   ② 若账户类型为“对公银行账户”,则系统自动拉取特约商户的公司名称为开户名称。

2、API发起修改结算账户信息,校验通过后,会即时生效新资料;

3、修改生效后,系统会自动汇款0.01元至新结算账户,验证是否可正常使用。可通过 查询结算账户API 查询验证结果

   ① 汇款验证中,商户可发起提现尝试。

   ② 系统成功汇款,该账户可正常发起提现。

   ③ 系统汇款失败,该账户无法发起提现,请检查修改。

接口说明

适用对象:普通服务商

请求URL:https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/{sub_mchid}/modify-settlement

请求方式:POST

接口规则:https://wechatpay-api.gitbook.io/wechatpay-api-v3


path 指该参数需在请求URL传参

query 指该参数需在请求URL传参

body 指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
特约商户号 sub_mchid string[8,10]

path请填写本服务商负责进件的特约商户号。
特殊规则:长度最小8个字节。
示例值:1511101111

账户类型 account_type string[1,32] body 根据特约商户号的主体类型,可选择的账户类型如下:
  1. 1、小微主体:经营者个人银行卡
  2. 2、个体工商户主体:经营者个人银行卡/ 对公银行账户
  3. 3、企业主体:对公银行账户
  4. 4、党政、机关及事业单位主体:对公银行账户
  5. 5、其他组织主体:对公银行账户
枚举值:

  1. ACCOUNT_TYPE_BUSINESS:对公银行账户
  2. ACCOUNT_TYPE_PRIVATE:经营者个人银行卡
示例值:ACCOUNT_TYPE_BUSINESS
开户银行 account_bank string[1,128] body 请填写开户银行名称,详细参见《开户银行对照表》。
示例值:工商银行
开户银行省市编码 bank_address_code string[1,128] body 需至少精确到市,详细参见《省市区编号对照表》。
示例值:110000
开户银行全称(含支行) bank_name string[1,128] body
  1. 若开户银行为“其他银行”,则需二选一填写“开户银行全称(含支行)”或“开户银行联行号”。
  2. 填写银行全称,如"深圳农村商业银行XXX支行" ,详细参见开户银行全称(含支行)对照表
示例值:施秉县农村信用合作联社城关信用社
开户银行联行号 bank_branch_id string[1,128] body
  1. 若开户银行为“其他银行”,则需二选一填写“开户银行全称(含支行)”或“开户银行联行号”。
  2. 填写银行联行号,详细参见《开户银行全称(含支行)对照表》。
示例值:402713354941
银行账号 account_number string[1,128] body 1、数字,长度遵循系统支持的对公/对私卡号长度要求
2、该字段需进行加密处理,加密方法详见《敏感信息加密说明》。(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOkJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYmli385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w==

请求示例


{
  "account_type": "ACCOUNT_TYPE_BUSINESS",
  "account_bank": "工商银行",
  "bank_address_code": "110000",
  "bank_name": "施秉县农村信用合作联社城关信用社",
  "bank_branch_id": "402713354941",
  "account_number": "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNg
  Ktxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiO
  kJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYm
  li385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEa
  YQE8ZRGYoeorwC+w=="
}
    
{
JAVA示例代码
}
    

返回参数

状态码 含义 描述
204 No Content 请求处理成功,无数据返回。

返回示例


   无数据(Http状态码为204)
                                

    http://2323weixin.qq.com
                                

错误码公共错误码

错误码 描述 解决方案
SYSTEMERROR 系统错误 系统异常,请使用相同参数稍后重新调用
PARAM_ERROR 参数错误 请使用正确的参数重新调用
INVALID_REQUEST 无效请求 请查看返回的错误信息,根据错误信息进行操作
NOAUTH 商户权限异常 请确认是否已经开通相关权限

版本说明

关闭
V1.0
2019年09月09日
1. 修改商户结算信息接口上线

技术咨询

反馈有奖