支付宝实名申请提交接口

提供支付宝实名申请提交接口

请求参数

• 请求地址

https://spin.cloudpnr.com/ssproxy/ali/realname/apply

• 公共请求参数

请求报文头HEADER - 「接口规则-参数规定-报文头」 ，请求报文体BODY - 「接口规则-参数规定-报文体」 ，响应报文体 - 「接口规则-参数规定-响应报文体」

• 请求参数(data)

参数	中文名	类型	必填	最大长度	说明
req_seq_id	请求流水号	String	Y	32	请求流水号
req_date	请求时间	String	Y	8	请求时间YYYYMMDD
pay_channel_id	子渠道号	String	N	32	银行渠道号（PNRPAY和渠道商约定）
huifu_id	汇付Id	String	Y	18	汇付商户号
pay_scene	支付场景	String	N	2	1-线下扫码
contact_person_info	联系人信息	Object	Y		联系人信息
legal_person_info	法人身份信息	Object	N		法人身份信息
auth_identity_info	主体信息	Object	Y		主体信息
ubo_info	受益人信息	Object	N		受益人信息

contact_person_info

参数	中文名	类型	必填	最大长度	说明
name	联系人姓名	String	N	64	为空时 企业商户取联系人姓名，个人商户取入驻时填写的名称
mobile	联系人手机号	String	N	11	联系人手机号
id_card_number	联系人身份证号码	String	Y	32	联系人身份证号码

**legal_person_info **

参数	中文名	类型	必填	最大长度	说明
legal_type	证件持有人类型	String	N	32	为空时取开户时法人信息 法人：LEGAL经办人：SUPER主体类型为政府机关、事业单位时选传：（1）若上传的是法人证件，则不需要上传该字段。（2）若因 特殊情况，无法提供法人证件时，可上传经办人。主体类型为企业、个体户、社会组织、小微商户时，默认为经营者/法人，不需要上传该字段。 示例值：LEGAL
card_type	证件类型	String	N	32	为空时取开户时法人信息 枚举值：00:身份证 01:护照 13：港澳居民证 14:台湾居民证个体户/企业/事业单位/社会组织：可选择任一证件类型， 政府机关、小微商户仅支持身份证类型。示例值：00
person_name	法人姓名	String	N	64	为空时取开户时法人信息 示例值：李四
card_no	证件号码	String	N	64	为空时取开户时法人信息 示例值：233330199001010001
effect_time	证件生效时间	String	N	32	为空时取开户时法人信息 示例值：19990101
expire_time	证件过期时间	String	N	32	为空时取开户时法人信息 示例值：20001101，长期有效时传“长期”
card_front_img	证件正面照	String	N	128	为空时取开户时法人信息 上送图片上传返回的jfileId
effect_time	证件反面照	String	N	128	为空时取开户时法人信息上送图片上传返回的jfileId，只有身份证类型需要上传反面
auth_letter_img	授权函照片	String	N	128	上送图片上传返回的jfileId，当证件持有人类型为 经办人时，必须上传。其他情况，无需上传
is_benefit_person	是否为受益人	String	N	1	Y-受益人;N-非受益人 默认值：Y

auth_identity_info

