Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Route parameter name

Description

authenticationId

Location header value claimed after succesful [POST] /api/authentications request

partnerId

Desired NEXT PartnerId

3. [GET] /api/authentications/{partnerId}/{authenticationId} (GetAuthenticationAsync

...

)

It could be called anytime once an authentication is created. The best case for you your business to call this endpoint would be the place where you check verify whether the user authentication is complete or not. You can easily understand it by checking the success response property value. true means the signing worflow is completed successfully. (Step 9) (Step 9)

Route parameter name

Description

authenticationId

Location header value claimed after succesful [POST] /api/authentications request

partnerId

Desired NEXT PartnerId

...

Payload parameter name

Description

partnerId

Desired NEXT PartnerId

method

Signing method to use:

nbid, nbid-mobil Norwegian BankID / Mobile

sbid, sbid-mobil Swedish BankID / Mobile

content

Base64 encoded string content to be signed

contentType

application/pdf or text/plain

nationalId

National Id for user allowed to sign (social security number). Leave empty if any user can sign.

phone

Phone number for user allowed to sign. Leave empty if any user can sign.

callbackUrl

Your url that user will be redirected back to. (Step 8) TODO

SigningId value will be appended as a query string parameter with id name when Identity API calls you back.

customProperties

An optional <string, string> Dictionary that your custom properties are stored on the signing.

3. [GET] /api/signing/{partnerId}/{signingId} (GetSigningAsync)

It could be called anytime once a signing is created. The best case for your business to call this endpoint would be the place where you verify whether the user signing is complete or not. You can easily understand it by checking the success response property value. true means the signing worflow is completed successfully. (Step 9)

Note

Callbacks are executed from Identity API servers towards your URLs provided in [POST] /api/authentications request payload.

If the server behind your callbackUrl has a firewall protection, you should whitelist these outbound IPs below.

23.97.163.47, 23.97.163.156, 23.97.163.227, 23.97.163.3, 40.115.63.9, 40.115.63.88, 13.93.43.47, 40.115.63.31, 40.115.63.94, 20.238.219.90, 20.238.220.168, 20.238.221.115, 20.238.221.130, 20.238.222.82, 20.238.222.87, 13.69.68.26