Subscription via SMS

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

Operator Short Codes

CodeOperator
1090Etisalat UAE
TBCSTC Kuwait define one code per service
472313Telenor Norway
50082Vodafone Ireland
93052Zain Kuwait
97970Zain Jordan
94005Zain Bahrain
4064/4065Zain Iraq
700116Zain KSA

For Ooredoo Kuwait and STC Kuwait short codes are configured per service.

Umobile does 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.