1. 课程导论：商户风险评分API的背景、目标与适用场景
1.1 背景：为什么需要商户风险评分API？
在数字化支付与开放银行体系快速发展的今天，商户接入金融服务的门槛大幅降低，但随之而来的欺诈、洗钱、套现、虚假交易等风险也呈指数级增长。传统的人工审核与静态规则引擎已无法应对以下挑战：
- 交易量爆炸：头部支付平台日均处理数亿笔交易，人工抽样审核覆盖率不足0.1%。
- 攻击手段进化：黑产利用AI伪造商户资料、模拟真实交易行为，静态规则极易被绕过。
- 监管合规压力：PCI-DSS、反洗钱（AML）、KYC等法规要求金融机构对商户进行持续风险监控。
- 实时性要求：风险决策必须在毫秒级完成，否则影响用户体验与交易成功率。
核心痛点：缺乏一套标准化、可扩展、低延迟的商户风险量化接口，导致风控系统重复建设、评分标准不统一、跨机构协作困难。
1.2 目标：API要解决什么？
本课程设计的商户风险评分API旨在提供一套统一的、基于机器学习的实时评分服务，实现以下三大目标：
| 目标维度 | 具体描述 | 关键指标 |
|---|---|---|
| 标准化 | 定义商户风险评分的输入参数、评分区间（0-1000）、风险等级映射（低/中/高/极高） | 评分字段一致率 > 99% |
| 实时化 | 支持单笔交易级与商户级两种评分模式，P99延迟 < 200ms | TP99 < 200ms |
| 可解释性 | 返回风险因子贡献度排名，辅助风控人员快速定位异常特征 | Top-3因子命中率 > 85% |
设计哲学：API不仅是评分工具，更是风控决策链路的“通用语言”——让接入方无需理解底层模型，即可获得一致、可信的风险判断。
1.3 适用场景：谁在用？怎么用？
商户风险评分API覆盖以下三类核心场景：
- 商户准入审核：在商户入驻环节，根据提交的营业执照、法人信息、经营类目等静态数据，输出初始风险评分，决定是否准入及保证金比例。
- 交易实时拦截：在支付链路中，对每笔交易进行实时评分，当评分超过阈值时触发二次验证、延迟结算或直接拒绝。
- 存量商户巡检：定期（每日/每周）对存量商户的交易行为、资金流向、投诉率等动态指标进行评分，发现风险漂移商户并启动调查。
1.4 核心能力概览
本API提供以下关键能力，后续章节将逐一深入讲解：
| 能力模块 | 说明 | 对应章节 |
|---|---|---|
| 评分请求 | 支持商户级（merchant_id）与交易级（transaction_id）两种评分模式 | 第3章：接口规范 |
| 特征工程 | 内置200+风险特征，涵盖商户画像、交易行为、设备指纹、关联网络 | 第5章：特征体系 |
| 模型推理 | 基于LightGBM + 深度交叉网络（DCN）的融合模型，AUC > 0.92 | 第7章：模型架构 |
| 可解释性 | 返回SHAP值Top-5风险因子，支持决策回溯 | 第9章：可解释性 |
| 高可用保障 | 多机房部署、熔断降级、离线兜底策略 | 第12章：稳定性 |
重要提示：本课程所有接口设计均遵循RESTful最佳实践，使用JSON作为数据交换格式，认证方式采用HMAC-SHA256签名。请确保在接入前已获取API密钥并配置好服务端签名逻辑。
1.5 课程适用对象
- 后端/API开发工程师：需要对接或自建风控评分服务的开发者。
- 风控策略分析师：希望理解评分API输出含义并制定策略规则的分析师。
- 技术架构师：正在设计或评审风控系统技术方案的技术负责人。
- 产品经理：负责风控产品规划，需要了解API能力边界与接入流程。