User Creation & Tokenization

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_token generated on the Tokenization API using client_credentials

Expiration 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

HeaderValue
Content-Typeapplication/json
acceptapplication/json
AuthorizationBearer Ca11a9191-6982-XXXX-XXXX-18914b1c30d8

3. Prepare the Request Body

  • Using the following parameters, make a request against the /api/oauth/user endpoint:
    • 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 BodyDescriptionRequired
identityValueA unique value for the corresponding identityTypeYes
identityTypeChoose from: MSISDN, EMAIL, OTHERYes

Response BodyDescription
access_tokenA unique
refresh_tokenFor the refresh_token grant type on the auth/token endpoint
token_typeThe type of token
expires_inToken expiry in seconds
createdToken creation time and date


📘

Refresh Token

The User access token can be refreshed on the Tokenization API using "grant_type" refresh_tokenalong with your client_id &
client_secret

HTTP Method: POST

URL: https://public-gateway.aws.stg.mondia.io/api/marketplace/auth/token



Language
URL
Click Try It! to start a request and see the response here!