Signing

The POST /v3/bankid-no/sign endpoint is used to sign a text using BankID (NO).

POST /v3/bankid-no/sign
Authorization: Basic ${ base64(accountId + ':' + secretKey) }

{
    "text": "Text to be signed",
    "refId": "12398698"
}

Parameter	Required	Description
text	Yes	Text that will be visible in the end user's BankID application during signing.
refId	No	Reference ID which will be included in a Collect and in the redirect.

Response:

IDkollen will respond with HTTP status 201 for successful request, or 4xx/5xx on errors. For more information about errors, please see the Errors section.

HTTP/2.0 201 Created

{
  "id": "1668b9da-bff1-4dfc-ad48-60507b5a8d12",
  "refId": "12398698",
  "status": "PENDING",
  "url": "https://..."
}

Property	Description
id	Authentication id, used to cancel or get the status of this authentication request.
refId	The refId given in the request, if any.
url	The URL where the end user can sign.

Code redirect:

Once the end user has signed, they will be redirected to the redirect URL provided to IDkollen by you, including the very same "id" as a request parameter that can be used in the Collect step. If the parameter "refId" was used in the request, it will also be included as a request parameter.

https://your.redirect.url/?id=1668b9da-bff1-4dfc-ad48-60507b5a8d12&refId=12398698