STC Kuwait

STC Kuwait manage the subscription process the interaction with Alacrity API calls is different. Some users will be more familiar with the name Viva Kuwait.

Typical Flow

  1. User visits a landing page and selects to subscribe to a service
  2. Merchant uses the Checkout Flow such as
http://checkout.sla-alacrity.com/purchase?merchant=partner:4e3f654ed86dbb113bb472be07630b3cb6ad0859&
service=campaign:940d351138df895e8dedf51e5d7b90788cdc23d0&
correlator=123XYZ
&redirect_url=http://test.test.com/redirect/kwt/stc?transaction_id=XXXXXXXX
  1. The response from checkout will be pending and include the msisdn such as:
http://test.test.com/redirect/kwt/stc?transaction_id=XXXXX&status=pending&msisdn=965XXXXXX&correlator=jXXXX&auth_method=header_enrichment

You may need to display a warning to the user that there may be a delay until they can access the service until they receive confirmation from STC (or Viva).

  1. Do not make a subscription create call as the checkout call makes a request to STC Kuwait to create the subscription
  2. A HTTP Notifications is sent to report the result of the subscription creation.

You are not required to send a welcome SMS.

📘

Info

STC host the msisdn entry, pin entry and subscription confirmation pages.

Example notifications

{
   "success":{
      "type":"subscription",
      "uuid":"05e01521-feb0-432e-846b-xxxxx",
      "bill_id":"559c26dxxxx",
      "operator":"stc-kw",
      "merchant":"partner:xxxxx",
      "campaign":"campaign:xxxx",
      "environment":"production",
      "msisdn":"965xxxxxxx",
      "currency":"KWD",
      "amount":"0.7",
      "mode":"API",
      "frequency":"weekly",
      "transaction":{
         "status":"SUCCESS"
      }
   }
}
{
   "success":{
      "type":"subscription",
      "uuid":"05e01521-feb0-432e-846b-xxxx",
      "bill_id":"559c26d24a46",
      "operator":"stc-kw",
      "merchant":"partner:xxxxx",
      "campaign":"campaign:xxxxx",
      "environment":"production",
      "msisdn":"965xxxxxxxx",
      "currency":"KWD",
      "amount":"0.7",
      "mode":"API",
      "frequency":"weekly",
      "next_payment_timestamp":"2020-12-10T09:20:34Z",
      "transaction":{
         "status":"CHARGED",
         "bill_id":"559cxxxxx",
         "timestamp":"2020-12-03T09:20:34Z",
         "transaction_id":"9066xxxx"
      }
   }
}
{
   "success":{
      "type":"subscription",
      "uuid":"05e01521-feb0-432e-846b-xxxxx",
      "operator":"stc-kw",
      "merchant":"partner:xxxxx",
      "campaign":"campaign:xxxxx",
      "environment":"production",
      "msisdn":"965xxxxx",
      "currency":"KWD",
      "amount":"0.7",
      "mode":"OPCO_API",
      "frequency":"weekly",
      "transaction":{
         "status":"DELETED"
      }
   }
}

Existing subscribers will also be directed back to the landing page by STC Kuwait on a welcome SMS so merchants should provide direction for such users on their landing page.

Sandbox testing

For Sandbox testing the user interface to input a pin or msisdn is not shown. A response is provided with the msisdn and the pending state which you can use in testing. However, no notification is sent.