When something breaks
Find the symptom you are seeing, not the error code. Each chapter here walks the checks in order, so you can start without knowing which code applies. They run in the order a message travels: your token, your address, delivery, encryption, the bundle, then the identifiers that tie a cycle together.
- Every NHCX call returns 401: every endpoint fails the same way, not one call.
- Your callback URL is rejected or never called: the endpoint update is refused, or nothing ever reaches your server.
- Accepted with 202, and no callback arrives: the exchange took your request and nothing followed.
- The recipient cannot decrypt your message: the answer is a
ProtocolResponsecarryingPAYR-1001. - The payer rejects your FHIR bundle: the answer names a bundle fault such as
PAYR-1004orPAYR-1008. - Responses arrive against the wrong request: answers land on the wrong case, or the exchange refuses a duplicate.
If you already hold an error code, Troubleshooting in the Reference is organised the other way, by layer and by code. Error Codes lists every code either side can send.
Next steps
- Troubleshooting: the five layers and the symptom table.
- Get your sandbox credentials: where to write, and what to put in the message.