Authentication service - Technical documentation
===
> **Product Name:** SDK Web ShareID - Authenticate
> **Version:** 1.0
> **Date:** 2022-12-22
#

**Retrieve the result of an authentication**

This is an addon on the current authentication flow. You may now use it also in this way to retrieve the result of an authentication.

*You can use the session opening in this way:*

POST https://{sandbox}.shareid.net/authorization/v1/auth_business/login
{
  "business_identifier": "my_business_identifier",
  "business_secret": "my_business_secret",
  "callback_url": "https://example.com/callback-response",
  "with_flow_id": true
}

You will notice the last parameter ***with_flow_id*** which will tell the api to track the authentication.
The service will reply the usual document, plus a new entry in the payload section containing the flow_id:

{
  "status": "success",
  "message": "Business logged in",
  "payload": {
    "access_token": "...",
    "expiresIn": 10,
    "flow_id": "de454b9f-4df8-4d47-b9c8-24578c3e199e"
  },
  "trace": "..."
}

You should keep this ***flow_id*** to be able to retrieve the result later.

Once the authentication is over, you may call this new api:

curl --location 
    'https://{sandbox}.shareid.net/v1/data/sdk/authentication_result/<FLOW_ID>' 
    --header 'Authorization: Bearer <TOKEN>'

The ***<FLOW_ID>*** parameter must be replaced by the one you got from the session opening.
The ***<TOKEN>*** parameter must be replaced by a valid token you have. This is also a token that you got from the session opening.

***
### Technical support and contact 💬

[[e-mail]](mailto:[e-mail])

* * *