Skip to main content
This onboarding and monetization flow requires that the Merchant-managed subscriptions integrate with the MarketONE OpenAPIs. This integration has multiple steps. The following image provides a generic example of this integration in action at a high level. Merchant-Managed Subscriptions Integration Flow For more details on the integration, see the Merchant-Managed Use Cases.

1. Validating the User Account

The user selects statement billing (for example: DCB) on their Merchant service. They then enter their mobile number for account validation. The Merchant sends the POST /partnerSubscription call with the user’s mobile number as account identifier, partner code (optional) and product code (optional). MarketONE requests the validation of the user account from the Reseller by invoking the POST /account/validate API call. Once the validation is finished, the Reseller notifies MarketONE with the results. In turn, MarketONE sends the results to the Merchant.

2. Validating the PIN

Once the user account is validated, MarketONE generates a one-time PIN for the user. MarketONE then asks the Reseller (SP) to send the one-time PIN to the user by invoking the POST /notification API call. The user receives the PIN from the Reseller (SP) notification system. The user enters the one-time PIN on the Merchant application, and is validated by MarketONE by invoking the POST /partnerSubscription/{id}/validate API call. The user can confirm they agree to pay with their bill. This is a step that can optionally be removed through configuration. Generating the One-Time User PIN

3. Posting the Charge

The Merchant leverages the POST /transaction API call to send the charge. MarketONE leverages the POST /transaction API call to send the transaction to the Reseller (SP) for statement billing (for example: DCB). Sending the Transaction for Posting

4. Canceling a Subscription

In the case of a subscription cancellation, the Merchant is required to call the cancellation API for MarketONE to cancel the active subscription billing entitlement. MarketONE will inform the Reseller the customer no longer has the Partner subscription and the ability to charge for the product on their statement bill. Canceling a Subscription Parent topic:Step 1: Discovery and Education