参数	中文名	类型	必填	最大长度	说明
business_type	主体类型	String	Y	32	枚举定义：0 - 个人/小微1 - 政府机构2 - 国营企业3 - 私营企业4 - 外资企业5 - 个体工商户7 - 事业单位
finance_institution_flag	是否金融机构	String	N	1	Y-金融机构;N-非金融机构 默认值：N
financial_type	金融机构类型	String	N	32	当金融机构时，必填机构(INST)银行业(BANK_AGENT)支付机构(PAYMENT_AGENT)保险业(INSURANCE)交易及结算类金融机构(TRADE_AND_SETTLE) 其他(OTHER)示例值：INST
finance_license_pics	金融机构许可证图片	String	N	350	当主体是金融机构时，必填上送图片上传返回的jfileId，最多五张图片使用“,”分隔
certificate_type	证照类型	String	N	32	“主体类型为企业/个体户/政府机关/事业单位/社会组织时（1/2/3/4/5/7），必填；营业执照(BUSINESS_CERT)登记证书(REGISTER_CERT) 主体为政府机关/事业单位/社会组织时（1/7），填登记证书；主体类型为企业/个体户时（2/3/4/5），填营业执照；示例值：BUSINESS_CERT”
certificate_info	登记证书信息	String	N		主体类型为企业/个体户/政府机关/事业单位/社会组织时，必填jsonObject字符串 内容参考：certificate_info
company_prove_copy	单位证明函照片	String	N	128	上送图片上传返回的jfileId，主体类型为政府机关/事业单位时，单位证明函照片必填
support_credentials	辅助证明材料信息	String	N		主体类型为小微商户时，辅助证明材料信息必填jsonObject字符串 内容参考：support_credentials
qualification_info_list	经营许可证	String	N		1.填写特殊行业的经营许可证信息2、最多填写支持5个行业

certificate_info

参数	中文名	类型	必填	最大长度	说明
cert_type	登记证书类型	String	N	32	证照类型为登记证书时必填，枚举：统一社会信用代码证书(CERTIFICATE_TYPE_2389)慈善组织公开募捐资格证书(CERTIFICATE_TYPE_2397) 社会团体法人登记证书(CERTIFICATE_TYPE_2394)民办非企业单位登记证书(CERTIFICATE_TYPE_2395)基金会法人登记证书(CERTIFICATE_TYPE_2396) 农民专业合作社法人营业执照(CERTIFICATE_TYPE_2398)宗教活动场所登记证(CERTIFICATE_TYPE_2399)其他证书/批文/证明(CERTIFICATE_TYPE_2400) 其他(OTHER)示例值：INST 示例值：CERTIFICATE_TYPE_2389
cert_number	证照编号	String	N	64	示例值：1111111111111111
cert_copy	证照图片	String	N	128	上送图片上传返回的jfileId
cert_merchant_name	证照商户名称	String	N	64	示例值：新新饭店
cert_legal_person	证照法人姓名	String	N	64	示例值：李四
cert_company_address	证照注册地址	String	N	128	示例值：浙江省杭州市西湖区xxx街道xxx门牌号
effect_time	证照生效时间	String	N	32	示例值：19990101
expire_time	证照过期时间	String	N	32	示例值：20201101，若证件有效期为长期，请填写：长期

support_credentials

参数	中文名	类型	必填	最大长度	说明
micro_biz_type	小微经营类型	String	Y	32	小微经营类型 门店场所：MICRO_TYPE_STORE流动经营/便民服务：MICRO_TYPE_MOBILE示例值：MICRO_TYPE_STORE
store_name	门店名称	String	Y	64
province_code	门店省市编码	String	Y	32
province	门店省份	String	Y	32
city_code	门店市行政区号	String	Y	32
city	门店城市	String	Y	32
district_code	门店街道区号	String	Y	32
district	门店街道	String	Y	32
store_address	门店场所填写门店详细地址	String	Y	128
store_door_img	门店门头照信息或摊位照	String	N	128	为空时 取开户或开业务时上送的门头照片
store_inner_img	门店店内照片或者摊位照侧面	String	N	128	为空时 取开户或开业务时上送的店铺内景图片

qualification_info_list

参数	中文名	类型	必填	最大长度	说明
mcc_code	行业类目id	String	Y	20	支付宝商家行业二级类目code
image_list	行业经营许可证资质照片	String	Y	400	上送图片上传返回的jfileId，一个行业类目下最多上传6张资质照片,使用“,”分隔

ubo_info

