Phone Number Formatting for SMS Authentication

RapidIdentity Platform Documentation

Solution
Application
Content Type
Technical Documentation
Utilities & Services
ft:locale
en-US

The SMS function assumes the mobile number is stored in the format areacode and follows these basic rules:

Numbers with + prefix
If the mobile number starts with a +, nothing will be added to it when dialing.
Numbers without + prefix
If the mobile number does not start with a +, the dialPrefix will be prepended to the number before dialing. The dialPrefix must be defined for anything to be prepended to the number.

The dial prefix must include a + followed by 0-4 digits. For the majority of users, this will include the country code. If the user's number does not match the country code of the dialPrefix, it should be stored with +[countrycode] areacode.

Character handling
All other non-numeric characters will be stripped per SMS requirements.

Examples:

Dial prefix: +1  
Stored mobile number: +1-(123)-456-7890
Sent to mobile number: +11234567890

Dial prefix: +1
Stored mobile number: (123)-456-7890
Sent to mobile number: +11234567890

Dial prefix: +1
Stored mobile number: +44-(123)-456-7890
Sent to mobile number: +441234567890

No Dial prefix
Stored mobile number: 1-(123)-456-7890
Error, not sent... missing '+'