Guide
Operator Policies
Common Policy

Landing page must have

1. MSISDN textbox

a. Should accept numbers only (don’t accept neither string nor special characters).
b. Accept MSISDN with or without country code.
c. Show error if they press “subscribe” without entering MSISDN.

2. Subscription button with title Subscribe

3. Disclaimer requirements

a. Service name.
b. Price and Frequency (daily, weekly, monthly or yearly).
c. Cancellation Short Code & Keyword.
d. Mention free start period (like one day for first subscription).
e. Should be in the PIN code page.

PIN code page requirements

1. “PIN code” textbox

a. Accept numbers only with 6 digits maximum.
b. Show error message if wrong PIN code entered.
c. Show error message if “Subscribe” button is pressed without entering the PIN code.

2. “Resend PIN code” button

a. (This will call “SendSubscriptionContractVerificationSMS” to resend the same PIN code).
b. Show error after 5 trials to try again later.

3. Subscribe button

4. Same disclaimer mentioned above

After subscription requirements

  1. Show a message to them with subscription result (either success or failed).
  2. Show message with error if subscription failed with the reason.
    a. Show (Not Enough credit) message for the initial payment model.
    b. Show (CorporateNotEligible) message for the initial payment model.
  3. Landing page redirect to service.
  4. Service enabled for them if subscription succeeded.
  5. First subscription should be a parking period with one day free start period, and the second one should be initial.
  6. Welcome SMS should be sent directly after PIN code verification containing the following (sample below):
    a. Price/Frequency
    b. Cancellation Short Code & Keyword
    c. How to access service (authentication way):
    i. Encrypted dedicated user short URL
    ii. Service URL with Username & password
    d. Service support email.

Additional validation and checks after subscription

1. Subscription Contract in tpay dashboard

a. “Is merchant notified” flag is checked in subscription contract.
b. Contract End date is more than contract start date by one year.
c. “Auto renewal” flag is checked.
d. Contract start date/time should be current date/time.
e. Customer can’t subscribe to two packages for the same service as daily and weekly.

2. Re-subscription using already subscribed MSISDN

a. Don’t redirect to service and show a resend button to send service access details via SMS.

Cancellation

“Unsubscribe” button should be present on the service page.

1. Cancellation using PIN code

a. Validate the MSISDN format (with/without country code) and empty value
b. “Resend PIN code” button exists, and after pressing it, a message appears to them that the cancelation PIN code has been sent again (should use the same API SendSubscriptionCancellationPinSMS).
c. Validate the wrong PIN and empty value with a message displayed to them
d. Message appears that the service has been canceled
e. Service is disabled after cancelation

2. Direct cancelation from portal

a. A confirmation message appears after pressing the “unsubscribe” button.
b. Subscription Contract Status becomes “Canceled” in the TPay dashboard after being canceled from the service portal.
c. Don’t allow one subscriber to cancel another subscriber’s subscription from the service portal.
d. A message appears that the service has been canceled
e. Service is disabled after cancelation

3. Cancel Contract from TPay dashboard & using MO

a. Confirm that “status change” push notification is sent to your system and the service is disabled for them.

Important notes:

  1. Language should be consistent throughout the entire flow on the landing page, welcome SMS, and service page.
    a. This means if they subscribed in Arabic, then all communication and service should be in Arabic.

Disclaimer sample:

English:

You will subscribe to [Service name] for [Price per Frequency]. To cancel your subscription, for [Operator Name] subscribers, please send [Keyword] to [short code], and for [Operator Name] subscribers, please send [Keyword] to [Short code]. To cancel from the site, please go to [URL] and click on [unsubscribe]. For any inquiries, please contact us at [Support email].

Arabic:

سوف تقوم بالاشتراك في خدمة [Service name] مقابل [price per frequency]. لإلغاء الاشتراك، لعملاء [operator name] أرسل [keyword] إلى [short code] ولعملاء [operator name] أرسل [keyword] إلى [short code]. لإلغاء الاشتراك من الموقع، قم بالدخول إلى [URL] واضغط على إلغاء الاشتراك. لأي استفسارات يرجى التواصل معنا على [Support email].

Welcome SMS sample:

English:

You have been subscribed to [Service name] for [Price per Frequency]. To use the service, go to [Service URL] and log in using [user name/password] or go to [Dedicated short URL]. To cancel your subscription, for [Operator Name] subscribers, please send [Keyword] to [short code], and for [Operator Name] subscribers, please send [Keyword] to [Short code]. To cancel from the site, please go to [URL] and click on [unsubscribe]. For any inquiries, please contact us at [Support email].

Arabic:

لقد قمت بالاشتراك في خدمة [Service name] مقابل [price per frequency]. لاستخدام الخدمة، اذهب إلى [Service URL] واستخدم اسم المستخدم وكلمة المرور [user name/password] أو اذهب إلى [Dedicated Short URL]. لإلغاء الاشتراك، لعملاء [operator name] أرسل [keyword] إلى [short code] ولعملاء [operator name] أرسل [keyword] إلى [short code]. لإلغاء الاشتراك من الموقع، قم بالدخول إلى [URL] واضغط على إلغاء الاشتراك. لأي استفسارات يرجى التواصل معنا على [Support email].