KillB 实施分层的了解您的客户（KYC）系统，包含五个级别（L0-L4）。每个级别都有不同的要求和交易限制，以平衡用户体验和监管合规性。
级别比较
| 级别 | 验证 | 每日限制 | 每月限制 | 处理时间 |
|---|
| L0 | 仅电子邮件 | $500 | $1,000 | 即时 |
| L1 | 基本信息 + 身份证号码 | $2,500 | $10,000 | 即时 |
| L2 | 身份证图像 + 地址证明 | $10,000 | $50,000 | 1-24 小时 |
| L3 | 增强尽职调查 | $50,000 | $250,000 | 1-5 天 |
| L4 | 企业验证 | 自定义 | 自定义 | 5-10 天 |
级别 L0 - 电子邮件验证
用户可以做什么：
限制：
升级路径： 提交基本个人信息 → L1
级别 L1 - 基本 KYC
L1 要求
所需信息：
- 全名（名、中、姓）
- 出生日期
- 电子邮件和电话
- 物理地址
- 政府身份证号码
- 国籍
限制：验证： 自动化，即时
- 常规 on/off-ramps
- 大多数支付方式
- 多个账户
- 基本储蓄账户
示例：
{
"type": "PERSON",
"data": {
"firstName": "María",
"lastName": "López",
"dateOfBirth": "1992-03-10",
"email": "[email protected]",
"phone": "+525512345678",
"address": { /* 完整地址 */ },
"document": {
"type": "RFC",
"number": "LOMM920310ABC",
"issuedCountryCode": "MX"
},
"nationality": "MX",
"citizenship": "MX"
}
}
级别 L2 - 增强 KYC
L2 要求
所需文档：
- 所有 L1 信息
- 政府身份证图像（正面 + 背面）
- 地址证明（水电费账单、银行对账单或租赁协议）
- 用于活体检测的自拍
限制：验证： 1-24 小时（人工审核）
- 更高价值的交易
- 所有支付方式
- 预充值账户
- 完整的储蓄功能
- 优先支持
文档上传：
POST /api/v2/users/person/document
Content-Type: multipart/form-data
const formData = new FormData();
formData.append('userId', userId);
formData.append('documentType', 'PASSPORT');
formData.append('frontDocument', frontImageFile);
formData.append('backDocument', backImageFile);
await fetch('/api/v2/users/person/document', {
method: 'POST',
headers: {
'Authorization': `Bearer ${token}`
},
body: formData
});
PASSPORTDRIVER_LICENSENUIPINEPROVE_OF_ADDRESS_UTILITY_BILLPROVE_OF_ADDRESS_BANK_STATEMENT
升级路径： 提交资金来源文档 → L3
级别 L3 - 高级 KYC
L3 要求
额外文档：
- 所有 L2 要求
- 资金来源文档
- 银行对账单（最近 3 个月）
- 就业验证或商业财务报表
- 增强尽职调查问卷
限制：验证： 1-5 个工作日
- 高价值交易
- 机构功能
- 自定义结算条款
- 专属客户经理
资金来源文档：
POST /api/v2/users/person/document
const uploadSourceOfFunds = async (userId, documentFile) => {
const formData = new FormData();
formData.append('userId', userId);
formData.append('documentType', 'SOURCE_OF_FUNDS_BANK_STATEMENT');
formData.append('frontDocument', documentFile);
await fetch('/api/v2/users/person/document', {
method: 'POST',
headers: { 'Authorization': `Bearer ${token}` },
body: formData
});
};
SOURCE_OF_FUNDS_BANK_STATEMENTSOURCE_OF_FUNDS_PAYSLIP- 就业信函
- 商业财务报表
升级路径： 联系支持进行企业验证 → L4
级别 L4 - 企业
L4 要求
自定义验证：
- 所有 L3 要求
- 商业计划和模式
- 公司文档
- 合规批准
- 法律审查
- 合同谈判
限制：验证： 5-10 个工作日 + 谈判
- 无限制交易（自定义限制）
- 白标集成
- 自定义功能
- SLA 保证
- 专属基础设施
如何申请：
联系 KillB 销售：[email protected]
检查用户级别
GET /api/v2/users/{userId}
{
"id": "user-id",
"accessLevel": "L2",
"status": "ACTIVE",
"note": "KYC 验证完成"
}
级别转换
自动升级
用户提交所需信息时自动升级：
监控升级
使用 webhooks 跟踪级别更改：
{
"event": "user.level_changed",
"data": {
"userId": "user-id",
"previousLevel": "L1",
"newLevel": "L2",
"status": "ACTIVE"
}
}
处理拒绝
如果 KYC 验证失败：
{
"id": "user-id",
"status": "REJECTED",
"accessLevel": "L0",
"note": "文档图像不清晰。请重新提交更高质量的图像。"
}
- 文档图像不清晰
- 信息不匹配
- 文档过期
- 未成年用户
- 禁止的司法管辖区
- 活体检测失败
解决方案：
- 查看
note 字段了解具体原因
- 纠正问题
- 重新提交文档
- 等待重新审核
交易限制
限制在所有交易中累计：
const checkUserLimits = async (userId) => {
const user = await getUser(userId);
const limits = {
'L0': { daily: 500, monthly: 1000 },
'L1': { daily: 2500, monthly: 10000 },
'L2': { daily: 10000, monthly: 50000 },
'L3': { daily: 50000, monthly: 250000 }
};
const userLimits = limits[user.accessLevel];
const usedToday = await getTransactionTotal(userId, 'today');
const usedMonth = await getTransactionTotal(userId, 'month');
return {
dailyRemaining: userLimits.daily - usedToday,
monthlyRemaining: userLimits.monthly - usedMonth
};
};
限制以美元等值计算。所有交易都转换为美元以进行限制跟踪。
最佳实践
- 从 L0/L1 开始
- 仅在需要时升级
- 在用户达到 L1 限制之前不要请求 L2 文档
- 解释更高级别的优势
- 显示当前级别和限制
- 解释升级所需内容
- 提供文档指南
- 设定审核时间预期
- 指导用户照片质量
- 展示良好文档示例
- 检查文件大小和格式
- 上传前验证图像
- 使用提供的
complianceUrl
- 引导用户完成 KYC
- KillB 处理整个 KYC 流程
- 完成时接收 webhooks
下一步
