微信实名认证¶
提供微信实名认证接口接口
请求参数¶
- 请求地址
https://spin.cloudpnr.com/ssproxy/applyWxRealName
- 公共请求参数
请求报文头HEADER - 「接口规则-参数规定-报文头」 ，请求报文体BODY - 「接口规则-参数规定-报文体」 ，响应报文体 - 「接口规则-参数规定-响应报文体」
- 请求参数(data)
| 参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|---|
| req_seq_id | 请求流水号 | String | Y | 32 | |
| req_date | 请求时间 | String | Y | 8 | |
| huifu_id | 汇付ID | String | Y | 18 | |
| pay_channel_id | 子渠道号 | String | N | 32 | 银行渠道号（PNRPAY和渠道商约定） |
| pay_scene | 支付场景 | String | N | 2 | 01-标准费率线上02-标准费率线下03-非盈利费率04-缴费费率05-保险费率06-行业活动费率07-校园餐饮费率08-中小幼费率09-非在线教培 |
| name | 联系人姓名 | String | Y | 64 | |
| mobile | 联系人手机号 | String | Y | 11 | |
| id_card_number | 联系人身份证号码 | String | Y | 32 | |
| cert_type | 证书类型 | String | N | 64 | 事业单位法人证书 CERTIFICATE_TYPE_2388 统一社会信用代码证书 CERTIFICATE_TYPE_2389 有偿服务许可证（军队医院适用） CERTIFICATE_TYPE_2390 医疗机构执业许可证（军队医院适用） CERTIFICATE_TYPE_2391 企业营业执照（挂靠企业的党组织适用） CERTIFICATE_TYPE_2392 组织机构代码证（政府机关适用） CERTIFICATE_TYPE_2393 社会团体法人登记证书 CERTIFICATE_TYPE_2394 民办非企业单位登记证书 CERTIFICATE_TYPE_2395 基金会法人登记证书 CERTIFICATE_TYPE_2396 慈善组织公开募捐资格证书 CERTIFICATE_TYPE_2397 农民专业合作社法人营业执照 CERTIFICATE_TYPE_2398 宗教活动场所登记证 CERTIFICATE_TYPE_2399 其他证书/批文/证明 CERTIFICATE_TYPE_2400 |
| cert_number | 证书编号 | String | N | 32 | 事业单位填写，图片上传接口生成的fileId |
| cert_copy | 证书照片 | String | N | 64 | 事业单位填写，图片上传接口生成的fileId |
| micro_biz_type | 小微经营类型 | String | N | 32 | 小微经营类型 门店场所：MICRO_TYPE_STORE 流动经营/便民服务：MICRO_TYPE_MOBILE 线上商品/服务交易：MICRO_TYPE_ONLINE |
| store_name | 门店名称 | String | N | 128 | |
| store_header_copy | 门店门头照片 | String | N | 64 | 小微商户填写，图片上传接口生成的fileId |
| store_indoor_copy | 店内环境照片 | String | N | 64 | 小微商户填写，图片上传接口生成的fileId |
| store_address_code | 门店省市编码 | String | N | 16 | |
| store_address | 门店地址 | String | N | 128 | |
| identification_front_copy | 身份证件正面照片 | String | N | 64 | 小微商户填写，图片上传接口生成的fileId |
| identification_back_copy | 身份证件反面照片 | String | N | 64 | 小微商户填写，图片上传接口生成的fileId |
| company_prove_copy | 单位证明函照片 | String | N | 64 | 事业单位填写，图片上传接口生成的fileId |
| category_id | 特殊行业Id | String | N | 3 | 特殊行业填写，参看微信支付提供的特殊行业id对照表：https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/applysubject_new/chapter6_1.shtml 示例值：100 |
| owner | 经营者/法人是否为受益人 | String | N | 1 | 企业开通微信支付时需要填写；Y：是最终受益人；N：非最终受益人； |
| identification_address | 法人证件居住地址 | String | N | 256 | 1、主体类型为企业时，需要填写。其他主体类型，无需上传。2、请按照证件上住址填写，若证件上无住址则按照实际住址填写，如广东省深圳市南山区xx路xx号xx室 |
| ubo_info_list | 受益人信息 | String | N | 受益人仅企业需要填写。若经营者/法人不是最终受益所有人，则需提填写受益所有人信息，最多上传4个。 若经营者/法人是最终受益所有人之一，可在此填写其他受益所有人信息，最多上传3个。根据国家相关法律法规，需要提供公司受益所有人信息，受益所有人需符合至少以下条件之一：1、直接或者间接拥有超过25%公司股权或者表决权的自然人。2、通过人事、财务等其他方式对公司进行控制的自然人。3、公司的高级管理人员，包括公司的经理、副经理、财务负责人、上市公司董事会秘书和公司章程规定的其他人员。 | |
| contact_type | 联系人类型 | String | Y | 10 | LEGAL：经营者/法人；SUPER：经办人（经商户授权办理微信支付业务的人员）1、主体为“小微/个人卖家”，可选择：LEGAL2、主体为“个体工商户/企业/政府机关/事业单位/社会组织”，可选择：LEGAL、SUPER |
| contact_id_doc_type | 联系人证件类型 | String | N | 64 | 当联系人类型是经办人时，请上传联系人证件类型枚举值：个体户/企业/事业单位/社会组织：可选择任一证件类型，政府机关仅支持身份证类型。00:身份证 01:护照 02:军官证 03:士兵证 04:回乡证 05:户口本 06:外国护照 07:其他 08:暂住证 09:警官证 10:文职干部证 11:港澳同胞回乡证；12：外国人居留证 13：港澳居民证 14:台湾居民证 |
| contact_period_begin | 联系人证件有效期开始时间 | String | N | 20 | 1、当联系人类型是经办人时，请上传证件有效期开始时间2、请按照示例值填写3、结束时间大于开始时间示例值：2019-06-06 |
| contact_period_end | 联系人证件有效期结束时间 | String | N | 20 | 1、当联系人类型是经办人时，请上传证件有效期开始时间2、请按照示例值填写，若证件有效期为长期，请填写：长期3、结束时间大于开始时间示例值：2026-06-06 |
| finance_institution_flag | 是否金融机构 | String | N | 2 | 选填，请根据申请主体的实际情况填写，可参考选择：https://kf.qq.com/faq/220215IrMRZ3220215n6buiU.html1、若商户主体是金融机构，则填写：true。2、若商户主体不是金融机构，则填写：false。若未传入将默认填写：false |
| finance_type | 金融机构类型 | String | N | 128 | 当主体是金融机构时，必填金融机构类型需与营业执照/登记证书上一致，可参考选择金融机构指引：https://kf.qq.com/faq/220215IrMRZ3220215n6buiU.htmlBANK_AGENT： 银行业, 适用于商业银行、政策性银行、农村合作银行、村镇银行、开发性金融机构等PAYMENT_AGENT：支付机构, 适用于非银行类支付机构INSURANCE：保险业, 适用于保险、保险中介、保险代理、保险经纪等保险类业务TRADE_AND_SETTLE：交易及结算类金融机构, 适用于交易所、登记结算类机构、银行卡清算机构、资金清算中心等OTHER：其他金融机构, 适用于财务公司、信托公司、金融资产管理公司、金融租赁公司、汽车金融公司、贷款公司、货币经纪公司、消费金融公司、证券业、金融控股公司、股票、期货、货币兑换、小额贷款公司、金融资产管理、担保公司、商业保理公司、典当行、融资租赁公司、财经咨询等其他金融业务 |
| special_file_info_list | 文件列表 | List | N | 特殊行业填写 |
special_file_info_list(特殊行业文件列表)
| 参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|---|
| file_type | 文件类型 | String | Y | 8 |
28：联系人身份证正面照；F29：联系人身份证反面照；F33：联系人护照人像面；F241：联系人证件照正面（非身份证与护照类型）；F242：联系人证件照反面（非身份证类型）；F227：微信业务办理授权函； F236：金融机构许可证图片一；F237：金融机构许可证图片二；F238：金融机构许可证图片三；F239：金融机构许可证图片四；F240：金融机构许可证图片五； |
| file_id | 文件jfileID | String | Y | 128 | 图片上传接口生成的fileId |
ubo_info_list(受益人信息)
| 参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|---|
| ubo_id_doc_type | 证件类型 | String | Y | 10 | 请填写受益人的证件类型枚举值：个体户/企业/事业单位/社会组织：可选择任一证件类型，政府机关仅支持身份证类型。00:身份证 01:护照 02:军官证 03:士兵证 04:回乡证 05:户口本 06:外国护照 07:其他 08:暂住证 09:警官证 10:文职干部证 11:港澳同胞回乡证 12：外国人居留证 13：港澳居民证 14:台湾居民证 |
| ubo_id_doc_copy | 证件正面照片 | String | Y | 64 | 1、请上传受益人证件的正面照片2、若证件类型为身份证，请上传人像面照片3、可上传1张图片，请填写通过预先上传图片生成好的fileId4、请上传彩色照片or彩色扫描件or复印件（需加盖公章鲜章） ，可添加“微信支付”相关水印（如微信支付认证） |
| ubo_id_doc_copy_back | 证件反面照片 | String | N | 64 | 1、请上传受益人证件的反面照片2、若证件类型为护照，无需上传反面照片3、可上传1张图片，请填写通过预先上传图片生成好的fileId4、请上传彩色照片or彩色扫描件or复印件（需加盖公章鲜章）， 可添加“微信支付”相关水印（如微信支付认证） |
| ubo_id_doc_name | 证件姓名 | String | Y | 128 | 证件姓名 |
| ubo_id_doc_number | 证件号码 | String | Y | 128 | 证件号码 |
| ubo_id_doc_address | 证件居住地址 | String | Y | 256 | 请按照证件上住址填写，若证件上无住址则按照实际住址填写，如广东省深圳市南山区xx路xx号xx室。 |
| ubo_period_begin | 证件有效期开始时间 | String | Y | 20 | 1、请按照示例值格式填写2、结束时间大于开始时间示例值：2019-06-06 |
| ubo_period_end | 证件有效期结束时间 | String | Y | 20 | 1、请按照示例值格式填写，若证件有效期为长期，请填写：长期2、结束时间大于开始时间示例值：2026-06-06 |
响应参数¶
- 同步响应参数(data)
| 参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|---|
| sub_resp_code | 返回码 | String | Y | 8 | 业务返回码 |
| sub_resp_desc | 返回描述 | String | Y | 512 | 业务返回描述 |
| huifu_id | 汇付ID | String | Y | 18 | |
| applyment_id | 申请单编号 | String | N | 256 | 微信支付分配的申请单号，申请成功时返回 |
请求示例¶
{
"sys_id":"ssproxy_dev",
"data":"{\"req_seq_id\":\"rQ20200513741781\",\"req_date\":\"20200513\",\"huifu_id\":\"6666000003134542\",\"pay_channel_id\":\"JQF00001\",\"pay_scene\":\"02\",\"name\":\"王团体\",\"mobile\":\"1552470931\",\"id_card_number\":\"513436200009271323\",\"cert_type\":\"CERTIFICATE_TYPE_2388\",\"cert_number\":\"545678453456783423\",\"micro_biz_type\":\"MICRO_TYPE_STORE\",\"store_name\":\"门店1\",\"store_address_code\":\"310000\",\"store_address\":\"上海市宜山路23350\",\"store_header_copy\":\"d1451277-85c6-3177-ac3d-a8be47b9ae9d\",\"store_indoor_copy\":\"009cd33c-01be-31f0-8e8c-615460949b96\",\"identification_front_copy\":\"009cd33c-01be-31f0-8e8c-615460949b96\",\"identification_back_copy\":\"009cd33c-01be-31f0-8e8c-615460949b96\",\"cert_copy\":\"009cd33c-01be-31f0-8e8c-615460949b96\",\"company_prove_copy\":\"009cd33c-01be-31f0-8e8c-615460949b96\"}",
"sign":"${sign}",
"sign_type":"RSA2"
}
响应示例¶
{
"data":"{\"sub_resp_code\":\"00000000\",\"huifu_id\":\"6666000003149748\",\"sub_resp_desc\":\"成功\"}",
"resp_code":"10000",
"resp_desc":"成功调用",
"sign":"J2xU8KlXqlvntSVTKl7v2RIX+ui5wkSWY0X4zsN4aIsx/jhUc6GSY8BwVVnjadaDh6FjvuQ1andEquRWFxAQPReNNhwii7YHKPYDCYlu8quMAdukyi+Xu+UXmohJNoUfPo8md/oNCuqNWGqEd44tvcflJs8Lh8rm61xXFcFPnOI="
}
