API Reference
Log in to see full request history

This section of the document explains the redirection/web flow of subscriptions. To purchase a subscription, use this endpoint to initiate the purchase flow, this API can be accessed with Client Access Token obtained from the response of the Client Access Token API, if the endpoint is accessed with a client access token then at the end of the purchase flow the redirect URL includes a (query) parameter "?code=" which is an authorization code that can be used to obtain the User Access Token.

How to use:

  1. Fill in Authorization header: Bearer C1234abcde-1234-abcd-1234-abcd1234abcd (Replace with access_token that starts with letter C obtained from response of Client Access Token API request)
  2. Change the "redirect" and "subscriptionTypeID" in the body as per your specific configuration.
    1. (OPTIONAL) Add marketingCampaign details(conversionId, agency, medium...etc) to be relayed back in later notifications and stored in the subscriber's details.
  3. In the response received, click on the href link which should direct you to the Consent Gateway page that will authenticate your purchase request and
  4. Upon successful subscription there ill be a redirect, that redirect WILL include parameter "code=" with an Authorization Code and MIGHT include the parameter "uuid=" as this parameter is not available on all operators.
    1. Example Success Redirect URL:
      http://www.myserviceURL.com/thankyou.html?code=Adb74b752-141c-4657-a705-98644a7808b4&message=OK&uuid=81427818-a692-4c41-86a5-af93827f2646&status=200
    2. Example Insufficient Funds URL:
      http://www.myserviceURL.com/thankyou.html?code=Adb74b752-141c-4657-a705-98644a7808b4&error=INSUFFICIENT_FUNDS&uuid=81427818-a692-4c41-86a5-af93827f2646&status=402
    3. Example User Already Subscribed URL:
      http://www.myserviceURL.com/thankyou.html?code=Adb74b752-141c-4657-a705-98644a7808b4&error=USER_ALREADY_SUBSCRIBED&message=User+already+subscribed+to+service.&uuid=81427818-a692-4c41-86a5-af93827f2646&status=409

Purchase Link Validity period

The obtained href purchase link will be valid for single use only within 10 mins of its creation.

Authorization Code Validity period

The obtained Authorization Code will be valid for single use only!

Body Params
string
Defaults to http://www.mondia.com

The URL where user will be redirected to after transaction is complete.

string
Defaults to 12340004

Subscription type identifier (MondiaPay), Contact your assigned account manager to get this value.

marketingCampaign
object

Markering campaign information used for the acquisition.

Headers
string
Defaults to application/json

!DO NOT CHANGE OR REMOVE!

string
Defaults to application/json

!DO NOT CHANGE OR REMOVE!

string
Defaults to Bearer C1234abcde-1234-abcd-1234-abcd1234abcd

This field is mandatory and should follow the format: Bearer then single space then Client Access Token that starts with letter C (obtained from response of Client Access Token API.)

Responses

Language
Credentials
OAuth2
URL
Click Try It! to start a request and see the response here! Or choose an example:
application/json