Platform Integration Architecture

Complete Flow Diagrams

Establish Identity Flow

Customer System                Partner Platform              CLEAR API
      |                               |                          |
      | 1. User initiates action      |                          |
      |------------------------------>|                          |
      |                               |                          |
      |                               | 2. Check user profile    |
      |                               |    clear_user_id = null  |
      |                               |                          |
      |                               | 3. POST /sessions        |
      |                               |    (with UPM + custom    |
      |                               |     fields: employee_id) |
      |                               |------------------------->|
      |                               |                          |
      |                               | 4. Session created       |
      |                               |<-------------------------|
      |                               |                          |
      | 5. Redirect to CLEAR          |                          |
      |<------------------------------|                          |
      |                               |                          |
      | 6. Complete verification      |                          |
      |    (ID + Selfie)              |                          |
      |---------------------------------------------->|          |
      |                               |                          |
      |                               | 7. Biometric matching    |
      |                               |    against custom_fields |
      |                               |                          |
      | 8. Redirect with session_id   |                          |
      |------------------------------>|                          |
      |                               |                          |
      |                               | 9. GET /sessions/{id}    |
      |                               |------------------------->|
      |                               |                          |
      |                               | 10. Results (user_id)    |
      |                               |<-------------------------|
      |                               |                          |
      |                               | 11. Store user_id to     |
      |                               |     employee profile     |
      |                               |                          |
      | 12. Access granted            |                          |
      |<------------------------------|                          |

Known User Key Flow

Customer System                Partner Platform              CLEAR API
      |                               |                          |
      | 1. User initiates action      |                          |
      |------------------------------>|                          |
      |                               |                          |
      |                               | 2. Check user profile    |
      |                               |    clear_user_id exists  |
      |                               |                          |
      |                               | 3. POST /sessions        |
      |                               |    (with user_id)        |
      |                               |------------------------->|
      |                               |                          |
      |                               | 4. Session created       |
      |                               |<-------------------------|
      |                               |                          |
      | 5. Redirect to CLEAR          |                          |
      |<------------------------------|                          |
      |                               |                          |
      | 6. Complete selfie-only       |                          |
      |    verification (3-5 sec)     |                          |
      |---------------------------------------------->|          |
      |                               |                          |
      | 7. Redirect with session_id   |                          |
      |------------------------------>|                          |
      |                               |                          |
      |                               | 8. GET /sessions/{id}    |
      |                               |------------------------->|
      |                               |                          |
      |                               | 9. Results (user_id)     |
      |                               |<-------------------------|
      |                               |                          |
      |                               | 10. Verify user_id match |
      |                               |     to stored value      |
      |                               |                          |
      | 11. Access granted            |                          |
      |<------------------------------|                          |