DevTools
The exchange end to end, in a tab: read how an endpoint behaves, build a bundle that validates, and trade claims with a mock payer until every flow passes. Nothing you do here touches your servers.
Developer tools for NHCXBuild against NHCX before you connect to it
Two tools and no third thing to choose between: one that teaches and rehearses the exchange in a browser tab, one that carries it in production.
NHCX Adapter
The piece you actually deploy. Post a FHIR bundle to it, read a plain callback back, and it does the headers, the encryption, the certificates and the acknowledgements in between. One JSON config, no database.
What you’d use DevTools for
- Starting from zeroFourteen chapters across two tracks, from what the exchange is to how a claim settles, each ending in a short check that remembers where you got to.
- Preparing your first claimCompose eligibility, pre-authorisation, claim and payment bundles against the ABDM profiles, and find what is wrong before a real send does.
- Testing with no counterpartyA mock payer answers, so a whole flow runs end to end before anyone assigns you a partner. When one fails, the decrypted request and callback are both there.
NHCX Adapter
One binary between your system and NHCX. Your software posts a FHIR bundle to it and reads a plain callback back; the adapter does the x-hcx-* headers, the encryption, the certificates and the acknowledgements. Nothing else about your system changes.
What you’d use the adapter for
- Put an existing system on NHCXYour HMIS or claims software posts a bundle to one local endpoint and reads plain JSON back. Nothing inside it learns the protocol, and one adapter can carry several participant codes.
- Move from sandbox to productionOne switch in config.json. The same calls and the same endpoints, pointed at the other environment’s registry and credentials.
- Settle a disputed claimPull the exact request and callback for a correlation id months later, decrypted and readable, and replay it if the payer asks.
Download the NHCX Adapterv1.0.1 · released 30 Aug 2026
Selected build
macOS · arm64
Apple silicon, M1 and later
tar xzf nhcx-adapter_v1.0.1_<os>_<arch>.tar.gzcd nhcx-adapter_v1.0.1_<os>_<arch>./nhcx-adapter config edit # writes config.json./nhcx-adapter serve # checks, then listens./nhcx-adapter ledger follow # the traffic, live