参数	中文名	类型	必填	最大长度	说明
ubo_id_doc_name	证件姓名	String	Y	128	证件姓名
ubo_id_doc_type	证件类型	String	Y	10	枚举值：00:身份证 01:护照 13：港澳居民证 14:台湾居民证个体户/企业/事业单位/社会组织：可选择任一证件类型，政府机关、 小微商户仅支持身份证类型。示例值：00
ubo_id_doc_number	证件号码	String	Y	128	示例值：233330199001010001
ubo_period_begin	证件有效期开始时间	String	Y	20	示例值：20190606
ubo_period_end	证件有效期结束时间	String	Y	20	示例值：20260606 ，若证件有效期为长期，请填写：长期
ubo_id_doc_copy	证件正面照片	String	Y	64	上送图片上传返回的jfileId
ubo_id_doc_copy_back	证件反面照片	String	N	64	上送图片上传返回的jfileId，只有身份证类型需要上传反面

响应参数

• 同步响应参数(data)

参数	中文名	类型	必填	最大长度	说明
sub_resp_code	业务返回码	String	Y	8	业务返回码
sub_resp_desc	业务返回描述	String	Y	512	业务返回描述
applyment_id	申请单编号	String	N	256	示例值：202207011000185133
order_status	申请单状态	String	N	64	枚举值：审核中(AUDITING)待联系人确认(CONTACT_CONFIRM)待法人确认 (LEGAL_CONFIRM)审核通过(AUDIT_PASS)审核失败(AUDIT_REJECT) 已冻结(AUDIT_FREEZE)已撤回(CANCELED)

请求示例

{

“sys_id”: “ssproxy_dev”, “sign”: “111”, “sign_type”:”RSA2”, “product_id”: “ZDTEST”, “data”: “{“req_seq_id”: “666600000310061991194”,”req_date”: “20220914”,”huifu_id”: “6666000105418240”,”pay_channel_id”: “10000001”,”pay_scene”: “1”,”contact_person_info”: {“name”:”“,”mobile”:”“,”id_card_number”:”230822198612093713”},”legal_person_info”: {“legal_type”:”“,”card_type”:”00”,”person_name”:”姜真良”,”card_no”:”230822198612093713”,”effect_time”:”20200110”,”expire_time”:”长期”,”card_front_img”:”ab22005f-8643-37c2-9741-d27c13852482”,”card_back_img”:”25c2eee8-f400-3def-9d0c-3de433309544”,”is_benefit_person”:”Y”},”auth_identity_info”: {“business_type”:”3”,”finance_institution_flag”:”N”,”qualification_info_list”:[{“mcc_code”:”2015050700000000”,”image_list”:”a5d373f6-3e79-405f-9993-fb7ea051c372”}],”certificate_type”:”BUSINESS_CERT”,”certificate_info”:{“cert_number”:”91310230MA1JW7BF2U”,”cert_type”:”“,”expire_time”:”长期”,”cert_legal_person”:”姜真良”,”cert_company_address”:”上海市崇明区长江农场长江大街161号”,”cert_merchant_name”:”上海钱台信息技术有限公司”,”cert_copy”:”54b2e522-6640-3ee8-84d6-04d68fad16e3”,”effect_time”:”20200110”}},”ubo_info”: {“ubo_id_doc_name”:”消化”,”ubo_id_doc_type”:”00”,”ubo_id_doc_number”:”110101199909291419”,”ubo_period_begin”:”19990101”,”ubo_period_end”:”20260606”,”ubo_id_doc_copy”:”afce08c5-1548-30f8-bf70-1752c3012f66”,”ubo_id_doc_copy_back”:”51dd13bb-6268-36d0-ac84-c4cdc19eccba”}}”

}

响应示例

{

“data”: “{“sub_resp_code”:”00000003”,”sub_resp_desc”:”已实名成功”}”, “resp_code”: “10000”, “resp_desc”: “成功调用”, “sign”: “UnrQfnmwsTpe5fmpjkar/+aq4+6k4dp/dXBynuWQP16XxBaNnRj+FotQVUML0QUdQp31Dj6OY/6leQ0xNKdSvCQAEYSapbG44+hxMqRL1eQ7QqMI0yvZuT8exYDu8DhwvcBqjmN7c7tuJu6eHNwHVTi/6ef4gmJPqDYiNlV+tB4=”

}

接口调用示例

Demo参考