Skip to content

非洲第三方供应商接入整合文档

文档生成时间:2026-04-17 目标:为传众平台整合非洲地区第三方服务提供商,提供清晰的接入指南


目录

  1. 供应商概览
  2. Identity Africa - KYC身份核验
  3. JuicyScore - 风控与反欺诈
  4. 接入优先级建议

供应商概览

供应商主要能力定位覆盖市场文档完整性商务状态
Identity AfricaKYC身份核验(NIDA、KRA PIN、手机号验证)肯尼亚、坦桑尼亚等非洲市场✅ API文档完整❓ 待商务确认
JuicyScore风控(反欺诈、反洗钱、设备风控、行为风险)全球(45+国家)✅ 有定价和案例❓ 待商务确认

Identity Africa - KYC身份核验

供应商定位

核心能力: 身份验证(KYC)和数据核验服务

主要功能:

  • 国家ID核验(National ID Verification)
  • KRA PIN核验(肯尼亚税务PIN)
  • 手机号验证(PhoneNumber Validation)
  • 政府数据源直连

覆盖市场:

  • 肯尼亚(Kenya)
  • 坦桑尼亚(Tanzania)
  • 其他非洲市场(12个市场)

业务特点:

  • 通过API提供政府数据直连
  • 支持DataFlow工作流平台(拖拽式工作流编排)
  • 实时验证,秒级响应
  • 端到端身份合规基础设施

官方文档

API文档

  • API版本: OpenAPI 3.1.0
  • Base URL: https://partner.identifyafrica.io/api/v1
  • 认证方式: HTTP Basic Auth
    • API Client ID = username
    • API Secret Key = password

DataFlow平台

  • 定位: 工作流编排平台
  • 功能: 将多个API整合到一处,通过拖拽方式创建和部署工作流
  • 优势:
    • 减少技术集成时间和复杂性
    • 实时验证
    • 客户自助配置工作流

API接入详情

1. 国家ID核验(National ID Verification)

端点: POST /id

请求参数:

json
{
  "idnumber": "string"  // 国家ID号码(必填)
}

响应示例:

json
{
  "success": true,
  "response_code": 200,
  "message": "ID Details Fetched Successfully",
  "data": {
    "first_name": "JANE",
    "last_name": "DOE",
    "other_name": "SMITH",
    "name": "DOE JANE SMITH",
    "gender": "Female",
    "dob": "1990-01-20",
    "citizenship": "Kenyan",
    "id_number": "12345678",
    "serial_no": "987654321",
    "valid": true
  },
  "request_id": "00000000-0000-0000-0000-000000000000"
}

返回字段说明:

  • first_name - 名
  • last_name - 姓
  • other_name - 中间名
  • name - 全名
  • gender - 性别
  • dob - 出生日期
  • citizenship - 国籍
  • id_number - ID号码
  • serial_no - 序列号
  • valid - 是否有效

2. KRA PIN核验(肯尼亚税务PIN)

端点: POST /krapin

请求参数:

json
{
  "pinnumber": "string"  // KRA PIN号码(必填)
}

响应示例:

json
{
  "success": true,
  "response_code": 200,
  "message": "KRA Pin Details Fetched Successfully",
  "data": {
    "Business_Certificate_Id": "string",
    "Email_Addresses": "string",
    "Locality": "string",
    "PINNo": "string",
    "Partnership": "string",
    "Paye": "string",
    "Station": "string",
    "TaxpayerName": "string",
    "Tot": "string",
    "Trading_Business_Name": "string",
    "Vat": "string"
  },
  "request_id": "uuid"
}

3. 手机号验证(PhoneNumber Validation)

端点: POST /phone

特点:

  • 异步处理
  • 首次返回202(已接受)状态
  • 支持回调或轮询获取结果

请求参数:

json
{
  // AccountValidationRequest 结构
  "phone": "string",  // 手机号
  "account": "string",  // 账户号(如适用)
  "reference": "string"  // 引用ID
}

响应状态:

202 Accepted(处理中):

json
{
  "success": true,
  "response_code": 202,
  "message": "string",
  "data": {
    "request_id": "uuid",
    "status": "pending",
    "poll_url": "https://partner.identifyafrica.io/api/v1/phone/status/{request_id}"
  }
}

200 Success(验证成功):

json
{
  "success": true,
  "response_code": 200,
  "message": "Account Details Fetched Successfully",
  "data": {
    "name": "string",
    "account": "string",
    "reference": "string",
    "phone": "string",
    "institution": "Unknown|Telkom|Airtel Money|Safaricom"
  }
}

支持的机构:

  • Unknown
  • Telkom
  • Airtel Money
  • Safaricom

