主题
微信开户认证申请
接口描述
- 微信开户认证申请。
请求URL
/wxpay/merchant/authApply
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202415629590370906 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 43e2c287-24b1-4cd1-b3d2-e40e7840cc40 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| wxSubMchId | 否 | string | 32 | 微信商户号 | - |
| channelId | 是 | string | 32 | 渠道商id | |
| businessCode | 是 | string | 32 | 业务申请编号 | |
| contactInfo | 是 | string | 32 | 联系人信息(JSON字符串密文) | |
| subjectInfo | 是 | string | 32 | 主体信息(JSON字符串) | |
| businessLicenceInfo | 否 | string | 32 | 营业执照信息(JSON字符串密文),主体类型为企业/个体户时，营业执照信息必填 | |
| certificateInfo | 否 | string | 32 | 登记证书信息(JSON字符串密文),主体为政府机关/事业单位/社会组织时，必填 | |
| assistProveInfo | 否 | string | 32 | 辅助证明材料信息(JSON字符串),主体类型为小微商户时，辅助证明材料信息必填 | |
| specialOperationList | 否 | string | 32 | 特殊行业经营许可证(JSON数组字符串) | |
| financeInstitutionInfo | 否 | string | 32 | 金融机构许可证(JSON字符串),当主体是金融机构时，必填 | |
| identificationInfo | 是 | string | 32 | 法人身份信息(JSON字符串密文) | |
| uboInfoList | 否 | string | 32 | 经营许可证(JSON数组字符串密文),仅企业需要填写 | - |
联系人信息（contactInfo）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| name | string(1024) | 必填 | 联系人姓名 |
| mobile | string(1024) | 必填 | 联系人手机 |
| idCardNumber | string(1024) | 选填 | 联系人证件号码 |
| contactType | string | 必填 | 联系人类型： 1、主体为“小微/个人卖家 ”，可选择：LEGAL：经营者/法人。 2、主体为“个体工商户/企业/政府机关/事业单位/社会组织”，可选择：LEGAL：经营者/法人、SUPER：经办人。 |
| contactIdDocType | string | 选填 | 联系人证件类型 IDENTIFICATION_TYPE_IDCARD: 中国大陆居民-身份证 IDENTIFICATION_TYPE_OVERSEA_PASSPORT: 其他国家或地区居民-护照 IDENTIFICATION_TYPE_HONGKONG_PASSPORT: 中国香港居民-来往内地通行证 IDENTIFICATION_TYPE_MACAO_PASSPORT: 中国澳门居民-来往内地通行证 IDENTIFICATION_TYPE_TAIWAN_PASSPORT: 中国台湾居民-来往大陆通行证 IDENTIFICATION_TYPE_FOREIGN_RESIDENT: 外国人居留证 IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT: 港澳居民证 IDENTIFICATION_TYPE_TAIWAN_RESIDENT: 台湾居民证 |
| contactIdDocCopy | string(256) | 选填 | 联系人证件正面照片 |
| contactIdDocCopyBack | string(256) | 选填 | 联系人证件反面照片 |
| contactPeriodBegin | string(128) | 选填 | 证件有效期开始时间YYYY-MM-DD |
| contactPeriodEnd | string(128) | 选填 | 证件有效期结束时间YYYY-MM-DD |
主体信息（subjectInfo）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| subjectType | string | 必填 | 主体类型 SUBJECT_TYPE_ENTERPRISE: 企业，营业执照上的主体类型一般为有限公司、有限责任公司，SUBJECT_TYPE_INSTITUTIONS_CLONED: 事业单位，包括国内各类事业单位，如：医疗、教育、学校等单位SUBJECT_TYPE_INDIVIDUAL: 个体工商户，营业执照上的主体类型一般为个体户、个体工商户、个体经营SUBJECT_TYPE_OTHERS: 社会组织，包括社会团体、民办非企业、基金会、基层群众性自治组织、农村集体经济组织等组织SUBJECT_TYPE_MICRO: 小微商户，无营业执照、免办理工商注册登记的实体商户，SUBJECT_TYPE_GOVERNMENT: 政府机关，包括各级、各类政府机关，如机关党委、税务、民政、人社、工商、商务、市监等 |
| isFinanceInstitution | string | 选填 | 是否金融机构若商户主体是金融机构，则填写：true，若商户主体不是金融机构，则填写：false。若未传入将默认填写：false |
| companyProveCopy | string(255) | 选填 | 单位证明函照片 |
营业执照（businessLicenceInfo）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| licenceNumber | string(32) | 条件 | 营业执照注册号 |
| licenceCopy | string(255) | 条件 | 营业执照照片 |
| merchantName | string(128) | 条件 | 商户名称 |
| legalPerson | string(100) | 条件 | 法人姓名 |
| companyAddress | string(128) | 条件 | 注册地址 |
| licenceValidDate | string(64) | 条件 | 营业执照有效日期营业执照有效日期 1、日期格式应满足合法的YYYY-MM-DD格式，参见示例值 2、开始时间不能小于1900-01-013、 3若证件有效期为长期，请填写：长期。 4、开始时间不能大于等于当前日期，结束时间需大于开始时间。 示例值["2017-10-28","长期"] |
登记证书（certificateInfo）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| certType | string | 条件 | 证书类型 当主体为事业单位时，选择此枚举值： CERTIFICATE_TYPE_2388：事业单位法人证书 当主体为政府机关，选择此枚举值： CERTIFICATE_TYPE_2389：统一社会信用代码证书 当主体为社会组织，选择以下枚举值之一： CERTIFICATE_TYPE_2389：统一社会信用代码证书 CERTIFICATE_TYPE_2394：社会团体法人登记证书 CERTIFICATE_TYPE_2395：民办非企业单位登记证书 CERTIFICATE_TYPE_2396：基金会法人登记证书 CERTIFICATE_TYPE_2520：执业许可证/执业证 CERTIFICATE_TYPE_2521：基层群众性自治组织特别法人统一社会信用代码证 CERTIFICATE_TYPE_2522：农村集体经济组织登记证 CERTIFICATE_TYPE_2399：宗教活动场所登记证 CERTIFICATE_TYPE_2400：政府部门下发的其他有效证明文件 |
| certNumber | string(50) | 条件 | 证书编号 |
| certCopy | string(255) | 条件 | 证书照片 |
| merchantName | string(128) | 条件 | 商户名称 |
| legalPerson | string(100) | 条件 | 法人姓名 |
| companyAddress | string(128) | 条件 | 注册地址 |
| certValidDate | string(64) | 条件 | 证书有效日期 |
辅助证明（assistProveInfo）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| microBizType | string | 条件 | 小微经营类型 MICRO_TYPE_STORE: 门店场所 MICRO_TYPE_MOBILE: 流动经营/便民服务 MICRO_TYPE_ONLINE: 线上商品/服务交易 |
| storeName | string(50) | 条件 | 门店名称 |
| storeAddressCode | string(16) | 条件 | 门店省市编码 |
| storeAddress | string(512) | 条件 | 门店地址 |
| storeHeaderCopy | string(255) | 条件 | 门店门头照片 |
| storeIndoorCopy | string(255) | 条件 | 店内环境照片 |
特殊行业经营许可证信息（specialOperation）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| categoryId | integer | 必填 | 行业类目id 参看微信支付提供的特殊行业id对照表 |
| operationCopyList | array[string(255)] | 选填 | 行业经营许可证资质照片 |
金融机构（financeInstitutionInfo）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| financeType | string | 条件 | 金融机构类型 BANK_AGENT: 银行业，适用于商业银行、政策性银行、农村合作银行、村镇银行、开发性金融机构等, PAYMENT_AGENT: 支付机构，适用于非银行类支付机构, INSURANCE: 保险业，适用于保险、保险中介、保险代理、保险经纪等保险类业务, TRADE_AND_SETTLE: 交易及结算类金融机构，适用于交易所、登记结算类机构、银行卡清算机构、资金清算中心等, OTHER: 其他金融机构 |
| financeLicensePics | array[string] | 条件 | 金融机构许可证图片 |
法人证件信息（identificationInfo）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| idHolderType | string | 选填 | 证件持有人类型 1. 主体类型为政府机关/事业单位时选传： （1）若上传的是法人证件，则不需要上传该字段 （2）若因特殊情况，无法提供法人证件时，可上传经办人。 （经办人：经商户授权办理微信支付业务的人员，授权范围包括但不限于签约，入驻过程需完成账户验证）。 2. 主体类型为企业/个体户/社会组织时，默认为经营者/法人，不需要上传该字段 可选取值 LEGAL: 证件持有人类型-经营者/法人 SUPER: 证件持有人类型-经办人 |
| identificationType | string | 选填 | 证件类型 当证件持有人类型为法人时必填 IDENTIFICATION_TYPE_IDCARD: 中国大陆居民-身份证 IDENTIFICATION_TYPE_OVERSEA_PASSPORT: 其他国家或地区居民-护照 IDENTIFICATION_TYPE_HONGKONG_PASSPORT: 中国香港居民-来往内地通行证 IDENTIFICATION_TYPE_MACAO_PASSPORT: 中国澳门居民-来往内地通行证 IDENTIFICATION_TYPE_TAIWAN_PASSPORT: 中国台湾居民-来往大陆通行证 IDENTIFICATION_TYPE_FOREIGN_RESIDENT: 外国人居留证 IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT: 港澳居民证 IDENTIFICATION_TYPE_TAIWAN_RESIDENT: 台湾居民证 |
| identificationName | string(1024) | 选填 | 证件姓名 当证件持有人类型为法人时必填 |
| identificationNumber | string(1024) | 选填 | 证件号码 当证件持有人类型为法人时必填 |
| identificationValidDate | string(64) | 选填 | 证件有效日期 |
| identificationFrontCopy | string(255) | 选填 | 证件正面照片 当证件持有人类型为法人时必填 |
| identificationBackCopy | string(255) | 选填 | 证件反面照片 当证件持有人类型为法人时必填 |
| authorizeLetterCopy | string(255) | 选填 | 法定代表人说明函 |
| owner | string | 选填 | 经营者/法人是否为受益人 true/false |
| identificationAddress | string(512) | 选填 | 证件居住地址 主体类型为企业时，需要填写 |
受益人信息（uboInfo）
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| uboIdDocType | string | 选填 | 证件类型 IDENTIFICATION_TYPE_IDCARD: 中国大陆居民-身份证 IDENTIFICATION_TYPE_OVERSEA_PASSPORT: 其他国家或地区居民-护照 IDENTIFICATION_TYPE_HONGKONG_PASSPORT: 中国香港居民-来往内地通行证 IDENTIFICATION_TYPE_MACAO_PASSPORT: 中国澳门居民-来往内地通行证 IDENTIFICATION_TYPE_TAIWAN_PASSPORT: 中国台湾居民-来往大陆通行证 IDENTIFICATION_TYPE_FOREIGN_RESIDENT: 外国人居留证 IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT: 港澳居民证 IDENTIFICATION_TYPE_TAIWAN_RESIDENT: 台湾居民证 |
| uboIdDocCopy | string(256) | 选填 | 证件正面照片 |
| uboIdDocCopyBack | string(256) | 选填 | 证件反面照片 |
| uboIdDocName | string(1024) | 选填 | 证件姓名 |
| uboIdDocNumber | string(1024) | 选填 | 证件号码 |
| uboIdDocAddress | string(1024) | 选填 | 证件居住地址 |
| uboPeriodBegin | string(128) | 选填 | 证件有效期开始时间 YYYY-MM-DD格式 |
| uboPeriodEnd | string(128) | 选填 | 证件有效期结束时间 YYYY-MM-DD格式 |
公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| applymentId | 是 | string | 微信申请单编号 | ||
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应示例
json
{
"code": "00000000",
"message": "成功",
"applymentId": "adadasdasdas",
"transDate": "1731469621597",
"transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
"signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g=="
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述