提交升级申请单接口

场景介绍

使用“提交升级申请单”接口为小微商户发起升级流程,根据商户实际情况可升级为个体户、企业、其他组织。

接口规则

请求Url https://api.mch.weixin.qq.com/applyment/micro/submitupgrade
是否需要证书 是, 详见证书使用

请求参数

名称

变量名

必填

类型

示例值

描述

接口版本号

version

String(32)

1.0

默认值1.0

商户号

mch_id

String(32)

1230000109

服务商的商户号

随机字符串

nonce_str

String(32)

ibuaiVcKdpRxkhJA

参考签名规则

签名类型

sign_type

String(128)

HMAC-SHA256

签名类型,仅支持HMAC-SHA256

签名

sign

String(64)

D675A1E471DBF7C0B1AC5883B5BDA9EF

参考签名规则

平台证书序列号

cert_sn

String(64)

5663476TEREGD45FH63GDFHFG657FCHBFG

用于对敏感信息进行加密的平台证书序列号,获取方法详见平台证书及序列号获取接口(接口返回参数"serial_no"即为平台证书序列号)

小微商户号

sub_mch_id

String(32)

1230000109

小微商户的商户号(小微申请状态需为待签约或完成)

主体类型

organization_type

String(32)

     2

2-企业
4-个体工商户
1708-其他组织

营业执照扫描件

 business_license_copy

String(256)

 

  1. 请填写通过图片上传接口预先上传图片生成好的MediaID
  2. 仅能上传1张图片

营业执照注册号

business_license_number

String(32)

123456789012345

  1. 请填写营业执照上的营业执照注册号
  2. 若主体类型为个体工商户或企业,注册号格式须为15位数字或 18位数字|大写字母

商户名称

merchant_name

String(110)

深圳腾讯科技有限公司

  1. 请填写营业执照上的商户名称
  2. 2~110个字符,支持括号
  3. 个体工商户不能以“公司”结尾

注册地址

company_address

String(256)

深圳市腾讯
    大厦

256个字以内

经营者姓名/法定代表人

legal_person

String(256)

 

  1. 请填写营业执照上的经营者/法人姓名
  2. 必须与小微商户联系人相同
  3. 该字段需进行加密处理,加密方法详见敏感信息加密说明

营业期限

business_time

String(50)

["1970-01-01","长期"]

  1. 请填写营业执照上的营业期限
  2. 注意参照示例中的格式
  3. 结束时间需大于开始时间
  4. 有效期必须大于60天

营业执照类型

business_licence_type

String(32)

1762

  1. 1762-已三证合一    1763-未三证合一
  2. 若营业执照上的营业执照注册号为18位统一社会信用代码,请选择“已三证合一”,否则请选择“未三证合一”
  3. 注意:参数为business_licence_type,这里为licence,非license

组织机构代码证照片

organization_copy

String(256)

 

  1. 请填写通过图片上传接口预先上传图片生成好的MediaID
  2. 仅能上传1张图片
  3. 主体类型为企业其他组织 且 营业执照为未三证合一,必填

组织机构代码

organization_number

String(32)

1234567-1

  1. 请填写组织机构代码证上的组织机构代码
  2. 9或10位 数字|字母|连字符
  3. 主体类型为企业其他组织 且 营业执照为未三证合一,必填

组织机构代码有效期限

organization_time

String(128)

["1970-01-01","长期"]

  1. 请填写组织机构代码证上的组织机构代码有效期
  2. 注意参照示例中的格式
  3. 结束时间需大于开始时间
  4. 有效期必须大于60天
  5. 主体类型为企业其他组织 且 营业执照为未三证合一,必填

开户名称

account_name

String(50)

 

  1. 请填写对公账户,开户名称必须与营业执照上的“商户名称”一致
  2. 主体类型为企业其他组织时,必填
  3. 该字段需进行加密处理,加密方法详见敏感信息加密说明

开户银行

account_bank

String(50)

工商银行

  1. 详细参见开户银行对照表
  2. 主体类型为企业其他组织时,必填

开户银行省市编码

bank_address_code

String(6)

11000

  1. 至少精确到市,详细参见省市区编号对照表
  2. 主体类型为企业其他组织时,必填

开户银行全称
(含支行)

bank_name

String(256)

深圳农村商业银行xxx支行

  1. 17家直连银行无需填写,其他银行请务必填写
  2. 需填写银行全称,如"深圳农村商业银行XXX支行"
  3. 详细参见开户银行全称(含支行)对照表
  4. 主体类型为企业其他组织 且 开户银行为非直连银行时,必填

银行卡号

account_number

String(50)

 

  1. 数字,长度遵循系统支持的对公卡号长度要求
  2. 主体类型为企业其他组织时,必填
  3. 该字段需进行加密处理,加密方法详见敏感信息加密说明

商户简称

merchant_shortname

String(50)

 

2~30个中文字符、英文字符、符号。将在支付完成页向买家展示,需与微信经营范围相关

费率结算规则ID

business

String(10)

 

详细参见费率结算规则对照表

特殊资质

qualifications

String(1280)

["xxx","xxx"]

1)视行业而定,详细参见费率结算规则对照表
2)注意示例中的格式
3)最多可上传5张照片,请填写通过图片上传接口预先上传图片生成好的MediaID

经营场景

business_scene

String(50) 

[1721]

  1. 1721-线下

补充说明

business_addition_desc

String(512)

 

 

补充材料

business_addition_pics

String(1280)

["123","456"]

  1. 最多可上传5张照片,请填写通过图片上传接口预先上传图片生成好的MediaID
  2. 请使用JSON格式的数组

联系邮箱

contact_email

String(50)

123@qq.com

联系邮箱
需要带@,遵循邮箱格式校验 ,若小微商户入驻时没有提交邮箱,该字段必填,该字段需进行加密处理,加密方法详见敏感信息加密说明

返回结果

名称

变量名

必填

类型

示例值

描述

返回状态码

return_code

String(16)

FAIL

SUCCESS/FAIL

返回信息

return_msg

String(128)

签名失败

只支持POST方法
xml格式错误
协议转换时发生系统错误
未检测到必填参数XXX
请求参数签名错误
返回结果时签名失败

当return_code为SUCCESS的时候,还会包括以下字段:

名称

变量名

必填

类型

示例值

描述

随机字符串

nonce_str

String(32)

ibuaiVcKdpRxkhJA

随机字符串

签名

sign

String(32)

D675A1E471DBF7C0B1AC5883B5BDA9EF

参考2.2签名规则

业务结果

result_code

String(32)

SUCCESS

SUCCESS/FAIL

错误代码

err_code

String(32)

PARAM_ERROR

参考业务错误码列表

错误代码描述

err_code_des

String(128)

商户号信息有误,请检查修改后重试

参考业务错误码列表

参数校验不通过的字段名

err_param

String(128)

account_no

当err_code为PARAM_ERROR时,返回有误的请求参数字段名。

错误码列表

错误代码

名称

描述

解决方案

PARAM_ERROR

参数错误

参数填写有误,请检查后重试

人工检查过滤

PROCESSING

重入错误

当前小微商户号存在正在流程中的申请

可通过查询升级申请单状态接口查看升级的申请申请状态