先把整条链路想清楚,再做界面
我们在金边做软件开发十二年,团队二十八个人,客户分布在柬埔寨、菲律宾、越南、老挝、泰国、印尼、马来西亚这几个市场。电商、娱乐、金融/交易、地产、物流这些行业都碰过,KYC需求最密、验收最较真的,基本集中在交易平台。很多团队一上来就画上传页面,这坑踩得最多。一条KYC记录从产生到归档要经过六个关键节点,每个节点的技术选型都会直接影响后面所有环节:
- 用户侧提交:证件正反面拍摄、基础信息填写、可选活体检测、文件加密上传。这一层决定用户会不会中途放弃,也决定后面审核员看到什么质量的素材。
- 传输层:不走应用服务器中转,采用预签名URL直传对象存储。单文件大小和格式在签发凭证时做白名单校验,从源头挡住超大文件和异常格式。
- 审核后台:基于角色分配权限的审核工作台,待审核队列按提交时间排序,支持图像增强处理,审核员不接触原始文件。
- 决策动作:人工审批或驳回,任何操作触发状态变更并写入审计日志,不可篡改。
- 状态广播:审核结果通过消息队列同步给账户中心、风控系统、银行卡管理模块,各系统不再轮询。
- 合规归档:原始文件与审核记录加密存储,保留周期按客户目标市场的监管要求配置,到期前由合规负责人确认处置策略。
这六个节点我们内部叫“一条线”,新项目启动时先把这条线画清楚,再按节点拆任务。下面按用户侧和管理员侧两条路径分别展开。
用户侧:体验和安全不是二选一
用户提交KYC资料的时候,耐心很有限。界面得给出明确的拍摄引导,而不是丢一个上传框让用户自己猜。我们把提交界面抽象成四类核心内容:
- 证件正面照片:要求清晰显示姓名、证件号、签发机关,界面用对齐框引导用户把证件边缘卡进参考线内。
- 证件反面照片:国徽面或包含有效期的信息面,提示避免反光和遮挡。反光和遮挡是审核驳回里最常见的两类原因,界面文案需要把这两点讲得足够直白。
- 实名信息表单:姓名、证件类型、证件号码、出生日期,前端做格式校验,身份证号直接跑校验位算法,减少无效提交。
- 手持证件自拍:仅在高安全场景启用,实时检测人脸与证件是否同框,防止拿别人证件照片冒充。
文件传输为什么不能走应用服务器
如果用户上传的证件照片先经过应用服务器再转存,等于让所有业务代码都有机会触达敏感文件,泄漏面太大。我们的做法是客户端直传对象存储:用户点击提交后,后台签发短期有效的临时凭证和预签名URL,前端用分片上传组件把文件推送到隔离的KYC存储桶。上传完成后,前端只把文件Key和元数据回传给业务服务器,文件内容不经过应用内存。
这套方案有三个硬性细节:传输层强制加密;文件Key用UUID v7生成,防止遍历猜测;用户提交的表单数据和文件元数据加密后落库。菲律宾和印尼的项目里,客户那边的合规团队对传输层的要求尤其严格,这三个细节基本是验收时的必查项,少一个都过不了。TLS版本这块需要根据客户目标市场的网络环境做兼容性处理,不能一刀切。
管理员侧:审核效率决定KYC系统的口碑
审核员一天要处理大量证件,工作台设计直接影响审核速度和错误率。我们用Vue3实现的审核界面分三块:待审核队列、证件查看器、操作面板。进入单条记录后,证件正面、反面、用户填写的实名信息并排展示,审核员不需要在多个页面之间来回切。
真正拉开效率差距的是图像处理工具。证件照片来自用户手机拍摄,过暗、过曝、倾斜、局部模糊是常态。我们在后台服务里嵌入了sharp图像处理模块,给审核员提供几个能力:
- 亮度/对比度调节:拖拽滑块实时调整,把过暗照片中的水印和微缩文字拉出来。
- 旋转与裁剪:纠正拍摄倾斜,截取证件主体区域,去掉杂乱背景干扰。
- 局部放大:鼠标悬停时对防伪点区域做无损放大,核查细节。
- 参考图叠加:后台可上传标准证件模板,半透明叠加比对,快速识别PS痕迹。
所有图像处理都在服务端完成,通过Canvas渲染为WebP预览图。这里有一个原则我们一直坚持:处理只影响预览,不修改原始文件。证据链的完整性比审核便利更重要。越南一个地产项目的KYC验收中,客户的安全顾问专门确认过这一点,他们担心的是审核员为了看清细节把原图覆盖了,后面审计拿不到原始凭证。
审核决策必须留痕
管理员确认信息无误后点击通过,系统执行两个原子操作:更新用户表的kyc_status字段,同时调用账户中心接口激活完整交易权限。驳回则必须填写具体原因,例如“证件模糊”或“信息不一致”,原因通过站内信和邮件实时推送给用户。
每一次审核动作都会在audit_log表生成记录,包含操作人、时间戳、操作前后的状态快照。这条日志为合规审计服务,不允许任何角色修改或删除。柬埔寨本地客户对日志留痕的敏感度不如新加坡背景的团队高,但我们一律按最严的标准做,避免客户后续接盘时被动。
状态机:不允许出现“非法跃迁”
KYC状态流转必须严格遵循有限状态模型,否则会出现用户已通过但权限没开、或已驳回还能交易的情况。我们使用的状态表如下:
| 当前状态 | 触发事件 | 目标状态 | 说明 |
|---|---|---|---|
| NOT_SUBMITTED | 用户提交KYC资料 | PENDING | 进入待审核队列 |
| PENDING | 管理员批准 | APPROVED | 激活交易权限 |
| PENDING | 管理员驳回 | REJECTED | 附驳回原因,允许重新提交 |
| REJECTED | 用户重新提交 | PENDING | 覆盖旧资料,进入新审核周期 |
| APPROVED | 定期复审任务触发 | PENDING_REVIEW | 触发条件由风控规则和合规策略共同决定 |
状态变更通过Redis发布订阅通知关联服务,避免各系统轮询数据库。高并发提交场景下,更新用户KYC状态时使用乐观锁(版本号),防止两名审核员同时处理同一条记录造成重复审核。这个乐观锁机制在娱乐类平台的高峰时段特别关键,用户集中在晚间提交,审核团队也在那个时段开工,撞单的概率比想象中高。
通过认证之后的联动:银行卡绑定
KYC通过不是终点。交易平台的资金闭环要求只有实名用户才能发起提现,因此管理员后台需要具备为用户绑定或修改银行卡的能力。这个操作有三条约束:仅在KYC状态为APPROVED时可执行;绑卡操作需要二次验证管理员权限;系统调用银行BIN号接口校验卡有效性,卡号脱敏展示,只保留首位和后四位。
这个功能看着简单,但和KYC状态的联动一旦松了,就会出现未认证账户发起提现的漏洞。我们验收时专门会测这条路径。支付通道的对接我们只负责技术侧,通道资源由客户自己提供,但银行卡绑定和KYC状态的联动逻辑,我们会在验收清单里单列一条,因为这是资金安全的第一道闸。
合规层:证件过期管理与多语言识别
东南亚和南亚市场里,印度SEBI的KYC注册机构(KRA)规范是很多交易平台绕不开的参考标准。我们在系统设计阶段预留了与CERSAI、CKYC等中央库的对接接口,支持XML数据上报格式。文件存储采用WORM(一次写多次读)策略,防止归档后的资料被篡改。
证件有效期管理是另一个容易忽视的点。系统会定期扫描证件有效期,在到期前分阶段向用户发出更新提醒。竞技预测和数字娱乐平台对此特别敏感,因为账户突然受限会直接打断用户的操作节奏。这里有一个状态机层面的配合:定期扫描任务触发后,原本处于APPROVED状态的记录会进入PENDING_REVIEW,而不是直接被禁用,给用户留出重新提交的窗口。
多语言证件识别方面,我们集成了OCR引擎,支持中文、英文以及印度本地语言(如印地语、马拉地语)的证件识别,辅助审核员快速录入信息。印尼和马来西亚的项目里用得比较多,当地证件类型杂,马来文、印尼文、英文混排,纯靠人工录入的错误率在高峰期会明显上升,OCR能把这个压力降下来一截。不过OCR不是万能的,遇到证件磨损严重或者拍摄角度太偏的情况,还是得靠审核员手动校正。
常见问题
审核时间一般多久?
取决于审核团队的人数和证件质量。系统本身按提交时间排队,不做乱序处理,但支持紧急工单插队。审核积压通常不是技术问题,是审核人力配置问题。
用户上传的文件存在哪里?安全怎么保证?
存储在AWS S3或阿里云OSS的私有Bucket中,启用服务端加密和跨区域复制。访问仅限签名URL临时授权,审核后台通过内网VPC传输,不暴露公网入口。
怎么防止用户提交虚假证件?
人工审核结合图像处理工具是第一道关卡。同时接入第三方证件验证API做身份联网核查,高风险地区可强制要求活体检测。多因子验证组合起来,伪造证件通过的概率会大幅降低。
这套KYC方案在多个交易平台中运行,部分成品系统已有几十家客户在持续使用。电商类系统我们有成品,开箱即用,交付周期短;交易类KYC模块则需要按功能清单评估,小项目几天能上线,大项目开发周期大约两个月。团队每年交付约一百个项目,KYC相关的定制需求通常集中在交易和娱乐两个行业。如果你正在为交易平台规划KYC模块,或者现有系统审核效率上不去,可以按功能清单来评估开发范围。团队支持中文沟通,系统bug修复免费,新增功能按实际工作量计费。
