Documentation
Contact

KYC Mosaic Web - JAAK

Description

JAAK KYC Mosaic Web is a complete identity check solution that allows processes KYC at web applications quickly and securely.

Capacities

  • Automatic collection of identity document data
  • Verification of authenticity of documents
  • Live facial identity check
  • Facial Comparison OTO (One-to-One)
  • Black list verification against security databases

Means of Integration

ModeDescription
Embed (iframe)Keep the user in your domain with real-time bidirectional communication and complete Layout control
Direct (New Fairy)Full screen experience optimized for mobile applications
Link (URLs)autocontained URLs that require "zero code from the client's side," perfect for email / SMS campaigns

Medical care

  • Sailors: Chrome 80 +, Firefox 75 +, Safari 13 +, Edge 80 +
  • Protocol: HTTPS production obligation
  • JavaScript: ES6 + for Embed and Direct Mode
  • API Key Dashboard JAAK (backend only)
  • Auto ShortKey - generated by session

Authentication

Authorization: Bearer YOUR_API_KEY

URLs Base

EnvironmentURL
Sandboxhttps://sandbox.kyc.jaak.ai
Productionhttps://kyc.jaak.ai

Establishment of a Session

Endpoint:

POST /api/v1/kyc/flow

Required fields:

  • name - full name of client
  • flow - single session identifier
  • countryDocument - Alpha-3 code of the country
  • flowType - "KYC"
  • verificationType - email, Whatsapp, sms or empty

Answer: Session URL with 7 character ShortKey at the end.

Verification Steps

Configure steps: WELCOME, DOCUMENT_EXTRACT, DOCUMENT_VERIFY, BLACKLIST, IVERIFICATION (livelihood), LOCATION_PERMISSIONS, OTO, FINISH

Event Management

The Embed and Direct modes communicate through postMessage():

EventDescription
READYRetiring component
STEP_COMPLETEStep complete
FLOW_COMPLETEFlow complete
ERRORError
SESSION_EXPIREDExpirand session (14 min inactivity)

Security Guidelines

  • Never explain API code keys to the client's side
  • Using environment variables for memory storage
  • Validate production message origins
  • Rotate keys regularly

Support