Alacrity provides a method for you to retrieve the customer's MSISDN via header enrichment (if it is available). Permission to use MSISDN Retrieval via HE (Header Enrichment) needs to be provided by the operator.

This is a two step process:

1. Redirect the user to Alacrity where we will attempt to obtain the MSISDN.
2. Retrieve the MSISDN via the API.

Redirect

Request

Redirect the customer to:

http://msisdn.sla-alacrity.com/redirect?redirect_url={redirect_url}&uri={uri}&transaction_id={transaction_id}

Parameters

If any of the above parameters are missing you will receive a 400 Bad Request

Success

If the MSISDN is successfully detected and saved you will receive the following via redirect:

http://your-redirect-url?status=success&transaction_id={transaction_id}

Errors

Other errors will be returned to your redirect URL and will have the following format:

http://your-redirect-url/?status=error&transaction_id={transaction_id}&message={reason_for_the_error}

Possible Errors

MSISDN Retrieval

Retrieve MSISDN for specific transaction

Request

GET /authenticate/msisdn?transaction_id={ID}&uri={URI}

Request Parameters

GET /authenticate/msisdn?transaction_id=19235&
uri=partner:1b0a715f-27c5-46c2-9e97-00748dca334f HTTP/1.1
Host: msisdn.sla-alacrity.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Accept: application/json

HTTP/1.1 200 OK
Content-Type: application/json

{
   "msisdn_protection":{
      "msisdn": "353867676767"
   }
}

HTTP/1.1 410 Gone

🚧

Warning

Each combination of transaction ID / MSISDN will only be retrievable once.

📘

Info

Please note that a customer's MSISDN is encrypted in SLA Digital’s database and is only decrypted when requested by the Merchant.

Please note that for certain Operators Merchants will receive either a MSISDN or an ACR.

For Telenor Operators (Digi, Myanmar) the Merchant will receive an ACR. For each time the Merchant tries to retrieve a MSISDN for the same user they will get a new ACR. You can identify that those ACRs belong to a single user by validating the first 30 characters of the ACR.