API Market documentation

Token

Overview

Car finance token API generates token for provided input data. Generated token then will be used to access other car finance APIs (Know your customer API etc.) The behavior of the API will varies in sandbox as compared to actual production environment.

Changes from the previous version

This is first version, no previous changes.

Sample flow

On the picture below you can see the sample token flow.

diag

Swagger Definition

The Access token API specification is also available in the swagger format. Swagger is the world’s largest framework of API developer tools for the OpenAPI Specification(OAS), more information about it can be found here.

Access Token– This will updated by OBD (Open banking Department)

Request URL Parameter

Sr.No.	Field Name	Type		Mandatory Information	Example
1	countryId	String	Mandatory	Country Id	SE
2	crmId	String	Mandatory	Identifier for CRM system consuming this service. Provided by Nordea Finance	262
3	languageId	String	Mandatory	Language Id in ISO 3166-1 standard	en
4	vendorId	String	Mandatory	Vendor company Id
5	billingAddressId	String	Mandatory	Unique Identifier for the dealer branch. Should be agreed with Nordea Finance	310
6	salesPersonId	String	Mandatory	Unique identifier identifying the salesperson	9102
7	channel	String	Mandatory	Channel through which Token is requested	CRM

Request Header Parameter

Sr.No.	Field Name	Type		Mandatory Information	Example
1	x-ibm-client-id	String	Mandatory	you will get it from developer portal.
2	x-ibm-client-secret	String	Mandatory	you will get it from developer portal.

Examples

Sample Success Response

{
    "token": "Bearer eyJhbGciOiJIUzUxMiJ9.eyJjcm1JZCI6IjI2MiIsInNhbGVQZXJzb25JZCI6IjEyMzQ1Njc4OTEwMiIsImxhbmd1YWdlSWQiOiJlbiIsImNoYW5uZWwiOiJDUk0iLCJ2ZW5kb3JJZCI6IjU1NjY4MzEzNjciLCJiaWxsaW5nQWRkcmVzc0lkIjoiMzEwIiwiZXhwIjoxNjgyNTc2Nzc4LCJpYXQiOjE2ODI1NzQ5NzgsImNvdW50cnlJZCI6IlNFIn0.bmIlm8uoHefPqjlnEN66uoGaLro6DnAt7fVAglU-AYzxr5Eqtx-qFPXywEIekoJH_b7NGYNkhJG61tphkZ2wxQ"
}

Sample Error Responses

{
   "httpCode": "401",
   "httpMessage": "Unauthorized",
   "moreInformation": "Invalid client id or secret."
}

{
    "errorCode": "500-INTERNAL_SERVER_ERROR",
    "errorMessage": "Error message:Invalid combination of input or you do not have access to the service.;"
}

Overview