Request Access Token

post

https://api.cloud.mbanq.com/oauth/token

Please refer to the link : Authentication on the detailed about authorization.

The initial step in utilizing the APIs involves obtaining this access token. Upon a successful request, the response will furnish the access token along with a refresh token and supplementary details regarding the authorization. Additionally, the response will contain a parameter labeled 'expires_in,' denoting the duration until the token's expiration, necessitating a refresh.

The requisite credentials such as username, password, client_id, and client_secret can be retrieved from the sandbox environment for authentication purposes.

Form Data

Use grant_type=password to obtain an access token with user credentials.

grant_type

const

enum

required

Defaults to password

The grant type for this request. Use password to fetch an access token using user credentials.

Allowed:

username

string

required

Defaults to sandboxUsername

The user name defined for your banking instance. Obtain from your sandbox credentials
Pattern: '^.*$'
Example: 'sandboxUsername'

password

string

required

Defaults to sandboxPassword

The Password defined for your banking instance.Obtain from your sandbox credentials
Pattern: '^.*$'
Example: 'sandboxPassword'

client_id

string

required

Defaults to api

The identifier for the registered application of your banking
instance. For this preview release, the default value is: api.
In our official release, you will be able to set this uniquely
for each application.
Pattern: '^.*$'
Example: api

client_secret

string

required

Defaults to secret

The client_secret is a secret known only to the application and
the authorization server. For this preview release, the
default value is secret. In our official release, you will be
able to set this uniquely for each application.
Pattern: '^.*$'
Example: secret

Headers

tenantId

string

required

Defaults to z01j3e71zd6zkq908vyf5861a8

The ID of your banking instance visible in the MBANQ Console.

X-Forwarded-For

string

required

Defaults to 222.12.211.12

The IP address is a unique number assigned to the device used for account opening. It helps identify the device's location on the network and track account activity.

X-Device-Fingerprint

string

required

Defaults to 09BD47A5-9380-40E3-AFF8-592D5E433

A device Id or browser fingerprint is a unique identifier created by analyzing a user's browser and device settings. It generates a distinctive string that helps identify the specific browser or device.

Responses

200Token is obtained successfully.

400The request fails if the tenant Id is missing or incorrect.