Step 1
After the admin has approved your Digimart application, you can copy and save the 'API Key' and 'API Secret' allocated for your application. (See below to identify the place where these details are shown on your application)

If you have not created your Digimart application yet, please follow the tutorial for provisioning your Digimart application

Step 2
After you've got your application ready on Digimart, now you can prepare the subscription charging SDK request as instructed below.

Endpoint:

Sample format with MSISDN is as shown below.

Sample format without MSISDN is as shown below.

Step 3
Once you evoke this GET request after preparing it as above, you should be able to load the below page on a web view in your mobile/web application.

Note : If msisdn is inserted in the URL, above mentioned UI will be skipped, Leading directly to the OTP UI.

Step 4
End user of your application can now request for an OTP by entering and submitting the mobile number from this page.

Step 5
Once the OTP is submitted on the above page, end user on your application will be charged for the subscription through his Grameenphone mobile account and upon a successful charge below page will be shown.

Step 6
If there is any error during the transaction processing journey, below page will be shown to the end user on your application.

Step 7
After clicking the 'Back to Application' button, end user on your application will be redirected to the URL you have mentioned under the parameter 'redirectUrl' in the initial subscription charging SDK GET request.

Step 8
Once the end user on your application has clicked on 'Back to Application' button, you will receive the below as the response for the subscription charging SDK GET request.

Note: You must store the mapping between the masked msisdn (referred to as subscriberId in the response) and the request id. This mapping is crucial for identifying the subscriber in subsequent operations or communications

Step 9
Further to that, you will receive a notification to the endpoint you have configured under the 'Subscription Notification URL' section while you were creating the application on Digimart. Below is a sample JSON response you will receive on the endpoint you have configured.

{
  "timeStamp": "20240801044105",
  "subscriberId": "ZmQ5YmRmMDA5NzdlZTzM5NjJjNjRkNWNiMjkzOWYxMzk4MzI3ZjYyM2UwMmJmYzY3YzpncmFtZWVucGhvbmU\u003d",
  "subscriberRequestId": "123456789012100",
  "123456789012100": "APP_000186",
  "version": "2.0",
  "frequency": "daily",
  "status": "REGISTERED"
}

Note: From the subscription notification URL response, you can map the information based on the ‘masked msisdn‘ previously saved from the redirect URL response. This enables you to correlate the notification data with the correct subscriber identity securely and efficiently.

For the unsubscription, subscriber charging info and subscriber list APIs please visit the

API documentation

For any clarifications please do not hesitate to contact us