This page will help you get started with obtaining an access token.
To facilitate API interactions, we begin by retrieving the identification details through this initial operation. This is intended for server-to-server communication, with clients expected to make this request from their own server-side
environments.
The User Creation and Token API requires a Bearer Client Access Token
Client Token
The requiredauthorization Bearer token is the client
access_tokengenerated on the Tokenization API usingclient_credentialsExpiration Time: X day(s)
HTTP Method: POST
URL: https://public-gateway.aws.stg.mondia.io/api/marketplace/auth/token
To gain access to the restricted resources and make authorized requests to our API, please proceed with acquiring an access token by completing the following steps.
1. Set the Request Details
- URL:
https://staging-gateway.mondiapay.com/v1/api/oauth/user
2. Add the Required Headers
| Header | Value |
|---|---|
Content-Type | application/json |
accept | application/json |
Authorization | Bearer Ca11a9191-6982-XXXX-XXXX-18914b1c30d8 |
3. Prepare the Request Body
- Using the following parameters, make a request against the
/api/oauth/userendpoint:identityValue: Provide the unique user value for the agreed user identity.identityType: Set this to the agreed user identity type.
access_token:Cxxxxxxxx-5cb2-4d2f-8bd0-e8463ff2a500.
| Request Body | Description | Required |
|---|---|---|
identityValue | A unique value for the corresponding identityType | Yes |
identityType | Choose from: MSISDN, EMAIL, OTHER | Yes |
| Response Body | Description |
|---|---|
access_token | A unique |
refresh_token | For the refresh_token grant type on the auth/token endpoint |
token_type | The type of token |
expires_in | Token expiry in seconds |
created | Token creation time and date |
Refresh Token
The User access token can be refreshed on the Tokenization API using "grant_type"
refresh_tokenalong with yourclient_id&
client_secretHTTP Method: POST
URL: https://public-gateway.aws.stg.mondia.io/api/marketplace/auth/token
