提交申请单
更新时间:2025.03.26普通服务商(银行、支付机构、电商平台不可用)申请获取小微进件权限后,可使用该接口提交商家资料,帮助商家入驻成为微信支付的小微商户。
|
接口说明
支持商户:【普通服务商】
请求方式:【POST】/v3/applyment4sub/applyment/
请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点
【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看
请求参数
Header HTTP头参数
Authorization 必填 string
请参考签名认证生成认证信息
Accept 必填 string
请设置为application/json
Content-Type 必填 string
请设置为application/json
Wechatpay-Serial 必填 string
【微信支付公钥ID】或【微信支付平台证书序列号】请求参数中的敏感字段,需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号、平台证书加密敏感信息指引
body 包体参数
business_code 必填 string(124)
【业务申请编号 】
1、只能由数字、字母或下划线组成,建议前缀为服务商商户号;
2、服务商自定义的唯一编号;
3、每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号;
4、若申请单被驳回,可填写相同的“业务申请编号”,即可覆盖修改原申请单信息。
contact_info 必填 object
【超级管理员信息】 超级管理员需在开户后进行签约,并可接收日常重要管理信息和进行资金操作,请填写小微经营者信息
| 属性 | |
contact_name 必填 string(2048) 【超级管理员姓名】 1、若为小微主体类型,要求“超级管理员姓名”与“经营者的身份证姓名”一致; contact_id_number 选填 string(2048) 【超级管理员身份证件号码】 1、“超级管理员身份证号码”与“超级管理员微信OpenID”,二选一必填; openid 选填 string 【超级管理员微信OpenID】 1、“超级管理员身份证件号码”与“超级管理员微信openid”,二选一必填; mobile_phone 必填 string(2048) 【联系手机】 1、前后不能有空格、制表符、换行符;
3、用于接收微信支付的重要管理信息及日常操作验证码; contact_email 必填 string 【联系邮箱】 1、必填,用于接收微信支付的开户邮件及日常业务通知; |
subject_info 必填 object
【主体资料】 请填写商家的营业执照/登记证书、经营者/法定代表人的证件等信息
| 属性 | |||||||||||||||||||||||||
subject_type 必填 string 【主体类型】 主体类型包括: 可选取值
micro_biz_info 必填 object 【小微辅助证明材料】 请根据小微的实际经营情况,填写对应的经营场景资料
identity_info 必填 object 【经营者身份证件】请上传经营者的身份证件。
|
business_info 必填 object
【经营资料】 请填写商家的商家简称、客服电话。
| 属性 | |
merchant_shortname 必填 string(64) 【商户简称】 在支付完成页向买家展示,需与微信经营类目相关 service_phone 必填 string(32) 【客服电话】 将在交易记录中向买家展示,请确保电话畅通以便平台回拨确认
|
settlement_info 必填 object
【结算规则】 请填写商家的结算费率规则、特殊资质等信息
| 属性 | |
settlement_id 必填 string 【入驻结算规则ID】 请选择结算规则ID,详细参见《费率结算规则对照表》 qualification_type 必填 string 【所属行业】 请填写所属行业名称,详细参见《费率结算规则对照表》 qualifications 选填 array[string] 【特殊资质图片】 1、仅当商户选择了必需提交特殊资质的行业时,需要提供该项资料;若商户选择了无需特殊资质的行业,或未选择行业时,无需提交该项资料,详情查看《费率结算规则对照表》; 2、最多可上传5张照片,请填写通过《图片上传API》预先上传图片生成好的MediaID。 activities_id 选填 string 【优惠费率活动ID】 选择指定活动ID,如果商户有意向报名优惠费率活动,该字段必填,详细参见优惠费率活动对照表 activities_rate 选填 string 【优惠费率活动值】 根据优惠费率活动规则,由合作伙伴自定义填写,支持两个小数点,需在优惠费率活动ID指定费率范围内 (1)2023年7月17日-9月17日,各合作伙伴平台可选择只传入“活动费率值”,或分别传入“信用卡优惠活动费率值” 与 “非信用卡优惠活动费率值”,只传入“活动费率值”的情况下,平台将协助将申请单中的 “优惠活动费率值” 回填入新增的 “信用卡优惠活动费率值” 与 “非信用卡优惠活动费率值”中; debit_activities_rate 选填 string 【非信用卡活动费率值】 用户支付方式为借记卡时收取的手续费费率: credit_activities_rate 选填 string 【信用卡活动费率值】 用户支付方式为信用卡时收取的手续费费率: activities_additions 选填 array[string] 【优惠费率活动补充材料】 1、根据所选优惠费率活动,提供相关材料,详细参见优惠费率活动对照表; |
bank_account_info 必填 object
【结算银行账户】 请填写商家提现收款的银行账户信息
| 属性 | |
bank_account_type 必填 string(32) 【账户类型】 若主体为小微,可填写:经营者个人银行卡 可选取值
account_name 必填 string(2048) 【开户名称】1、选择“经营者个人银行卡”时,开户名称必须与“经营者证件姓名”一致; account_bank 必填 string(128) 【开户银行】 对私银行调用:查询支持个人业务的银行列表API bank_address_code 选填 string(128) 【开户银行省市编码】 该字段即将下线处理,无需传入 至少精确到市,详细参见省市区编号对照表 bank_branch_id 选填 string(128) 【开户银行银行号】 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行,开户银行全称(含支行)和开户银行联行号二选一; bank_name 选填 string(128) 【开户银行全称(含支行)】 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行,开户银行全称(含支行)和开户银行联行号二选一; account_number 必填 string(2048) 【银行账号】 1、数字,长度遵循系统支持的卡号长度要求表; |
addition_info 选填 object
【补充材料】 根据实际审核情况,会额外要求商家提供指定的补充资料
| 属性 | |
legal_person_commitment 选填 string 【法定代表人开户承诺函】 1、请上传法定代表人或负责人亲笔签署的开户承诺函扫描件(下载模板)。亲笔签名承诺函内容清晰可见,不得有涂污,破损,字迹不清晰现象; legal_person_video 选填 string(1024) 【法定代表人开户意愿视频】 1、建议法定代表人按如下话术录制“法定代表人开户意愿视频”: 我是#公司全称#的法定代表人(或负责人),特此证明本公司申请的商户号为我司真实意愿开立且用于XX业务(或XX服务)。我司现有业务符合法律法规及腾讯的相关规定。 2、支持上传5M内的视频,格式可为avi、wmv、mpeg、mp4、mov、mkv、flv、f4v、m4v、rmvb; business_addition_pics 选填 array[string] 【补充材料】 1、最多可上传5张照片; business_addition_msg 选填 string 【补充说明】 512字以内 |
请求示例
POST
应答参数
200 OK
applyment_id 必填 int64
【微信支付申请单号】 微信支付分配的申请单号
应答示例
200 OK
错误码
公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |
业务错误码
状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
400 | APPLYMENT_NOTEXIST | 申请单不存在 | 确认入参,传入正确的申请单编号 |
400 | PARAM_ERROR | 图片文件为空 | 商户更换文件后,重新调用 |
400 | PROCESSING | 存在流程进行中的申请单,请检查是否重入 | 可通过查询申请单状态查看此申请单的申请状态,或更换business_code提交新的申请单 |
403 | NO_AUTH | 商户权限异常 | 请确认是否已经开通相关权限 |
403 | REQUEST_BLOCKED | 未知图片类型 | 图片类型必须为JPG、BMP、PNG |
403 | REQUEST_BLOCKED | 图片meta信息不一致 | 请检查meta信息是否正确 |
403 | REQUEST_BLOCKED | 签名信息不匹配 | 请检查签名信息 |
429 | RATE_LIMITED | 频率限制 | 请降低调用频率 |

