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

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'

grant_type

string

required

Defaults to sandboxGrant

The grant type defined for your banking instance. Obtain from your sandbox credentials Supported values: 'password' ,'refresh_token'. password : used to fetch access token refresh_token : used to refresh the access token Pattern: '^(password|refresh_token)$' Example: sandboxGrant

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

content-type

const

enum

required

Defaults to application/x-www-form-urlencoded

Allowed:

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.