Integration Guide

Integration patterns to embed DxStackinto your systems

Choose the approach that matches how much control you want over the user experience. The underlying control plane remains the same.

  • Clear system boundaries (no replacement of your core systems)
  • Multiple embedding patterns (web, mobile, API)
  • Same governed operations (eligibility, SLA, audit, reconciliation)
integration-architecture
partner.system
SSO redirect
dxstack
$control-plane --pipeline
▸Eligibility→
○Routing→
○SLA→
○Exceptions→
○Audit→
○Reconciliation
// same primitives, different integration surfaces

Where DxStack sits

DxStack operates as a governed orchestration layer between your systems and healthcare providers.

system-architecture.md

┌─────────────────────┐     ┌─────────────────────────────┐     ┌─────────────────────┐
│                     │     │                             │     │                     │
│   Your Systems       │     │   DxStack Control Plane    │     │   Provider Network   │
│                     │     │                             │     │                     │
│  ┌───────────────┐  │     │  ┌───────────────────────┐  │     │  ┌───────────────┐  │
│  │ Portal / App  │──┼─────┼─▶│ Eligibility           │  │     │  │ Diagnostic    │  │
│  └───────────────┘  │     │  │ Routing               │──┼─────┼─▶│ Labs          │  │
│                     │     │  │ SLA Orchestration     │  │     │  └───────────────┘  │
│  ┌───────────────┐  │     │  │ Exception Handling    │  │     │                     │
│  │ Policy Admin  │  │     │  │ Audit Logs            │  │     │  ┌───────────────┐  │
│  └───────────────┘  │     │  │ Reconciliation        │  │     │  │ Clinics       │  │
│                     │     │  └───────────────────────┘  │     │  └───────────────┘  │
│  ┌───────────────┐  │     │                             │     │                     │
│  │ Claims Engine │  │     │  Events / Webhooks ◀────  │     │  ┌───────────────┐  │
│  └───────────────┘  │     │                             │     │  │ Pharmacies    │  │
│                     │     │                             │     │  └───────────────┘  │
└─────────────────────┘     └─────────────────────────────┘     └─────────────────────┘
       You own                      DxStack governs                 Managed network
▸

DxStack governs eligibility, routing, SLA orchestration, exception handling, audit logging, and reconciliation.

▸

Partners retain ownership of portal/app UX, customer relationships, and core systems.

▸

Integration is non-invasive — designed for embedding without replacement or disruption.

What DxStack does and does not do

Clear system boundaries ensure predictable integration scope.

responsibilities.diff
++DxStack provides
  • +Enforce eligibility & entitlements
  • +Provider routing
  • +SLA orchestration
  • +Exception state machine + operator actions
  • +Audit logs & MIS outputs
  • +Reconciliation & settlement visibility
--DxStack does not replace
  • -Partner portals/apps
  • -Claims engines / policy admin
  • -CRM / case management
  • -Finance systems

Choose your integration pattern

Three approaches based on UX ownership and engineering effort. All patterns use the same DxStack control plane.

White-label Web

Fastest go-live

DxStack runs as a white-labeled web app under partner branding. Can be deployed on a domain of your preference. Users transition from your portal to DxStack via SSO redirect.

Best for

Partners seeking minimal development effort and predictable operations

What you build
  • SSO integration for user authentication
  • Deep links to DxStack web app
What DxStack provides
  • Fully hosted white-labeled web app
  • Partner branding (logo, colors, domain)
  • All UI for booking, tracking, reports
Same 6 primitives: Eligibility → Routing → SLA → Exceptions → Audit → Reconciliation
example.ts
1// Redirect user to DxStack with SSO token
2const redirectToDxStack = async (userId: string) => {
3  const token = await generateSSOToken(userId);
4  
5  window.location.href = `https://benefits.yourcompany.com
6    ?sso_token=${token}
7    &return_url=${encodeURIComponent(window.location.href)}`;
8};

Reference flow

The same operational sequence applies across all integration patterns.

sequence-diagram
Partner
DxStack
Provider
Request benefit
Check eligibility
Route to provider
Confirm appointment
Start SLA timers
Complete service
Log audit trail
Create recon record
Emit webhook
Update status
// primitives enforce rules at each step regardless of integration surface

Operational primitives

Core capabilities remain constant across all integration patterns.

checkEligibility()

Eligibility & entitlement rules

Policy-aligned enforcement of coverage terms, eligibility criteria, and benefit limits.

routeToProvider()

Provider routing

Network-aware and geography-based routing to contracted providers.

trackSLA()

SLA orchestration

Track provider commitments with automated monitoring and escalation.

handleException()

Exception handling

Governed workflows for failures, escalations, and manual interventions.

logAudit()

Audit logs & MIS

Complete audit trails for regulatory compliance and reporting.

reconcile()

Reconciliation & settlement

Real-time transparency into fulfillment and settlement data.

// same primitives, any integration pattern

Trust & compliance

Enterprise security posture for regulated environments.

SOC 2 Type II

Independent audit of security, availability, and confidentiality controls.

ISO 27001

Information security management system certification.

India-based data hosting

All data hosted within India for regulatory compliance.

DPDP-aligned posture

Data protection practices aligned with DPDP Act requirements.

Ready to integrate?

Discuss Integration

We evaluate fit carefully. Share your requirements and we'll scope the integration together.

// technical scoping · integration planning · no commitment required