Skip to main content

Integration Overview

The IDV Platform exposes everything through a small set of well-defined surfaces. An integration typically uses two of them: one to run verification workflows, one to manage records.

The surfaces​

SurfacePurposeWho calls it
Capture & Workflow APIStart and drive the capture for a verification session; receive the result.The Company's backend + the capture front-end.
Customer APIRead, search, update, and transition Customer and Digital Identity records.The Company's backend.
Mobile Capture SDKDevelopment of native apps on Android & iOS.The Company's mobile app.
Web ComponentsDevelopment of web-based applications.The Company's website.
Website RedirectPerforming the workflow by redirect to an Innovatrics' hosted web.The Company's website.
No-codeEmail response as a replacement of integration.Fast-start integrations.
WebhooksCallback notifications for results and events.Delivered to the Company's backend.

How they fit together​

  1. The Company's backend starts a session by choosing a workflow.
  2. The app or website runs the capture steps (via SDK or web components) and submits data.
  3. All biometric processing runs server-side; the result comes back to the backend synchronously or via webhook.
  4. Afterwards, the backend uses the Customer API to read history, correct data, or drive state changes.

Authentication​

  • The Capture & Workflow API and Customer API authenticate with OAuth2, that are obtained in the Configuration > Integration settings . Token exchange must happen on the Company's backend, never on the client device, to protect credentials.
  • Webhook deliveries are signed so the receiver can verify authenticity.

See also​