[关闭]
@1234567890 2020-03-18T08:26:29.000000Z 字数 1829 阅读 702

小灵狗风控saas接入文档

小灵狗


1 开发准备

在开始开发前,请确认已提前做好以下准备工作:

(1)与小灵狗商务对接,开通商户

(2)在小灵狗风控saas平台创建应用与策略

2 时序图

1565852951435.jpg-175.1kB

3 风控接口

3.1 请求地址

http://pigx-gateway:9999/rm2-api/risk/credit?appCode=qwerxxx&secretKey=asdfxxx

3.2 请求方式

请求方式 编码格式 输出格式 编码格式
POST application/x-www-form-urlencoded JSON UTF-8

3.2 请求参数

字段名称 中文含义 字段类型 备注
strategyCode 策略编号 String 必填
idNumber 身份证 String 必填
phoneNo 手机号码 String 必填
username 用户姓名 String 必填

3.3 返回结果

字段名称 中文含义 字段类型 备注
finalDecision 规则集调用结果 String WAIT_FOR_REVIEW待初审、REJECT拒绝、REVIEW人工复核、PASS通过
flowNo 风控流水号 String 在小灵狗方打唯一主键
resultCode 返回码 String 详情见下返回码表
strategy.strategyId 聚合风控策略id String 当前调用的规则集策略唯一主键
strategy.strategyName 聚合风控策略名称 String 当前调用的规则集策略名称
strategy.rules 策略集下规则对象 JsonArray 数组,见rule字段含义

Rule

字段名称 中文含义 字段类型 备注
ruleId 规则id String 策略集下规则id
ruleName 规则名称 String 策略集下规则名称
ruleCode 规则code String 详情见下规则code表
decision 规则调用结果 String PASS通过、REVIEW人工复核、REJECT拒绝
details 规则详细信息 JsonArray 数组,见details字段含义

detail

字段名称 中文含义 字段类型 备注
dataSource 数据源名称 String 聚合风控调用的三方数据源名称
value 调用描述 String 记录实际调用的结果

返回示例

调用成功

  1. {
  2. "finalDecision": "WAIT_FOR_REVIEW",
  3. "flowNo": "156317920995300482856",
  4. "resultCode": "0000",
  5. "strategy": {
  6. "strategyId": "7",
  7. "strategyName": "策略集测试1",
  8. "rules": [
  9. {
  10. "ruleId": "1",
  11. "ruleName": "用户年龄不在18至65周岁之间",
  12. "ruleCode": "0001",
  13. "decision": "REJECT",
  14. "details": [
  15. {
  16. "dataSource": "冰鉴",
  17. "value": "接口调用失败"
  18. }
  19. ]
  20. }
  21. ]
  22. }
  23. }

调用失败

  1. {
  2. "finalDecision": null,
  3. "flowNo": "156318303315896091021",
  4. "resultCode": "1001",
  5. "strategy": null
  6. }

4 回调接口

在小灵狗saas后台的策略上,配置回调接口。在人审结束后调用合作方接口

字段名称 中文含义 字段类型 备注
data 请求数据数据 String post请求,风控流水号(flowNO)和最终审核结果字段(finalAuditState)

返回示例

  1. {
  2. "flowNO":"156318303315896091021",
  3. "finalAuditState":"REJECT"
  4. }

5 码表

返回码表

错误代码 success 错误描述 备注说明
0000 true 调用成功
1001 false 密钥校验失败 合作方标识和合作方密钥认证失败
1002 false 非ip白名单失败 请求ip不符合调用请求
1003 false 策略无效 传入serviceCode有误
1004 false 策略下无规则 传入的serviceCode对应规则项为空

规则code表

规则code 规则描述
0001 用户年龄不在18至65周岁之间
0002 身份证地址属于新疆、西藏地区
0003 手机号未实名
0004 手机号三要素不一致
0005 手机号在网时长小于6个月
0006 运营商非在网状态
0007 身份证命中白骑士黑名单
0008 身份证命中同盾黑名单
0009 身份证命中公安不良人员名单
0010 身份证命中法院失信名单
0011 身份证命中法院执行名单
0012 同盾评分大于等于80分
0013 冰鉴慧眼分小于350分
添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注