Verification States KYC
Five Main States
| State | Icon | Description |
|---|
| Adopted | ✅ | User completed and passed all validations |
| Rejected | ❌ | User did not meet safety criteria or exceeded permitted attempts |
| Under review | ⚠️ | Requires manual validation by an agent |
| Assigned | ⌛️ | User did not complete flow within time limit |
| Stretch / Uninitiated | 📋 | Session created but user haven't started |
Identification Methodology
Based on an attempt to balance security with user experience.
Document Verification Meters
| Attempts | State |
|---|
| 1-3 | Adopted |
| 4-5 | Under review |
| +5 | Rejected |
Liveness threshold
| Attempts | State |
|---|
| 1-2 | Adopted |
| 3 | Under review |
| +3 | Rejected |
OTO Biometric Comparison Meters
| Attempts | State |
|---|
| 1 | Approved or Rejected (determined immediately) |
| +1 | Automatic rejection |
States in response API
Stretch / Uninitiated
{
"state": "",
"statusDetail": { "state": "", "stage": "" }
}
Assigned
{
"state": "",
"statusDetail": { "state": "finished", "stage": "lapsed_motor" }
}
Under review
{
"status": "NEED_REVIEW",
"statusDetail": { "state": "finished", "stage": "in_review" }
}
Adopted
{
"status": "PASS",
"statusDetail": { "state": "finished", "stage": "approved" }
}
Rejected
{
"status": "FAIL",
"statusDetail": { "state": "finished", "stage": "rejected" }
}
Consultation Endpoint
GET /v1/kyc/session/{{sessionID}}
