Fraud Detection SDK 使用文档

前言

每一笔交易都需要经过风控，接入 Fraud Detection（欺诈管理）可以预防和减少欺诈率，让您的交易成功率大大提升。

引入

与收银台组件一起使用

若您使用了我们的收银台组件，则不需要手动导入，组件本身已经集成了 SDK，您可直接跳到下一步：使用。

收银台组件引入方式参考：PayKKa Checkout UI Component 使用文档

单独引入

若您是接入的 API 支付，可以通过 CDN 的形式单独引入 Fraud Detection SDK。

下面是香港和欧洲商户引入 SDK 的方式：

香港

欧洲

使用

初始化 Fraud Detection 时，需要先设置环境。

环境设置

不同环境（香港/欧洲）下接入 Fraud Detection 的配置是不同的，因此您需要配置对应环境。

目前支持的环境如下：

环境	描述
eu	默认值，欧洲商户可用
hk	香港商户可用
us	美国商户可用，目前暂未开通

npm

若您使用了我们的收银台组件，您可以直接在 npm 包中设置环境。

如果您是欧洲商户，则无需任何操作。

如果您是其他地区的商户，您需且仅需一开始就设置好 Fraud Detection 的环境即可。

调用 setFraudDetectionEnv 去设置环境，具体支持环境已在上面列出：

CDN

若您是接入的 API 支付，在成功引入并加载 SDK 链接后，会暴露出变量 PayKKaFraudDetection。

与 npm 同理，一开始您需要设置好环境，具体支持环境已在上面列出：

PayKKaFraudDetection 是单例，因此多次调用返回的是同一个实例，您无需担心会产生重复请求。

createFraudDetection

您需要调用 paykkaFraudDetection.createFraudDetection() 创建 Fraud Detection，此时内部会开始进行初始化并请求 fraudDetectionID，该方法会缓存请求到的结果，因此多次调用不会更新。

fraudDetectionID

您可以通过调用 paykkaFraudDetection.fraudDetectionID 获取到 fraudDetectionID。

请求 fraudDetectionID 需要一些时间，不过您不需要等到请求完成也可以发起支付，无论拿到的 fraudDetectionID 是否为空，直接传递即可。

示例

下面是示例代码（假设我们已完成了引入）：

npm

CDN

sandbox

如果你想在 sandbox 环境下使用 Fraud Detection SDK，下面是例子：

前言#

引入#

与收银台组件一起使用#

单独引入#

使用#

环境设置#

npm#

CDN#

createFraudDetection#

fraudDetectionID#

示例#

sandbox#

API 模式#

前言

引入