Fixed Deposits SDK integration guide

Reading time — 2 minutes

#Generate SDK token

This page has deprecated content, which is relevant only to integrations that have already been completed. If you are a new customer, head to this integration guide.

#Get SDK token

Call this API to obtain the the SDK accessToken and refreshToken which are used to initialize the SDK in Step 3. Use this API to onboard a new user or to generate tokens for a returning user.

The access token will be valid for 5 minutes. The refresh token will be valid for 10 minutes.

Here are two situations you might face with the SDK accessToken —

SDK accessToken expires while the user is booking the FD — In this case, the SDK automatically manages the accessToken and refreshToken by generating a new accessToken and refreshToken and no implementation is required from your side.
SDK accessToken expires before the SDK has been invoked — In this case, simply call the Get SDK token API to obtain a new accessToken and refreshToken.

Your request has been successfully processed.

Request

Provide the following details in the request —

Use the partner accessToken from the response of Get partner access token API as Bearer token for authorisation.
email of the user that will be used for user sign-in during the FD journey.
userId which is a unique identifier for the user on your database.
userName is the actual/full name of the user.

POST /auth/sdk/token 
 
"Authorization": "Bearer {partner_accessToken}" 
 
{ 
    "email": "ramesh@xyz.com", 
    "userId": "123e4567-e89b-12d3-a456-426614174000", //make sure you replace this 
    "userName": "Ramesh" 
} 

Response

You will get a SDK accessToken for usage in the SDK function.

{ 
    "accessToken": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJQMmNLU05oQ1dIbHRyVjExRldMMHE0M3dzN1FJOWN2cExhdU1pQ3pOZ09vIn0.eyJleHAiOjE2MzcyNDI4NjksImlhdCI6MTYzNzI0MjU2OSwianRpIjoiN2I4Y2NlOGQtOWI4ZC00NWFjLWE1NWQtZDBhMWM2MmVkMTMxIiwiaXNzIjoiaHR0cHM6Ly9hdXRoLWRldi5zZXR1LmNvL2F1dGgvcmVhbG1zL2ZkIiwiYXVkIjoiYWNjb3VudCIsInN1YiI6IjVlMGVlZGIwLWQyZDktNDg4My04ZmI0LTIxY2RjZjZiNzFmMCIsInR5cCI6IkJlYXJlciIsImF6cCI6InRlc3QiLCJzZXNzaW9uX3N0YXRlIjoiMDAwMjM0ODItNTBjOC00YzdjLWJkODgtNzllZTE5NzVhOTFhIiwiYWNyIjoiMSIsInJlYWxtX2FjY2VzcyI6eyJyb2xlcyI6WyJvZmZsaW5lX2FjY2VzcyIsInVtYV9hdXRob3JpemF0aW9uIl19LCJyZXNvdXJjZV9hY2Nlc3MiOnsiYWNjb3VudCI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsIm1hbmFnZS1hY2NvdW50LWxpbmtzIiwidmlldy1wcm9maWxlIl19fSwic2NvcGUiOiJwcm9maWxlIGVtYWlsIiwiZW1haWxfdmVyaWZpZWQiOmZhbHNlLCJjbGllbnRIb3N0IjoiMzUuMjQ0LjQ4LjcxIiwiY2xpZW50SWQiOiJ0ZXN0IiwiZ3JvdXBzIjpbIm9mZmxpbmVfYWNjZXNzIiwidW1hX2F1dGhvcml6YXRpb24iXSwicHJlZmVycmVkX3VzZXJuYW1lIjoic2VydmljZS1hY2NvdW50LXRlc3QiLCJjbGllbnRBZGRyZXNzIjoiMzUuMjQ0LjQ4LjcxIn0.RkbgE1K8JgoUewkbOTK19TKPma2hiTv-qcg2SW7CZEaeiroKljDByVeeWVNVmThPmm4ExnZvj6L8k4pRSUsbBqeYBaji6qhx6w0S5z7hDq-A6P4wBXTVf_k5m_yv3zARNdcASxNJMwjK0QuJG6T5-L44HCfxrQuvsOGp9sNCXs_VS1lemUesgdoz_8WIGkOSdfE1y_gD3GsDe8pxNpJhpJ_T9tjhMSVV_NeM72Q7mrmVyaC99wIHUuPRf36A5_x9Rwwg36Hhmwn9hsk2AyMn2eVK7jbWBBsfzMdDMm6DtvMxoNz_tOoYOdgmK8U4uVrnA9WajL4tvWQfwgghPvOLhg", 
    "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICIzNzA4NDk4Yy00ZmQxLTQyOWYtYmIwZC1kYTFmNDc2Y2RiYWIifQ.eyJleHAiOjE2MzcyNDQzNjksImlhdCI6MTYzNzI0MjU2OSwianRpIjoiNTAwYzMwYzQtNTQ1Zi00ZTIxLTk5ZmEtM2YxMzRjNTE2NTdhIiwiaXNzIjoiaHR0cHM6Ly9hdXRoLWRldi5zZXR1LmNvL2F1dGgvcmVhbG1zL2ZkIiwiYXVkIjoiaHR0cHM6Ly9hdXRoLWRldi5zZXR1LmNvL2F1dGgvcmVhbG1zL2ZkIiwic3ViIjoiNWUwZWVkYjAtZDJkOS00ODgzLThmYjQtMjFjZGNmNmI3MWYwIiwidHlwIjoiUmVmcmVzaCIsImF6cCI6InRlc3QiLCJzZXNzaW9uX3N0YXRlIjoiMDAwMjM0ODItNTBjOC00YzdjLWJkODgtNzllZTE5NzVhOTFhIiwic2NvcGUiOiJwcm9maWxlIGVtYWlsIn0.83IROYZes_jWs0ina7PexZ9xmYeh_FDRtBeGLqHPGU0" 
} 

—

–

#Generate SDK token

#Get SDK token

Request

Response