Phone number formatting
Learn about the utility tools provided by Sinch that help with correct phone number formatting.
The phone number should be specified according to the E.164 number formatting (http://en.wikipedia.org/wiki/E.164) recommendation and should be prefixed with a +
. For example, to verify the US phone number 415 555 0101, the phone number should be specified as +14155550101
. The +
is the required prefix and the US country code 1
prepended to the local subscriber number.
The Sinch SDK provides APIs for parsing and formatting phone numbers. The primary class for this functionality is SinchPhoneNumberUtils
. A key thing when parsing user input as a phone number is the concept of default region. If a user enters their number in a local format, the parsing must know which region / country to assume. Example:
// Get user's current country Iso by carrier info
let defaultCountryIso = SinchPhoneNumberUtils.defaultCountryIso
WARNING: Important
When passing a number as a String
to create a Verification
object, the string should contain a number in E.164 format.
A number that has been typed can be formatted as E.164 by using SinchPhoneNumberUtils.formatNumberToE164
method or e164Number
property of PhoneNumberUITextField
.