Subscription via SMS

Customers can subscribe/unsubscribe to your services by sending an SMS to the Operator's Short Code.

Operator Short Codes

For Ooredoo Kuwait and STC Kuwait, shortcodes are configured per service.

Umobile and 9mobile do not support MO SMS.

Subscribe

The possible SMS formats for subscription are:

SUB <KEYWORD>

START <KEYWORD>

For STC Kuwait and Zain KSA send:

<KEYWORD>

A HTTP Notification is sent to the notification URL defined in your service and you should use this to create a subscription on your system so the user can access the service.

POST / HTTP/1.1
Host: <MERCHANT_NOTIFICATION_URL>
Content-Type: application/json

{
    "success":{
       "type":"subscription",
       "uuid": "c537bf6a-8603-466c-9eaa-bf6d3faed28c",
       "bill_id":"6ab07c272683N",
       "operator":"zain-kw",
       "merchant": "partner:02c76113-0ca7-4aed-88e2-75267bf85e82",
       "campaign": "campaign:940d351138df895e8dedf51e5d7b90788cdc23d0",
       "environment":"production",
       "msisdn":"96596619582",
       "currency":"KWD",
       "amount":"1.5",
       "mode":"MOSMS",
       "frequency":"monthly",
       "next_payment_timestamp": "2019-01-30T04:46:38.904Z",
       "transaction":{
          "status":"CHARGED",
          "bill_id":"c64ecf6c4176",
          "timestamp":"2016-07-08 04:40:15 +0000",
          "transaction_id":"6563403"
       }
    }
}

Unsubscribe

The possible SMS formats for unsubscribe are:

UNSUB <KEYWORD>

STOP <KEYWORD>

For Zain KSA use:

U<KEYWORD>

For STC Kuwait use:
STOP <KEYWORD>

For Telenor Myanmar use:
STOP SLA <keyword> to 75457

For Telenor Norway use:
STOPP <keyword> to 472313

For Vodafone Ireland use:
STOP <keyword> to 50082

A HTTP Notification is sent to the notification URL defined in your service and you should use this to disable access to your service for the msisdn.

📘

Info

Please note that your keywords are set up by you when you create the service and submit it for approval via the Alacrity Portal. Alacrity will also use the amount, frequency, and notification_url that was set up during the service creation. So please make sure that these values are correct for all of your services.

Please note that the trial_once parameter is set to true is for SMS based subscriptions.