Hosted Flow vs. Direct API
Choose the right RiskOS™ integration approach — a Socure-hosted end-user UI (Hosted Flow) or your own front end calling the Evaluation API directly.
RiskOS™ supports two integration approaches. Both use the same evaluation runtime, enrichment pipeline, and decision model — the difference is who owns the end-user experience.
- Hosted Flow — Socure hosts a prebuilt, configurable end-user UI. You redirect users to it (or embed it) and receive results by webhook.
- Direct API — Your application owns the UI and calls the Evaluation API directly, optionally using Socure SDKs for capture steps like DocV.
Comparison
| Dimension | Hosted Flow | Direct API |
|---|---|---|
| End-user UI | Socure-hosted, prebuilt (web) | You build it (web/mobile, optionally with Socure SDKs) |
| Time to launch | Fastest — minimal front-end work | Longer — you implement the UX and step handling |
| UX control | Template customization and branding | Full control over every screen and interaction |
| Execution model | Asynchronous (results via webhook) | Synchronous or asynchronous |
| Step-up flows (DocV, OTP) | Handled within the hosted UI | You orchestrate pauses/resumes and collect input |
| Engineering effort | Low | Higher |
| Best for | Rapid onboarding, lean front-end teams | Fully custom experiences and tight UX integration |
Choose Hosted Flow if…
- You want to launch quickly with minimal front-end development.
- A Socure-managed, configurable UI (with your branding) meets your UX needs.
- You're comfortable receiving results asynchronously via webhooks.
→ See Hosted Flows.
Choose Direct API if…
- You need full control over the end-user experience and screen flow.
- You're orchestrating custom workflows and want to call enrichments directly.
- You need synchronous decisions, or you'll manage async step-up flows yourself.
→ See Integrating with RiskOS™.
You're not locked in. Because both approaches share the same runtime and decision model, you can start with a Hosted Flow and migrate specific flows to the direct API later without rebuilding your workflows.
Related topics
- How Hosted Flows Work — What a Hosted Flow is and how it runs (concept)
- Set up Hosted Flows — Configure and build a Hosted Flow
- Integrating with RiskOS™ — Direct API quickstart
- Get Started with RiskOS™ — The full quickstart journey
Updated 10 days ago
Did this page help you?