DSS /signaturerequest error with mock auth token

API Platform
,
1

Hi all, I’m trying to send a prescription to NHS Integration Environment using a mock auth access_token (https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation/testing-with-our-mock-authorisation-service-using-nhs-cis2---separate-authentication).

EPS $prepare API call is successful, but DSS /signaturerequest is failing with below error:

{
            "resourceType": "OperationOutcome",
            "issue": [
              {
                "severity": "error",
                "code": "unknown",
                "details": {
                  "coding": [
                    {
                      "system": "https://fhir.nhs.uk/R4/CodeSystem/Spine-ErrorOrWarningCode",
                      "version": "1",
                      "code": "UNKNOWN_ERROR",
                      "display": "An unknown error occurred processing this request. Contact us for assistance diagnosing this issue: https://digital.nhs.uk/developer/help-and-support. (Message ID: rrt-5733169623912723145-a-geu2-403804-82156213-1)"
                    }
                  ]
                }
              }
            ]
          }
        

Error has been observed at the following site(s):
	*__checkpoint ⇢ 500 from POST https://int.api.service.nhs.uk/signing-service/signaturerequest

Questions:

  1. What is this error is trying to say? how can I get the exact issue?
  2. Why is the DSS is returning an OperationOutcome response when the documentation says otherwise.
  3. Should I assume DSS sends OperationOutcome for 5xx errors and the one shown in the below screenshot for 4xx errors?

Screenshot 2025-10-23 170657
Screenshot 2025-10-23 170657855×432 10.5 KB

2

Hi Team,

It seems like the call back url is not working can you try with https://google.com

Kind Regards,

Vikas Nautiyal

3

Thanks for your response, Vikas. But I don’t understand what do you mean by ‘the callback url is not working’. I’m past that step and able to get a mock access_token. I’m even able to call the NHS Integration env $preapre API. But getting the above error in the next step (/signaturerequest).

Thanks

4

@ngorcl Can we connect on call, Can you share your email ID? I will be available to discuss this in detail tomorrow at 10:30 AM if it works for you.

5

Sounds good. Shared my email in a private chat message. Thanks

1 Like
6

Thanks a lot, Vikas, for getting into a call and help me with identifying the error. I highly appreciate your help

For anyone else interested, the issue is the missing signingServiceCallbackUrl which we have to request the NHS to add as a custom attribute as documented

1 Like