Steps to get up and running (Type 3 integration)
In this integration, there wont be a saams ui like the previous types of integration. Regarding the partner application, you have to use spiintly partner website to create organisation, sites etc
- Make sure you have a Spintly account and Partner account created for you, if account is not created please contact our sales team(sales@spintly.com)
- The team will be giving you postman collection, sample mobile app and a backend clientid and clientSecret for backend apis, also the team will be providing the mobile clientid and mobile provider id for the sdk, and also will be giving a program to generate token (in go, python, nodejs), the team will be also be shipping access point to you
- Go to the partner website and create an organisation, sites(This you can do it or a Spintly support person can guide you through it)
- Next thing is to Create and access point via the website and configure it using the partner app (This you can do it or a Spintly support person can guide you through it)
- Using the clientid and client secret to generate a token
7) You can next call the Create accessor api, to create an accessor, make sure you specify the necessary permissions and also make sure in indentity Info section in provide field you provide the mobile provider id given in step 2, and sub should be userid which uniquely identifies the user in your system, once the accessor is created, a accessorid will returned in the reposne, this accessorid needs to be mappped to the userid in your system
8) Next you have to create the token using the program spintly has given in point 2(eventually once the poc is done, the creation of tokens the client has to handle in its backend), currently spintly has created its own private key for the client to generate the token.
Below is how a token is generated in nodejs, as you can the sub is same as the userid, mention in point 7
And once you decode the token, it looks like something like below
9) Next install the spintly sample app which was provided in point 2, once you install the sample app, make sure you insert the Mobile clientId, mobile provider id from point 2 and also token generated in point 10. Here region will be "in" if it is india or “us” if it is united states, env will be either stage1 or prod depending on the enviroment
10) Once the above details are put, click on login, once logged in you will see all the access points assigned to you, you can ciick on the access point shown in the ui or you can tap the phone on the reader
11) If you need the access history, u need to provide spintly with a url, and whenever an access is done, the access history will be forwarded to the the url