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)

Note: You will see the "Allow Capturing Mobile Number via Header Enrichment" toggle button enabled if the admin has approved your application to proceed with the Header Enrichment flow.

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 without MSISDN is as shown below.

Note: Despite the fact that you have sent the MSISDN or not, the MSISDN will be captured automatically through Header Enrichment.

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.

Step 4
Upon receiving the OTP on the mobile number, end user on your application can enter the received OTP in the below page.

Step 5
Once the OTP is submitted on the above page, end user on your application will be charged 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 can store the mapping between the masked msisdn (referred to as subscriberId in the response) and the request id.

Step 9
Further to that, you will receive a notification to the endpoint you have configured under the 'Async charging resp 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.

{
  "balanceDue": 0,
  "subscriberId": ": ZjUyMTM1MjlhYmU0ZmJmY2FkYjRkYWI3NzE2ZDg0MjE0NjNjYTM5MGFhZTczOWZlZDUxMTcxN2U3YTVlZTRiNmU=",
  "statusDetail": "Request was Successfully processed, Due amount fully paid.",
  "version": "2.0",
  "timeStamp": "20240703090835",
  "totalAmount": "50.95",
  "requestId": "123456789012346",
  "currency": "BDT",
  "applicationId": "APP_000040",
  "internalTrxId": "924070309080000043",
  "paidAmount": "50.95",
  "statusCode": "S1000",
}
    

Note: From the ‘Subscription Notification URL ‘response, you can map the information based on the ‘masked msisdn’ ( Example:- +1234*****901 ) previously saved from the redirect URL response. This enables you to correlate the notification data with the correct user 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