身份认证初始化服务

支付宝开放认证初始化服务，用于创建开放认证流程。注意：港澳台同胞身份验证服务仅支持在支付宝客户端内使用，外部 APP 使用该项服务需唤起支付宝客户端。

请求参数

Body 参数application/json

identity_param

object (OpenCertifyIdentityParam)

可选

cert_digest

string

可选

cert_digest：身份信息摘要

示例值:

21232f297a57a5a743894a0e4a801fc3

cert_name

string

可选

cert_name：填入真实姓名

示例值:

张三

cert_no

string

可选

cert_no：填入姓名相匹配的证件号码

示例值:

260104197909275964

cert_type

string

可选

cert_type： 1、若为身份证，填IDENTITY_CARD； 2、若为港澳居民来往内地通行证，填HOME_VISIT_PERMIT_HK_MC； 3、若为台湾居民来往内地通行证，填HOME_VISIT_PERMIT_TAIWAN； 4、若为港澳居民居住证，填RESIDENCE_PERMIT_HK_MC； 5、若为台湾居民居住证，填RESIDENCE_PERMIT_TAIWAN；

示例值:

IDENTITY_CARD

facial_picture_front

string

可选

facial_picture_front：活体人脸图片base64串，主要用于离线人脸比对

示例值:

xydasf==

identity_type

string

可选

identity_type 1.若本人验证，使用CERT_INFO； 2.若代他人验证，使用AGENT_CERT_INFO；

示例值:

CERT_INFO

open_id

string

可选

open_id：开放平台用户ID

示例值:

074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5

phone_no

string

可选

phone_no：填写姓名相匹配的手机号

示例值:

13000000000

user_id

string

可选

user_id：支付宝用户ID

示例值:

2088xxxx

merchant_config

object (OpenCertifyMerchantConfig)

可选

auth_scope

string

用于开放认证授权

可选

示例值:

xxx

auth_type

string

可选

用于指定授权类型，与auth_scope配合使用

示例值:

xxx

face_reserve_strategy

string

可选

不传默认为reserve

示例值:

reserve

facial_picture_level

string

可选

若有特殊人脸等级采集要求，可指定等级

示例值:

FIN0

linked_merchant_app_id

string

可选

用于授权二级商户操作

示例值:

202134xxxx

linked_merchant_logo_url

string

可选

用于指定展示的商户logo

示例值:

http://xxx

linked_merchant_name

string

可选

用于指定展示的商户名称

示例值:

杭州xx公司

out_put_facial_picture

boolean

可选

在拥有该权限前提下，用于商户控制是否透出活体人脸

示例值:

true

return_url

string

可选

认证成功后需要跳转的地址，一般为商户业务页面；若无跳转地址可填空字符"";

示例值:

https://xxx

biz_code

string

可选

认证场景码。入参支持的认证场景码和商户签约的认证场景相关，取值如下: FACE：多因子人脸认证 CERT_PHOTO：多因子证照认证 CERT_PHOTO_FACE ：多因子证照和人脸认证 SMART_FACE：多因子快捷认证

示例值:

FACE

face_contrast_picture

string

可选

自定义人脸比对图片的base64编码格式的string字符串

示例值:

xydasf==

outer_order_no

string

可选

商户请求的唯一标识，商户要保证其唯一性，值为32位长度的字母数字组合。建议：前面几位字符是商户自定义的简称，中间可以使用一段时间，后段可以使用一个随机或递增序列

示例值:

ZGYD201809132323000001234

示例

application/json

Body

certify_id

string

可选

本次申请操作的唯一标识，商户需要记录，后续的操作都需要用到

示例值:

2109b5e671aa3ff2eb4851816c65828f

身份认证初始化服务

请求参数

返回响应