轮询端点: GET /phone/status/{requestId}


错误码

Code说明
200成功
202已接受,处理中
403授权异常
422验证异常
424验证失败/处理失败
404请求未找到

接入费用

当前状态: ⚠️ 待确认

有信息:

  • 存在定价文档(Identify Africa KYC Pricing inKes.pdf)
  • 存在美元定价文档(Identify Africa KYC Pricing inUSD.pdf)
  • 有DataFlow定价文档

需要确认:

  • 具体费率(按次收费/按月套餐)
  • 是否有免费测试额度
  • 月度最低消费要求

供应商资质

当前状态: ⚠️ 部分确认

已确认信息:

  • ✅ 官方API文档完整
  • ✅ 支持多个非洲国家
  • ✅ 有合规认证(PEP、Sanctions、Adverse Media)
  • ✅ AML/反洗钱能力

待确认:

  • 数据安全认证(ISO 27001等)
  • 金融监管牌照
  • 数据处理合规性

对接流程

✅ 已确认信息

  1. 官网/平台: https://partner.identifyafrica.io
  2. API文档: OpenAPI 3.1.0规范,完整可用
  3. 认证方式: HTTP Basic Auth
  4. 响应时间: 实时,秒级
  5. 工作流平台: DataFlow支持(拖拽式工作流编排)

❓ 需商务确认

  1. 账号申请: Partner Portal注册流程
  2. API密钥获取: API Client ID和Secret Key申请流程
  3. 定价条款: 具体费率和计费方式
  4. SLA保障: 服务可用性和响应时间保障
  5. 测试环境: 是否提供Sandbox环境
  6. 技术支持: 集成期间的技术支持联系方式

JuicyScore - 风控与反欺诈

供应商定位

核心能力: 设备指纹识别、反欺诈、反洗钱(AML)、行为风险分析

主要功能:

  • 设备指纹识别(Device Fingerprinting)
  • 账户安全保护
  • 欺诈检测(申请时、申请后)
  • 账户接管预防
  • 多账户欺诈检测
  • Bonus滥用检测

技术特点:

  • 分析230+行为特征
  • 65,000+设备参数
  • 实时分析,毫秒级响应
  • SDK集成,易于部署
  • A/B测试支持

官方文档

产品文档

  • JuicyScore Overview 2025/2026: 有完整产品介绍
  • API Response Packages: 有API响应包说明
  • Pricing: Tier 1定价(已更新至2026)

网站信息


API接入详情

核心参数分析

行为特征(230+):

  • 鼠标移动轨迹
  • 键盘输入模式
  • 页面滚动行为
  • 点击模式分析
  • 时间分布
  • 会话时长
  • 设备切换频率

设备参数(65,000+):

  • 设备型号和品牌
  • 操作系统版本
  • 浏览器指纹
  • 屏幕分辨率
  • 时区设置
  • 语言设置
  • 插件列表
  • WebGL指纹
  • Canvas指纹
  • 音频上下文指纹

API集成方式

  • REST API
  • SDK支持: Android、iOS
  • 回调机制: 支持实时结果推送

接入费用

当前状态: ⚠️ 部分确认

有信息:

  • ✅ 有Tier 1定价文档
  • ✅ 有API响应包说明
  • ✅ 支持多种套餐模式

需要确认:

  • 具体定价(调用次数/月度套餐)
  • 是否有免费额度
  • 企业级定价选项
  • 数据存储费用

供应商资质

当前状态:较完整

已确认信息:

  • ✅ 多项行业奖项(Banking Tech Awards、Best Use of AI、IFTA等)
  • ✅ 多家客户案例(CashX、MoneyMan、UnaFinancial)
  • ✅ 覆盖全球45+国家
  • ✅ 合规性确认(AML、反欺诈)
  • ✅ 数据处理政策透明

待确认:

  • 具体认证资质(SOC2、ISO等)
  • 数据中心合规性
  • 非洲本地合规要求

对接流程

✅ 已确认信息

  1. 官网: https://juicyscore.com
  2. 产品线: JuicyScore、JuicyAI、JuicyAnalytics、JuicyID、JuicyLightning
  3. 联系方式: info@juicyscore.com
  4. 技术文档: 有API响应包文档
  5. 案例研究: 有多家客户案例可参考

❓ 需商务确认

  1. 账号注册: 注册流程和所需资料
  2. API密钥: 获取方式和使用限制
  3. 定价条款: Tier 1之外的其他套餐选项
  4. SLA保障: 服务可用性承诺
  5. 技术支持: 集成支持联系方式
  6. 测试环境: Sandbox访问权限
  7. 数据保留政策: 设备指纹数据保留时长

接入优先级建议

