UK

The subscription and purchasing flows for the UK are managed with Alacrity API calls different to other markets. Integration for the UK connects to Vodafone, O2, EE, and Three.

The SMS API is not supported so there is no requirement to send a welcome SMS.

Only Checkout flow is available.

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:ea552d72-xxxx-xxxx-9741-195989dae658&service=campaign:940d351138df895e8dedf51e5d7b90788cdc23d0&correlator=59999993&redirect_url=hhttp://test.test.com/redirect/fonix

📘

Info

Merchants should only need one landing screen for all UK operators as the service ID they add applies to all 4 of the services on Alacrity.

3 The response from checkout will be pending and include the msisdn such as:

http://test.test.com/redirect/fonix?transaction_id=XXXXX&status=pending&msisdn=965XXXXXX&correlator=jXXXX&auth_method=header_enrichment

4. Do not make a subscription create call as the checkout call makes a request to Vodafone UK, O2 and EE to create the subscription
5. A HTTP Notifications is sent to report the result of the subscription creation.

📘

Info

The operator hosts the msisdn entry, pin entry and subscription confirmation pages.

Sandbox testing is not supported

Http Notifications

Notifications follow the same format as other HTTP Notifications:

{
  "success": {
    "type": "subscription",
    "uuid": "175529b9-XXXX-4025-b748-XXXXXXXX",
    "bill_id": "XXXX123XXX",
    "operator": "voda-uk",
    "merchant": "partner:ccd9970c66f04e449aXXXXXXXXXXXXX",
    "campaign": "campaign:57617c7477ff3c282XXXXXXXXXXXXX",
    "environment": "production",
    "msisdn": "44XXXXXXXX",
    "currency": "GBP",
    "amount": "1.0",
    "mode": "API",
    "frequency": "monthly",
    "next_payment_timestamp": "2020-11-13T09:45:10.572Z",
    "transaction": {
      "status": "TRIAL"
    }
  }

The country codes are:

• Vodafone UK: voda-uk
• Three: three-uk
• O2: o2-uk
• EE: ee-uk