常见问题 - 金融级实人认证

购买咨询问题

产品是如何收费的？
按照后付费和预付费方式进行收费，预付费含阶梯报价，参见定价和计费说明，您也可以联系您的专属商务经理进行咨询。
金融级实人认证与实人认证价格有什么差异？
价格是一致的，没有差异。
后付类的订购入口在哪里？
https://common-buy.aliyun.com/?commodityCode=cloudauth_ant_post#/open
预付流量包的订购入口在哪里？
https://common-buy.aliyun.com/?commodityCode=cloudauth_fin_bag#/buy
金融级实人认证产品页面在哪里？
https://www.aliyun.com/daily-act/antcloudauth
金融级实人认证是否有免费体验？
有的，我们为您提供100条免费测试。https://common-buy.aliyun.com/?commodityCode=cloudauth_fin_bag#/buy
金融级实人认证当前支持哪些接入方式？
解决方法：

APP、H5、支付宝、微信等第三方渠道均支持。

资费问题

我购买了流量包，如何确保在流量消耗完收到提醒？
您可以设置剩余流量提醒，请参见设置流量包剩余流量提醒。
如何进行对账？
您可将费用中心的消费金额与您控制台中展示的调用量进行核对，请参见调用对账。

技术支持问题

初始化，我输入的是假的身份信息，为什么显示OK？
解决方法：

API 现在是不会有身份校验，核验等操作，所有的人脸比对、身份核验都在刷脸端透出，这是出于安全性，产品整体性考虑的。
身份证是对的，也没有返回文档里说的certifyId？
解决方法：

返回结果在response的data里面，需要取出来。
服务端的签名机制是怎样的？
请参见 API签名机制。
outerOrderNo参数代表什么？
对应你们自己业务的唯一请求ID，方便定位问题，标识请求，服务端感知不到，客户端SDK返回能看到。
认证失败返回什么参数？
不存在认证失败的情况，就算是没有人脸图片，更新之后，可以继续重试刷脸。

假设没有底片，会返回F给您，然后等用户去公安更新图片之后，可以继续尝试。
活体抓下来的照片如果需要留存到本地，这个调用的API接口文档在哪里？
查询接口，文档里有返回参数有。
除了认证结果查询能留存图片，有没有异步拉取图片的方式？
没有，这个属于隐私信息，需要加强管控。
认证查询接口中，图片返回是什么格式？
Base64的图片。
微信公众号程序，在微信里打开H5，可以调起手机的支付宝做活体检测么？
从微信访问H5不行，但从业务方的服务端调用是没有阻碍的。
后台访问你们的活体验证服务，传给你们的是视频还是图片（静默活体）？如果是图片，是一张还是多张？
图片，如果纯服务端接入只需传一张，会有算法进行处理。
页面是否可定制？
金融版贵公司的Logo（App图标即可）和公司名称可修改，其他页面无法修改；企业版只展示刷脸框和认证结果。
拉取照片是否有时间限制？
出于安全、敏感角度考虑，现在时效性是23个小时。
提供的jar包方法能配置代理参数吗？
可以，请参见 https://github.com/aliyun/aliyun-openapi-java-sdk/blob/master/docs/6-Proxy-CN.md
如何统计通过率？
解决方法：

暂时无法提供。因当前的产品体验做的比较极致，C端用户因光线不足、非本人核验等认证失败后，会在前台直接提示重试，后台暂不会留存错误信息。

所以认证状态结果只有2种：“成功”（认证结果为T）和“未完成”（认证结果为F）。

通用SDK使用问题

安卓端和苹果端的刷脸界面，一个要求眨眼，一个要求不动，是什么原因呢？
这个是风控根据环境来判断风险等级，需要进行何种活体动作。

Android SDK使用问题

点击采集人脸后卡住，应该如何处理？
解决方法：

确认应用支持的CPU架构是否与SDK 符合。解决办法： gradle中设置过滤：ndk { abiFilters "armeabi" }
采集完成返回卡住，应该如何处理？
解决方法：

确认应用支持的CPU架构是否与SDK符合。解决办法： gradle中设置过滤：ndk { abiFilters "armeabi" }
报错异常bind logging异常，应该如何处理？
解决方法：

不影响业务逻辑，请提供完整日志。
出现“人品大爆发”，应该如何处理？
解决方法：

重新配置无线保镖图片。
点击采集人脸直接弹出“请对本人拍摄”，应该如何处理？
解决方法：
1. 确认aar包都已经正常接入；
2. 升级的情况注意老版本包已经移除；
3. 确认没有重复的SDK（otto，deviceid，logsdk...）。
App和文档Demo运行到“采集人脸”按钮点击后崩溃，应该如何处理？
解决方法：

确认应用支持的CPU架构是否与SDK符合。解决办法：gradle中设置过滤：ndk{ abiFilters "armeabi" }
该设备不支持刷脸，应该如何处理？
解决方法：

日志里的报错并不是对应的原因。（该错误其实不影响）。

确认应用支持的CPU架构是否与SDK 符合，1.0.2版本只能支持armeabi架构。解决办法：gradle中设置过滤：ndk { abiFilters "armeabi" }
本地 IDE 和手机测试无误，打包分发内测时，华为 nova4、mate20pro 在点击同意协议后闪退，应该如何处理？
解决方法：

内测时需要打开混淆。
本地 IDE 和手机测试无误，打包分发内测时，所有机型在点击采集人脸后闪退，应该如何处理？
解决方法：

确保 CPU 只保留 armeabi。混淆策略与文档一致，并添加下述策略：
```
 -keep class com.alIPay.**{*;}
```
对于刘海屏，认证页面会被手机状态栏遮挡，如何配置？
解决方法：

