Skip to main content

Webhooks

Receive error report (callback)

Hosted by every participant. The exchange posts this message to the endpoint_url you registered, at /v1/error, with the headers and the sealed payload the sender posted. Answer HTTP 202 with the receipt first and process afterwards; [Receiving a callback](/docs/nhcx/v1/getting-started/receiving-a-callback) has the rules.

POSTv1_error

Where the exchange tells a sender that a request could not be delivered after five attempts. Received by every participant under its registered address. There is no outbound form.

Authorizations

Authorizationbearer tokenRequired

On every NHCX call, the token goes in a header called bearer_auth, with the word Bearer and a space in front. The sources are not unanimous: the authentication page and the FAQ both write the example as Authorization, and the notification endpoint uses Authorization. The safe course, and what the adapter does, is to send both headers with the same value.

Headers

bearer_authstringRequired

It is bearer_auth, not Authorization, on NHCX's own endpoints.

x-hcx-sender_codestringRequired

Your participant code. Mandatory on the envelope.

x-hcx-recipient_codestringRequired

The recipient's. For a provider, the processor code from the policy lookup. Mandatory on the envelope.

x-hcx-api_call_idstringRequired

Fresh on every message, including responses. Mandatory on the envelope.

x-hcx-correlation_idstringRequired

The thread. See the rule below. Mandatory on the envelope.

x-hcx-timestampstringRequired

See the format note below. Mandatory on the envelope.

x-hcx-statusstringRequired

Where this message stands. Values below. Mandatory on the envelope.

Body

typestring
x-hcx-sender_codestring
x-hcx-recipient_codestring
x-hcx-api_call_idstring
x-hcx-correlation_idstring
x-hcx-workflow_idstring
x-hcx-timestampstring
x-hcx-statusstring
x-hcx-error_detailsobject
x-hcx-error_details.codestring
x-hcx-error_details.messagestring
x-hcx-error_details.tracestring
x-hcx-entity-typestring

Responses

202

Received. The receipt names the message it answers; the answer itself follows as a call of your own.

Where this fits​

You produce this callback by calling Error report (callback).