第一阶段(立即接入)

建议优先级: 🔴

供应商理由预计时间
Identity AfricaKYC是合规必需,API文档完整2-3周
JuicyScore风控是金融业务核心,文档和案例完整2-4周

理由:

  • Identity Africa提供政府数据直连,合规性要求高
  • JuicyScore提供完整的反欺诈解决方案,案例丰富
  • 两家供应商都有较完整的技术文档

第二阶段(评估后接入)

建议优先级: 🟡

供应商理由预计时间
Identity Africa评估第一阶段效果后继续待评估
JuicyScore评估第一阶段效果后继续待评估

理由:

  • 根据第一阶段集成效果评估后续扩展
  • 可能需要根据业务需求增加其他风控能力

商务对接清单

对所有供应商需确认的关键信息

第一轮商务沟通(通过邮件/电话):

  1. 基本信息确认

    • [ ] 供应商完整公司名称
    • [ ] 官方网站URL
    • [ ] 官方联系方式(邮箱/电话)
  2. 技术能力确认

    • [ ] 提供的具体服务列表
    • [ ] 覆盖的国家/地区
    • [ ] API文档获取方式
    • [ ] SDK下载地址(如适用)
    • [ ] 测试环境访问方式
  3. 商务条款确认

    • [ ] 定价模式(按次/按月/按年)
    • [ ] 具体费率
    • [ ] 最低消费要求
    • [ ] 是否有免费测试额度
    • [ ] SLA保障条款
  4. 资质合规确认

    • [ ] 数据安全认证(ISO/SOC2)
    • [ ] 金融监管牌照
    • [ ] GDPR/非洲本地数据保护合规
    • [ ] 数据处理所在地(在非洲/欧盟)
  5. 技术支持确认

    • [ ] 集成支持联系方式
    • [ ] 技术支持工作时间
    • [ ] 紧急联系方式

技术对接建议

统一集成架构

传众平台架构:
┌────────────────────────────────────┐
│           传众核心平台              │
│  ┌──────────────────────────────┐  │
│  │     第三方服务抽象层         │  │
│  │  ┌────┬─────┬────┐    │  │
│  │  │KYC  │风控 │    │  │
│  │  └──┬──┴──┬──┴──┘    │  │
│  │  │      │      │         │  │
│  │  ┌───▼───▼───▼──┐   │  │
│  │  │Identity│Juicy │    │  │
│  │  │ Africa │Score │    │  │
│  └───┴───────┴───────┴─────┘   │  │
└────────────────────────────────────┘

接口设计建议

  1. 统一认证机制

    • 使用统一的API密钥管理
    • 支持多环境(Dev/Test/Prod)
    • 密钥轮换机制
  2. 统一响应格式

    • 标准化错误码
    • 统一响应结构(success/response_code/message/data)
    • 标准化分页(如需)
  3. 监控与日志

    • API调用日志记录
    • 响应时间监控
    • 错误率告警
    • 费用统计
  4. 容错与重试

    • 超时重试机制
    • 降级策略(多个供应商时)
    • 缓存策略

下一步行动

立即执行(本周)

Identity Africa 对接

  • [ ] 联系商务获取Partner Portal访问
  • [ ] 申请测试账号
  • [ ] 确认定价条款
  • [ ] 获取完整API文档

JuicyScore 对接

  • [ ] 联系info@juicyscore.com
  • [ ] 申请测试账号
  • [ ] 确认Tier 1之外的定价
  • [ ] 下载SDK文档

短期目标(2周内)

完成第一阶段

  • [ ] Identity Africa KYC集成
  • [ ] JuicyScore风控集成

建立评估标准

  • [ ] 制定统一评估模板
  • [ ] 确定测试用例
  • [ ] 建立验收标准

启动第二阶段

  • [ ] 根据第一阶段效果规划下一步

附录

术语表

术语说明
KYCKnow Your Customer - 了解你的客户,身份验证流程
AMLAnti-Money Laundering - 反洗钱
PEPPolitically Exposed Persons - 政治公众人物
OCROptical Character Recognition - 光学字符识别
NIDANational Identification Authority - 国家识别署
KRAKenya Revenue Authority - 肯尼亚税务局
TINTax Identification Number - 税务识别号
Device Fingerprinting设备指纹识别 - 通过设备特征识别用户设备

参考资料

  • Identity Africa API文档(已读取)
  • JuicyScore Overview(已读取)
  • 项目计划中的供应商列表
  • 各种定价文档(本地文件,待整理)

文档维护:

  • 随商务对接进展持续更新
  • 技术对接完成后补充详细API对接指南
  • 定价确认后更新费用结构

文档最后更新于 2026-04-17