实人认证是个 Dialog 弹窗，页面配置是业务方做的，客户应该做了沉浸式体验。单独提供 SDK aar 包，最终需要升级 SDK 版本。
客户端认证初始化失败，客户端调用客户端init接口后报错：缺少操作类型或者此操作类型不支持。应该如何处理？
解决方法：

技术支持同学建议将 mPaaS 版本 SDK 改为标准版 SDK，客户在尝试中，暂未完成验证。
需要支持 armeabi-v7a 或 arm64-v8a
解决方法：

请使用新版 SDK：https://gw.alIPayobjects.com/os/basement_prod/247d4495-7d99-4bfb-b927-3d14725ee42c.zIP

iOS SDK 使用问题

调用 startVerifyService，iOS 端 SDK 获得如下结果：resultStatus=4000，应该如何处理？
解决方法：

4000: 系统异常，请提供 certifyId 进行进一步排查。
跳转认证页面，同意协议并确认开始认证后，第一次认证初始化失败，弹出“人气大爆发”，应该如何处理？
解决方法：

客户端连不上网。请确认客户端可以连上网，然后再试。
打包后第一次启动“直接测试刷脸”，从服务端获取 URL 正常，但无法唤起认证协议页。第二次启动，正常唤起。这是什么原因？
解决方法：

先把 apverifyservice 初始化。
SDK 支持的范围？
SDK 是支持 armv7、i386、x86_64、arm64，操作系统是 iOS 8 以上。但一般要求 iOS 9 及以上，机型是 5s 及以上。

服务端 SDK 使用问题

PHP 处理 ceritifyUrl 出现 HTML 转义，应该如何处理？
解决方法：

采用 HTML 逆转义。
在测试环境中，认证初始化请求报错： https://saf.cn-shanghai.aliyuncs.com:443, ServerUnreachable
解决方法：

这个域名是稳定的。如果出现 ServerUnreachable，是不是测试的网络有限制？或者 DNS 有问题？是否能 ping 通？补充：与下一问的错误根源是相同的。不同环境的报错方式有差异。
本地环境，认证初始化部分请求报错：
```
 java.lang.IllegalStateException: Server response has a bad format type: RAW at com.aliyuncs.reader.ReaderFactory.createInstance(ReaderFactory.java:16) at com.aliyuncs.DefaultAcsClient.readError(DefaultAcsClient.java:372) at com.aliyuncs.DefaultAcsClient.getCommonResponse(DefaultAcsClient.java:164) at com.guohualife.ebiz.cIP.gateway.util.AliCloudJRUtil.aliCloudFaceCheck(AliCloudJRUtil.java:53)
```
解决方法：

文档中 JAVA SDK 示例的 request.setQueryParameter 需要改为 request.setBodyParameter（文档已经更新，20200206）。原先写法是将参数在 URL 中拼接传输，在离线比对场景会造成 URL 过大（核验图片在 140KB 上下，但阿里云 Pop 要求不大于 128KB）。改为在 body 中传输就能避免这个问题（ body 的要求是不大于 1MB）。
调用接口时提示 “com.alibaba.fastjson.JSONException: syntax error, pos 1, line 1, column 2”，应该如何处理？
解决方法：

这是 DNS 解析出现异常了，找不到 URL 对应的 IP。所以要检查一下，网络里用了什么代理服务器，或者 DNS 服务有中断之类的。

调用接口时提示如下错误，应该如何处理？

{"rspData":{"orderNo":"GB2020021851104011160049746308","requestId":"883B3A40-B820-4013-8473-31C254CBD50F","retCode":"SignatureDoesNotMatch","retMsg":"Specified signature is not matched with our calculation. server string to sign is:POST&%2F&AccessKeyId%3DLTAI4Fu4N5JUWyUS7VEWJHeZ%26Action%3DExecuteRequest%26Format%3Djson%26Service%3Dfin_face_verify

解决方法：

签名错误，检查AccessKey ID和AccessKey Secret是否正确，是否有空格，是否代码固化。

离线比对报出“非法参数”，应该如何处理？
解决方法：

Pop 超时时长过短，引发重试导致。已延长超时时长。

如何提交工单

操作步骤：

账户登录成功后，点击页面右上方的“控制台”按钮。
在控制台顶部，点击工单 -> 提交工单 -> 搜索产品“实人认证” 。
选择您遇到的金融级实人认证相关问题分类并进行提交。

OSS 空间相关问题

金融级实人认证必须开通 OSS 空间吗？
答：如果您想实现返照功能，您必须开通 OSS 空间。我们会将采集到的人脸照片返回到您的 OSS 中。关于 OSS 空间的具体介绍，请参见什么是对象存储 OSS 。关于如何开通 OSS 服务，请参见开通 OSS 服务。
账号已经在别的项目中开通了 OSS 空间，怎么配置呢？就只有 yaml 文件里配置就够了吗？
答：使用咱们企业版产品，参考页面引导操作授权开通即可，系统会自动创建一个 Bucket ，用于存储认证中的用户人脸图片。对其他项目已经在使用的 OSS 没有任何影响。
OSS 空间如何进行计费？
答：OSS 的计费方式分为按量计费和包年包月两种。关于计费详情，请参见 OSS 计量计费。
如何删除通过 OSS 空间存储的照片？
答：您可以设置定期自动删除 OSS 空间图片，具体操作请参见设置 OSS 空间生命周期规则。
关于 OSS 空间的其他常见问题和解决方法，请参见 OSS 常见问题。