Collect & validate government-issued IDs (driver’s license, passport, state ID) without leaving your intake form.
ID Verify
) in your form using a Publishable Key.POST
s to /api/v1/embedded/actions
with:
publishableKey
id_verification
userId
, loanAppId
, …)OmniEmbedded.mount
)Option | Type / Example | Default | Description |
---|---|---|---|
action | "id" | — | Required. Renders the ID-verification UI. |
publishableKey | "pk_live_…" | — | Required. |
requireSelfie | true | false | false | Capture a selfie and perform face-match when true . |
documentTypes | ["license","passport"] | ["license","passport","state_id"] | Restrict acceptable ID types. |
metadata | { userId: "usr_123", … } | {} | Echoed back in webhook (≤ 2 KB). |
environment | "sandbox" | "live" | "live" | Route calls to sandbox or production. |
onComplete | function(result){ … } | — | Fires when OmniAI accepts the action ({ actionId, type } ). |
onExit | function(info){ … } | — | Fires if the user closes the widget. |
onChange | function(event){ … } | null | Streams every interaction (stage , detail , timestamp ). |
Check | Default rule |
---|---|
Authenticity | Hologram, MRZ, barcode integrity & tamper detection |
Expiration | Document must be valid on processing date |
Face match (optional) | faceMatchScore ≥ 0.80 and liveness passed |
Jurisdiction block-list | Configure in Dashboard → ID Verify → Rules |
Scenario | status | Example errors[0].code | Next step |
---|---|---|---|
ID photo too blurry | completed | ID_IMAGE_BLURRY | Re-prompt user to recapture |
Document expired | completed | ID_EXPIRED | Ask for a valid ID |
Face mismatch (selfie vs ID) | errored | FACE_MISMATCH | Retry capture or send to manual review |
User cancels capture | accepted | — | No retry unless user reopens the widget |