文档说明

为了更好的帮助开发者或企业便捷顺利的完成行为行为验证 4.0 的产品体验和接入集成工作，请您在接入前阅读此文档，以便了解集成所需的工作内容和预计开发时间，集成过程中有任何疑问可联系我们获取支持。

产品交付说明

获取账号

如您需体验行为验证 4.0 产品，请事先注册极验产品账号，可点击此处提交账号申请，提交后我们预计最迟 1 个工作日内联系您，以安排进行后续的产品体验工作

获取体验产品

在您与我们取得联系并完成账号注册后，我们将根据您的实际需求来开通不同版本的体验产品，并交付产品使用说明如集成文档等。

集成测试

在完成上述的产品体验准备工作后，请安排对应的客户端与服务端研发人员参考所提供的集成文档完成各端侧的集成工作，客户端与服务端均需完成部署。测试体验期间我们也会为您提供技术支持。

交付与维护

与我们完成相关产品协议的签订后，我们将为您交付正式产品，在协议时间内和正式产品使用期间，我们也会为您提供及时的技术支持，以保障您的产品使用。

验证码流程时序图

集成接入

产品后台使用

1、通过注册邮箱登录极验产品后台后，选择【行为验】产品

2、进入【行为验】产品后台后，根据提示选择【创建业务模块】输入应用名称、应用地址、所属行业。

3、创建业务模块完成后，点击【新增业务场景】，输入场景名称、选择客户端类型、业务类型后生成部署所需的 captcha_id 和 captcha_key。

验证流程上不会校验不同场景和客户端是否共用一套 id 和 key，但为区分验证数据和配置不同的验证策略，建议不同的业务场景单独创建 id 和 key 部署

4、点击【部署检测】-【跳过指引】，即可进行后续场景的数据查看和验证形式配置等操作

客户端接入

1、获取 captcha_id
参考上述步骤登录极验产品后台-业务管理，获取到客户端部署所需的 captcha_id（验证 ID），或联系您的项目对接人获取。

2、客户端接入
Web 端接入：如需开发 web 或 H5 场景接入，可参考客户端 部署文档和 api 文档完成引入 JS 后完成集成工作；

Web 端 JS 支持 2 种引入方式：1.直接从极验域名线上引入加载； 2.将 JS 下载，上传到您服务器后从本地加载。从流程稳定性方面考虑，我们推荐您使用第 2 种加载方式

移动端接入：如需开发移动端场景，需先登录极验产品后台-业务管理-右上角“移动端 SDK 下载”，获取移动端 SDK 后，参考移动端 部署文档和 api 文档本地依赖 SDK 后完成集成工作。

基于安全风控考虑，移动端 SDK 接入仅支持本地依赖，不支持远程依赖

小程序接入：如需开发小程序场景，微信小程序请先申请插件后联系我们审核，其他小程序无需审核可自行申请获取后参考 部署文档和 api 文档集成接入

客户端预计开发周期：1 天
客户端接入常见问题，请参考此处

服务端接入

1、获取 captcha_id 和 captcha_key
参考上述步骤登录极验产品后台-业务管理，获取到服务端部署所需的 captcha_id（验证 ID）和 captcha_key（验证 key），或联系您的项目对接人获取。

2、获取客户端验证参数并签名
在客户端完成验证后，可通过回调函数获取验证码相关参数，并通过业务自定义接口如注册登录等传入服务端，服务端拿到客户端验证参数后，需要使用客户端验证参数 lot_number 和 captcha_key 参考示例进行签名生成 sign_token。

3、上传验证参数提交二次校验
将客户端和服务端最终验证参数提交二次校验接口，进行二次校验，并根据二次校验返回结果处理最终的业务请求

参数请求格式请使用 application/x-www-form-urlencoded 格式，否则将返回报错-50005

4、处理容灾降级逻辑
注意处理二次校验接口异常情况，当请求极验二次验证接口异常或响应状态非200时对请求进行放行处理，避免因为接口请求超时或服务未响应而阻碍业务流程。
5、处理业务逻辑
根据极验二次校验接口返回的结果状态，进行后续的业务逻辑处理：仅当二次校验接口返回 result 为 success 时，才允许通过业务流程。

服务端预计开发周期：1 天

服务端接入常见问题，请参考此处