MSISDN Retrieval

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 the customer to:{redirect_url}&uri={uri}&transaction_id={transaction_id}


redirect_urlYour URL that we redirect the end customer back to after msisdn detection.stringmandatory
URIThe Alacrity merchant URI that identifies which merchant this transaction belongs to.stringmandatory
transaction_idA unique transaction ID generated by you.integermandatory

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


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



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


Possible Errors

MSISDN Retrieval

Retrieve MSISDN for specific transaction


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

Request Parameters

transaction_idA unique identifier to the current transaction. This value will be used to retrieve the MSISDN. This is the transaction id used in the re-direct call above.stringmandatory
URIThe Alacrity merchant URI that identifies which merchant this transaction belongs to.stringmandatory
GET /authenticate/msisdn?transaction_id=19235&
uri=partner:1b0a715f-27c5-46c2-9e97-00748dca334f HTTP/1.1
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json

      "msisdn": "353867676767"
HTTP/1.1 410 Gone



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



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.