Compliance
The Compliance API enforces regulatory limits, monitors suspicious activity, and manages KYC triggers. It acts as a gatekeeper for all financial transactions.
Features
Monitor transactions before they complete
Enforce KYC-based daily and single transaction limits
Flag suspicious activity for review
Configurable monitoring rules
Endpoints
POST /api/v1/compliance/check
Validate transaction against rules
GET /api/v1/compliance/alerts
List and filter alerts
POST /api/v1/compliance/alerts
Manually flag activity
PUT /api/v1/compliance/alerts/{id}
Update alert status
GET /api/v1/compliance/account-rules
View KYC tier limits
GET /api/v1/compliance/rules
Configure detection rules
Alert Severity Levels
| Level | Description | Action Required |
|---|---|---|
CRITICAL | Blocked transaction | Immediate review |
HIGH | Unusual pattern | Review within 24h |
MEDIUM | Policy violation | Review within 48h |
LOW | Warning only | No immediate action |
Compliance Workflow
Wallet/POS initiates a transaction
System calls /compliance/check to validate amounts and velocity
- Pass: Transaction proceeds
- Block: Transaction rejected, Alert created
- Flag: Transaction proceeds, Alert created
Compliance officer reviews generated alerts