提交申请单

更新时间:2023.12.21

服务商(银行、支付机构、电商平台不可用)使用该接口提交商家资料,帮助商家入驻成为微信支付的特约商户。

流程指引请看:特约商户进件流程

注意

  1. 商户上送敏感信息时使用微信支付平台公钥加密,证书序列号包含在请求HTTP头部的Wechatpay-Serial,详见接口规则
  2. 微信支付平台证书公钥需调用接口获取,详见获取文档
  3. 调用接口获取的微信支付平台证书,证书需要解密后才能使用,详见解密说明文档
  4. 本接口不支持进件个人小微商户

# 接口说明

支持商户:
【普通服务商】
请求方式:
【POST】/v3/applyment4sub/applyment/
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点
【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看

频率限制: 15/s

# 请求参数

    Header HTTP头参数
  • Authorization 必填 string
    请参考 签名认证 生成认证信息
  • Accept 必填 string
    请设置为 application/json
  • Content-Type 必填 string
    请设置为 application/json
  • Wechatpay-Serial 必填 string
    【微信支付平台证书序列号】
    请求参数中的敏感字段,需要使用微信支付平台证书公钥加密。请设置为该证书的证书序列号。详见敏感信息加解密
    Body 包体参数
  • business_code 必填 string(124)
    【业务申请编号】
    1、只能由数字、字母或下划线组成,建议前缀为服务商商户号;
    2、服务商自定义的唯一编号;
    3、每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号。
  • contact_info 必填 object
    【超级管理员信息】
    超级管理员需在开户后进行签约,并可接收日常重要管理信息和进行资金操作,请确定其为商户法定代表人或负责人。
    • 属性
  • subject_info 必填 object
    【主体资料】
    请填写商家的营业执照/登记证书、经营者/法人的证件等信息
    • 属性
  • business_info 必填 object
    【经营资料】
    请填写商家的经营业务信息、售卖商品/提供服务场景信息
    • 属性
  • settlement_info 必填 object
    【结算规则】
    请填写商家的结算费率规则、特殊资质等信息
    • 属性
  • bank_account_info 必填 object
    【结算银行账户】
    请填写商家提现收款的银行账户信息
    • 属性
  • addition_info 选填 object
    【补充材料】
    根据实际审核情况,会额外要求商家提供指定的补充资料
    • 属性

请求示例

POST

# 应答参数

    200OK
  • applyment_id 必填 integer
    【微信支付申请单号】
    微信支付分配的申请单号

应答示例

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 频率限制 请降低调用频率
反馈
咨询
目录