LiveID

• Introduction to Assently LiveID
  • How does it work?
  • Languages
• The LiveID integration guide
  • API docs
    • Headers
  • Endpoints
    • Identify a customer
      • /liveid/start
      • /liveid/swedishbankid (legacy)
    • Get the status of an on-going authentication
      • /liveid/status
• Supported eID Providers

Introduction to Assently LiveID

Assently LiveID allows your users to securely indentify themselves using electronic identification (eID), with Assently CoreID as it’s foundation allowing you to give the best experience possible to your customers without any of the hassle.

There are two ways of using LiveID, either via the GUI through app.assently.com or by integration to make it part of your existing system.

Contact us at info@assently.com to get started.

How does it work?

LiveID securely communicates with our servers which handle the integrations with the different eID Providers. Check out our quick start guide to see how to get started with LiveID via API.

Languages

The supported languages are the following languages:

• English
• Finnish
• Norwegian
• Danish
• Swedish

The LiveID integration guide

Received your account secrets and ready to go? Below you can find the urls for both test and production.

<!-- TEST -->
https://test.assently.com/

<!-- PRODUCTION -->
https://app.assently.com/

API docs

Examples of requests and respones along with parameter descriptions can be found at: https://app.assently.com/api#LiveID

Headers

All of the requests made regarding LiveID should include the header(s) listed below:

• Content-Type: application/json

Endpoints

Identify a customer

/liveid/start

Starts an authentication attempt where the customer can recieve an authentication link in three different ways. You can use one or multiple ways of getting the authentication link to the customer at once, those ways are:

• SMS - Customer recieves an sms with the authentication link.
• Email - Customer recieves an email with the authentication link.
• PartyUrl - We always return the url to you in the response here for you to share with your customer in what ever way fits your way of working best.

/liveid/swedishbankid (legacy)

Starts a swedish bankid authentiation attempt. Allowing the customer to directly open their bankid app and verify their identity. Swedish bankid is also available via /liveid/start.

Get the status of an on-going authentication

/liveid/status

Retrieves the authentication status of an on-going authentication. If the authentication has timed out (10 minutes) there will be no information available here, but the result of the authentication can still be seen in the liveid log at https://app.assently.com/a/liveid2/log.

Supported eID Providers