提交申请单
更新时间：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
1curl -X POST \ 2 https://api.mch.weixin.qq.com/v3/applyment4sub/applyment \ 3 -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \ 4 -H "Accept: application/json" \ 5 -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1" \ 6 -H "Content-Type: application/json" \ 7 -d '{ 8 "business_code" : "1900013511_10000", 9 "contact_info" : { 10 "contact_name" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==", 11 "contact_id_number" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==", 12 "openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o", 13 "mobile_phone" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==", 14 "contact_email" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==" 15 }, 16 "subject_info" : { 17 "subject_type" : "SUBJECT_TYPE_MICRO", 18 "micro_biz_info" : { 19 "micro_biz_type" : "MICRO_TYPE_STORE", 20 "micro_store_info" : { 21 "micro_name" : "大郎烧饼", 22 "micro_address_code" : "440305", 23 "micro_address" : "南山区xx大厦x层xxxx室", 24 "store_entrance_pic" : "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo", 25 "micro_indoor_copy" : "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo", 26 "store_longitude" : "113.941355", 27 "store_latitude" : "22.546245" 28 }, 29 "micro_online_info" : { 30 "micro_online_store" : "李三服装店", 31 "micro_ec_name" : "XX购物平台", 32 "micro_qrcode" : "https://www.qq.com", 33 "micro_link" : "https://www.qq.com" 34 } 35 }, 36 "identity_info" : { 37 "id_doc_type" : "IDENTIFICATION_TYPE_IDCARD", 38 "id_card_info" : { 39 "id_card_copy" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ", 40 "id_card_national" : "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4", 41 "id_card_name" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==", 42 "id_card_number" : "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==", 43 "card_period_begin" : "2026-06-06", 44 "card_period_end" : "2026-06-06" 45 } 46 }, 47 }, 48 "business_info" : { 49 "merchant_shortname" : "张三餐饮店", 50 "service_phone" : "0758XXXXX" 51 }, 52 "settlement_info" : { 53 "settlement_id" : "703", 54 "qualification_type" : "餐饮", 55 "qualifications" : [ 56 "example_qualifications" 57 ], 58 "activities_id" : "716", 59 "activities_rate" : "0.6", 60 "debit_activities_rate" : "0.6", 61 "credit_activities_rate" : "0.6", 62 "activities_additions" : [ 63 "example_activities_additions" 64 ], 65 }, 66 "bank_account_info" : { 67 "bank_account_type" : "BANK_ACCOUNT_TYPE_CORPORATE", 68 "account_name" : "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==", 69 "account_bank" : "工商银行", 70 "bank_address_code" : "110000", 71 "bank_branch_id" : "402713354941", 72 "bank_name" : "施秉县农村信用合作联社城关信用社", 73 "account_number" : "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOkJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYmli385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w==" 74 }, 75 "addition_info" : { 76 "legal_person_commitment" : "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4", 77 "legal_person_video" : "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4", 78 "business_addition_pics" : [ 79 "example_business_addition_pics" 80 ], 81 "business_addition_msg" : "特殊情况，说明原因" 82 } 83 }'
应答参数
200 OK
applyment_id 必填 int64
【微信支付申请单号】 微信支付分配的申请单号
应答示例
200 OK
1{ 2 "applyment_id" : 2000002124775691 3} 4
错误码
公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
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 | 频率限制 | 请降低调用频率 |
