申请入驻

场景介绍

使用申请入驻接口提交你的小微商户资料,申请后一般5分钟左右可以查询到具体的申请结果。

接口链接

URL地址:https://api.mch.weixin.qq.com/applyment/micro/submit

是否需要证书

请求需要双向证书。 详见证书使用

请求参数

字段名

变量名

必填

类型

示例值

描述

接口版本号

version

String(32)

3.0

固定版本号为3.0

平台证书序列号

cert_sn

String(64)

5663476TEREGD45FH63GDFHFG657FCHBFG

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

商户号

mch_id

String(32)

1230000109

服务商的商户号

随机字符串

nonce_str

String(32)

ibuaiVcKdpRxkhJA

自定义随机字符串,可参照随机数生成算法

签名类型

sign_type

String(128)

HMAC-SHA256

签名类型,仅支持HMAC-SHA256 。该字段需参与签名sign的计算。

签名

sign

String(64)

D675A1E471DBF7C0B1AC5883B5BDA9EF

通过签名计算后得到的签名值,详见签名生成算法

业务申请编号

business_code

String(32)

123456

服务商自定义的商户唯一编号。每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号。

身份证人像面照片

id_card_copy

String(256)

 

请填写由图片上传接口预先上传图片生成好的media_id

身份证国徽面照片

id_card_national

String(256)

 

请填写由图片上传接口预先上传图片生成好的media_id

身份证姓名

id_card_name

String(64)

佑佑

请填写小微商户本人身份证上的姓名,该字段需进行加密处理,加密方法详见敏感信息加密说明

身份证号码

id_card_number

String(18)

 

15位数字 或  17位数字+1位数字|X ,该字段需进行加密处理,加密方法详见敏感信息加密说明

身份证有效期限

id_card_valid_time

String(50)

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

1.注意参照示例中的格式

2.结束时间需大于开始时间

3.要与上传的身份证照片内容一致

开户名称

account_name

String(50)

 

必须与身份证姓名一致,该字段需进行加密处理,加密方法详见敏感信息加密说明

开户银行

account_bank

String(50)

工商银行

详细参见开户银行对照表

开户银行省市编码

bank_address_code

String(6)

110000

至少精确到市,详细参见微信支付提供省市对照表

开户银行全称(含支行)

bank_name

String(256)

深圳农村商业银行xxx支行

1)17家直连银行无需填写,其他银行请务必填写

2)需填写银行全称,如"深圳农村商业银行XXX支行"

详细参见开户银行全称(含支行)对照表

银行账号

account_number

String(50)

 

数字,长度遵循系统支持的对私卡号长度要求,该字段需进行加密处理,加密方法详见敏感信息加密说明。小微商户开户目前不支持以下前缀的银行卡"623501;621468;620522;625191;622384;623078;940034;622150;622151;622181;622188;955100;621095;620062;621285;621798;621799;621797;622199;621096;62215049;62215050;62215051;62218849;62218850;62218851;621622;623219;621674;623218;621599;623698;623699;623686;621098;620529;622180;622182;622187;622189;621582;623676;623677;622812;622810;622811;628310;625919;625368;625367;518905;622835;625603;625605;518905"

门店名称

store_name

String(128)

 

最长50个中文字符

门店场所:填写门店名称

流动经营/便民服务:填写经营/服务名称

线上商品/服务交易:填写线上店铺名称

门店省市编码

store_address_code

String(6)

110000

详细参见微信支付提供省市对照表

门店场所:填写门店省市编码

流动经营/便民服务:填写经营/服务所在地省市编码

线上商品/服务交易:填写卖家所在地省市编码

门店街道名称

store_street

String(500)

 

最长500个中文字符(无需填写省市信息)

门店场所:填写店铺详细地址,具体区/县及街道门牌号或大厦楼层

流动经营/便民服务:填写“无"

线上商品/服务交易:填写电商平台名称

门店经度

store_longitude

String(20)

113.941355

数字或小数

门店纬度

store_latitude

String(20)

22.546245

数字或小数 

门店门口照片

store_entrance_pic

String(256)

 

请填写已预先上传图片生成好的MediaID

门店场所:提交门店门口照片,要求招牌清晰可见

流动经营/便民服务:提交经营/服务现场照片

线上商品/服务交易:提交店铺首页截图

店内环境照片

indoor_pic

String(256)

 

 请填写已预先上传图片生成好的MediaID

门店场所:提交店内环境照片

流动经营/便民服务:可提交另一张经营/服务现场照片

线上商品/服务交易:提交店铺管理后台截图

经营场地证明

address_certification

String(256)

 

请填写已预先上传图片生成好的MediaID,门面租赁合同扫描件或经营场地证明(需与身份证同名)

商户简称

merchant_shortname

String(50)

 

UTF-8格式,中文占3个字节,即最多16个汉字长度。将在支付完成页向买家展示,需与商家的实际经营场景相符

客服电话

service_phone

String(50)

 

UTF-8格式,中文占3个字节,即最多16个汉字长度。在交易记录中向买家展示,请确保电话畅通以便平台回拨确认

售卖商品/提供服务描述

product_desc

String(50)

 

请填写以下描述之一:

餐饮

线下零售

居民生活服务

休闲娱乐

交通出行

其他

费率

rate

String(50)

0.6%

由服务商指定,微信支付提供字典值

补充说明

business_addition_desc

String(50)

 

可填写需要额外说明的文字

补充材料

business_addition_pics

String(50)

["123","456"]

最多可上传5张照片,请填写已预先上传图片生成好的MediaID

超级管理员姓名

contact

String(50)

 

和身份证姓名一致 ,该字段需进行加密处理,加密方法详见敏感信息加密说明,超级管理员需在开户后进行签约,并可接收日常重要管理信息和进行资金操作,请确定其为商户法定代表人或负责人

手机号码

contact_phone

String(11)

 

11位数字,手机号码 ,该字段需进行加密处理,加密方法详见敏感信息加密说明

联系邮箱

contact_email

String(50)

 

需要带@,遵循邮箱格式校验 ,该字段需进行加密处理,加密方法详见敏感信息加密说明

返回参数

字段名

变量名

必填

类型

示例值

描述

返回状态码

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时,返回有误的请求参数字段名。

以下字段当return_code 、result_code都为SUCCESS时有返回

商户申请单号

applyment_id

String(32)

1230000109

微信支付分配的申请单号

错误码

错误代码

名称

描述

解决方案

PARAM_ERROR

参数错误

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

人工检查过滤

EXIST

重入错误

business_code对应的申请单当前状态不可编辑,不能重复提交

可通过查询申请状态接口查看此申请单的申请状态,或更换business_code