8. eKYC & Ký hợp đồng điện tử#
Mục tiêu#
Cho phép creator xác minh danh tính (CCCD) và ký hợp đồng điện tử để nhận hoa hồng.
Luồng nghiệp vụ#
8.1. Xác minh danh tính (eKYC)#
- Người dùng truy cập trang "Hợp đồng".
- Tải ảnh CCCD/CMND.
- Hệ thống trích xuất thông tin từ ảnh bằng OCR (API nội bộ).
- Người dùng xác nhận thông tin → gửi yêu cầu xác minh.
- Trạng thái: PENDING → APPROVED / REJECTED.
8.2. Ký hợp đồng#
- Sau khi eKYC được duyệt, người dùng cung cấp thông tin thanh toán.
- Hệ thống tạo hợp đồng → chuyển hướng đến trang cộng tác viên AccessTrade (ctv.scalef.com).
- Ký hợp đồng trên AccessTrade (cung cấp thông tin, xác thực, xem/tải hợp đồng).
- T-Fluencers lưu mã định danh để nhận diện user tương ứng.
- Kết quả ký được thông báo lại cho T-Fluencers.
API đã triển khai#
POST /users/identification— Gửi thông tin xác minhPOST /users/identification/image— Trích xuất OCR từ ảnh CCCDPOST /users/contract/info— Lưu thông tin hợp đồngPOST /users/contract/estimate— Ước tính hợp đồngGET /users/contract/pre-signed— Lấy link tải hợp đồngGET /users/service-tos/redirect-url— Chuyển hướng trang AccessTrade
Tiêu chí chấp nhận (Acceptance Criteria)#
| # | Tiêu chí | Điều kiện đạt |
|---|---|---|
| AC-8.1 | Upload ảnh CCCD | Upload ảnh mặt trước/sau → OCR trích xuất: họ tên, số CCCD, ngày sinh, giới tính, địa chỉ |
| AC-8.2 | Xác nhận thông tin OCR | Hiển thị thông tin trích xuất → user xác nhận hoặc chỉnh sửa → gửi xác minh → trạng thái PENDING |
| AC-8.3 | eKYC được duyệt | Admin duyệt → trạng thái APPROVED → user có thể tiếp tục ký hợp đồng |
| AC-8.4 | eKYC bị từ chối | Admin từ chối → trạng thái REJECTED kèm lý do → user nhận thông báo và có thể gửi lại |
| AC-8.5 | Ký hợp đồng thành công | Sau eKYC duyệt → nhập thông tin thanh toán → redirect sang ctv.scalef.com → ký xong → T-Fluencers nhận callback |
| AC-8.6 | Tải hợp đồng | User đã ký → có thể tải hợp đồng PDF qua presigned URL |