通用场景
支付宝开放认证初始化服务，用于创建开放认证流程。注意：港澳台同胞身份验证服务仅支持在支付宝客户端内使用，外部 app 使用该项服务需唤起支付宝客户端。
公共请求参数
业务请求参数
outer_order_no必选string(32)
【描述】商户请求的唯一标识，商户要保证其唯一性，值为32位长度的字母数字组合。建议：前面几位字符是商户自定义的简称，中间可以使用一段时间，后段可以使用一个随机或递增序列
【示例值】zgyd201809132323000001234
biz_code必选string(32)
【描述】认证场景码。入参支持的认证场景码和商户签约的认证场景相关，取值如下:
face：多因子人脸认证
cert_photo：多因子证照认证
cert_photo_face ：多因子证照和人脸认证
smart_face：多因子快捷认证
【示例值】face
identity_param｜身份信息必选opencertifyidentityparam
【描述】需要验证的身份信息
identity_type｜身份类型必选string(30)
【描述】identity_type
1.若本人验证，使用cert_info；
2.若代他人验证，使用agent_cert_info；
【枚举值】
证件信息: cert_info
代理人证件信息: agent_cert_info
【示例值】cert_info
cert_type｜证件类型可选string(64)
【描述】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；
6、外国人永久居留证，填permanent_residence_foreigner；
【枚举值】
身份证: identity_card
港澳居民来往内地通行证: home_visit_permit_hk_mc
台湾居民来往内地通行证: home_visit_permit_taiwan
【注意事项】在identity_type为cert_info或者agent_cert_info时，该字段必填
【示例值】identity_card
cert_name｜姓名可选string(50)
【描述】cert_name：
填入真实姓名
【注意事项】在identity_type为cert_info或者agent_cert_info时，该字段必填
【示例值】张三
cert_no｜证件号码可选string(30)
【描述】cert_no：
填入姓名相匹配的证件号码
【注意事项】在identity_type为cert_info或者agent_cert_info时，该字段必填
【示例值】260104197909275964
merchant_config｜商户个性化配置必选opencertifymerchantconfig
【描述】商户个性化配置
return_url｜跳转目标地址必选string(4096)
【描述】认证成功后需要跳转的地址，一般为商户业务页面；若无跳转地址可填空字符"";
【示例值】https://xxx
face_reserve_strategy｜人脸保存策略可选string(32)
【描述】不传默认为reserve
【枚举值】
保存活体人脸: reserve
不保存活体人脸: never
【示例值】reserve
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.user.certify.open.initialize&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'biz_content={
"biz_code":"face",
"identity_param":{
"cert_type":"identity_card",
"cert_name":"张三",
"cert_no":"260104197909275964",
"identity_type":"cert_info"
},
"outer_order_no":"zgyd201809132323000001234",
"merchant_config":{
"face_reserve_strategy":"reserve",
"return_url":"https://xxx"
}
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
certify_id必选string(32)
【描述】本次申请操作的唯一标识，商户需要记录，后续的操作都需要用到
【示例值】2109b5e671aa3ff2eb4851816c65828f
响应示例
正常示例
异常示例
{
"alipay_user_certify_open_initialize_response": {
"code": "10000",
"msg": "success",
"certify_id": "2109b5e671aa3ff2eb4851816c65828f"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| arrangement_status_error | 合约状态异常 | 请确认商户合约是否有效 |
| illegal_argument_format | 参数异常 | 检查参数是否按照规定传入，检查参数是否合法 |
| unknown_error | 未知异常 | 检查报文格式,json化是否合理 |