提交申请单

更新时间:2024.12.06

渠道商可以通过该接口向微信支付提交商户的联系人、主体等信息,根据指引完成商户开户意愿确认。

功能接入可看产品流程指引

注意

  1. 商户上送敏感信息时使用微信支付平台公钥加密,证书序列号包含在请求HTTP头部的Wechatpay-Serial,详见接口规则

# 接口说明

支持商户:
【渠道商】【从业机构(银行)】【从业机构(支付机构)】
请求方式:
【POST】/v3/apply4subject/applyment/
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点
【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看

接口频率: 5QPS(商户号维度)

是否支持幂等:

# 请求参数

    Header HTTP头参数
  • Authorization 必填 string
    请参考 签名认证 生成认证信息
  • Accept 必填 string
    请设置为 application/json
  • Content-Type 必填 string
    请设置为 application/json
  • Wechatpay-Serial 必填 string
    【微信支付平台证书序列号】
    请求参数中的敏感字段,需要使用微信支付平台证书公钥加密。请设置为该证书的证书序列号。详见敏感信息加解密
    Body 包体参数
  • channel_id 选填 string(9)
    【渠道商户号】
    1、微信支付分配的渠道商户唯一标识
    2、当从业机构调用时,改字段必填,需填写从业机构下的渠道商户号
    3、当渠道商户调用时,该字段无需填写
  • business_code 必填 string(128)
    【业务申请编号】
    1、只能由数字、字母或下划线组成
    2、服务商自定义的唯一编号。每个编号对应一个申请单
    3、建议前缀带上服务商商户号,参看示例值
  • contact_info 必填 object
    【联系人信息】
    联系人信息,联系人是商户的联系人,将接收开户信息及日常重要管理信息,请确定联系人为商户法定代表人或经营者再进行操作。如联系人非商户法定代表人或经营者,请提交经办人身份证件和业务办理授权函。
    • 属性
  • subject_info 必填 object
    【主体信息】
    主体信息
    • 属性
  • identification_info 必填 object
    【法人身份信息】
    法人身份信息
    • 属性
  • ubo_info_list 选填 array
    【最终受益人信息列表(UBO)】
    仅企业需要填写。
    若经营者/法人不是最终受益所有人,则需提填写受益所有人信息,最多上传4个。
    若经营者/法人是最终受益所有人之一,可在此填写其他受益所有人信息,最多上传3个。
    根据国家相关法律法规,需要提供公司受益所有人信息,受益所有人需符合至少以下条件之一:
    1、直接或者间接拥有超过25%公司股权或者表决权的自然人。
    2、通过人事、财务等其他方式对公司进行控制的自然人。
    3、公司的高级管理人员,包括公司的经理、副经理、财务负责人、上市公司董事会秘书和公司章程规定的其他人员。
    • 数组
  • 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 INVALID_REQUEST 无效请求 请查看返回的错误信息,根据错误信息进行操作
403 NO_AUTH 商户权限异常 请确认是否已经开通相关权限
反馈
咨询
目录