Guides

Step-by-Step ABDM Integration: From Sandbox to Production Certification

A practical guide for hospital IT and software vendors navigating the ABDM developer sandbox, M1/M2/M3 milestones, and NHA production clearance.

Ashish Singh

Chief Architect

9 min read
ABDM Sandbox to Production Certification Milestones

Integrating hospital software with the Ayushman Bharat Digital Mission (ABDM) has become an essential compliance and operational requirement across India. Whether you are building an in-house Hospital Information System (HIS), a commercial Electronic Medical Records (EMR) platform, or an insurance gateway, every integration journey begins in the official ABDM developer sandbox.

Step 1: Onboarding to the ABDM Developer Sandbox

The first step is creating a developer account on the official sandbox portal (sandbox.abdm.gov.in). Once registered, you generate a sandbox Client ID and Client Secret, configure your callback endpoints, and access the interactive Swagger documentation.

  • Authentication Protocol: OAuth 2.0 with client credentials grant type to obtain short-lived Bearer tokens.
  • Data Exchange Standards: HL7 FHIR R4 for clinical summaries, diagnostic reports, and claims.
  • Transport & Storage Security: TLS 1.2+ for all network endpoints and AES-256 encryption at rest.
  • Gateway Callback Architecture: The ABDM gateway calls your webhook endpoints asynchronously for OTP delivery, consent updates, and health information transfers.

Step 2: The Mandatory Three-Milestone Architecture (M1, M2, M3)

The National Health Authority (NHA) divides ABDM compliance into three progressive milestone tiers:

  1. Milestone 1 (M1) — Healthcare Professionals Registry (HPR): Verifying doctor and clinician licenses, council registration numbers, and digital signatures against the central registry.
  2. Milestone 2 (M2) — Health Facility Registry (HFR): Registering the hospital, clinic, or diagnostic center, obtaining a unique HFR ID, and mapping departments and bed categories.
  3. Milestone 3 (M3) — ABHA Verification & Encrypted Health Information Exchange: Creating and verifying Ayushman Bharat Health Accounts (ABHA), linking hospital records (HIP), managing patient consent via Consent Managers, and transmitting encrypted FHIR bundles.
Milestone 3 represents over 70% of the technical complexity in ABDM compliance. It requires handling public key cryptography, Diffie-Hellman key exchanges for artifact transfers, and strict FHIR R4 document structuring.

Step 3: Realistic Timelines and Certification Bottlenecks

Software teams building ABDM integration directly into existing legacy databases typically spend between 8 and 16 weeks navigating sandbox edge cases, payload formatting errors, and callback timeouts. When significant hospital database customisation is required, timelines can stretch to 24 weeks.

Modern bidirectional adapters accelerate this journey dramatically. By pre-mapping the M1, M2, and M3 workflows to standard internal schemas, hospitals can achieve complete sandbox clearance and production certification in as little as 2 to 3 weeks.

Continue reading

Ready to connect your systems to NHCX?

Talk to our integration team about sandbox access, compliance mapping, and production rollout.

Request a Demo