Skip to main content

Core Capabilities

Comprehensive overview of botsKYC platform capabilities and services.

Document Verification​

Identity Documents​

Verify government-issued identity documents including national ID cards (Omang), passports, driver's licenses, and residence permits.

Key Features:

  • Automatic document classification
  • Front/back image merging
  • Data extraction with confidence scores
  • Authenticity verification
  • Expiry date validation

Address Verification​

Validate proof of residence documents including utility bills, lease agreements, and council bills.

Key Features:

  • Multi-page PDF support
  • Address extraction and standardization
  • Date validation

Income Verification​

Verify employment and income documents including pay slips, contracts, and tax certificates.

Key Features:

  • Salary amount extraction
  • Employer verification
  • Tax deduction validation

Business Entity Verification​

Validate business registration documents including BIN certificates, company registration, and incorporation documents.

Key Features:

  • Company name and registration number extraction
  • Director/shareholder identification
  • Business type classification

Compliance Documents​

Verify tax and regulatory compliance documents.

Supported Documents:

  • Tax Clearance Certificates
  • Company Profiles
  • Authorisation Letters
  • VAT Registration
  • Board Resolutions

Features:

  • TIN number validation
  • Validity period checking
  • Compliance status verification
  • Authority validation

API Endpoint:

POST /api/v/kyc/verify/compliance

Liveness Detection​

Face Liveness Verification​

Ensure the person is physically present during verification.

Capabilities:

  • Anti-spoofing detection (photos, videos, masks)
  • Deepfake detection
  • Session-based verification flow
  • Quality metrics (brightness, sharpness)

Use Cases:

  • Remote customer onboarding
  • Account recovery
  • High-risk transactions
  • Age verification

API Endpoints:

POST /api/liveness/session           # Create session
GET  /api/liveness/session/{id}/results  # Get results
POST /api/liveness/verify/{id}      # Verify liveness

---

## Liveness Detection

### Face Liveness Verification
Prevent spoofing attacks with real-time biometric verification. Detects photos, videos, masks, and deepfakes.

**Key Features:**
- Spoof detection (photos, videos, masks)
- Challenge-response verification
- Real-time processing
- Session management

### Face Matching
Compare live selfies with document photos for identity verification.

**Key Features:**
- Similarity scoring (0-100%)
- Configurable match threshold
- Multi-angle comparison

---

## Data Extraction

### Structured Data Output
Extract data from documents in consistent JSON format with confidence scores.

**Extracted Fields:**
- Personal information (names, dates, IDs)
- Addresses and locations
- Financial data
- Business information

### Multi-Language Support
Process documents in English and Setswana with automatic language detection and localized date formats.

### Smart Document Merging
Automatically combine data from multiple sources (front/back ID cards, multi-page PDFs) for complete data extraction.

---

## Fraud Detection

### Real-Time Fraud Scoring
Analyze documents for fraud indicators including forged documents, tampered images, and suspicious patterns.

**Risk Indicators:**
- Document quality anomalies
- Pattern mismatches
- Cross-verification failures
- Historical fraud patterns

### Pattern Recognition
Identify suspicious patterns including duplicate submissions, velocity checking, anomaly detection, and network analysis to prevent fraud rings.

---

## Compliance and Security

### KYC/AML/CTF Compliance
Built-in compliance features including customer due diligence (CDD), enhanced due diligence (EDD), ongoing monitoring, and risk assessment.

### Regulatory Compliance
Built-in compliance with financial regulations and data protection laws (POPIA, GDPR).

### Audit Trail
Comprehensive logging of all verification activities including timestamps, documents processed, results, and user information for regulatory compliance and security monitoring.

---

### Reporting and Analytics

**Coming Soon:**
Access verification data, success rates, document type distribution, and fraud detection statistics. Export in JSON, CSV, or PDF formats.

---

## Integration

### REST API
Modern RESTful API with OpenAPI 3.0 specification, JSON request/response, and multipart file upload support.

### Webhooks
Event-driven notifications for verification completion, failures, and fraud detection with custom endpoint URLs and retry logic.

---

### SDKs and Libraries

**Coming Soon:**
Official SDKs available for JavaScript/TypeScript, Python, Java, React, and mobile platforms (iOS, Android).

---

## Performance

Fast processing optimized for speed and accuracy:
- Real-time verification: < 3 seconds
- Batch processing: 5-10 seconds
- High throughput: 1000+ requests/minute

---

## Integration Capabilities

### REST API
Modern RESTful API with comprehensive documentation.

**Features:**
- OpenAPI .0 specification
- JSON request/response
- Multipart file upload support
- Pagination and filtering

---

### Webhooks
Event-driven notifications for asynchronous workflows.

**Supported Events:**
- `verification.completed`
- `verification.failed`
- `liveness.completed`
- `fraud.detected`


### Scalability
Built to handle high volume with auto-scaling infrastructure, load balancing, and distributed processing.

---

### Caching and Optimization

Performance enhancements:
Intelligent caching for document classification, model results, and API responses to improve performance.

---

## Next Steps

- [Architecture](./architecture) - System design
- [Security and Privacy](./security) - Data protection and compliance
- [Performance](./performance) - SLA and metrics
- [Integration Guide](./integration) - Start integrating