Телефоны

Номер телефона — логин пользователя в reKassa. API принимает номер в любом привычном виде и приводит его к формату E.164: +, код страны и номер без пробелов и скобок — +998901234567. В этом формате номер хранится и возвращается во всех ответах.

Принимаемые форматы

Номер без кода страны считается узбекистанским.

Ввод	Результат
`+998901234567`	`+998901234567`
`+998 90 123 45 67`	`+998901234567`
`+998 (90) 123-45-67`	`+998901234567`
`998901234567`	`+998901234567`
`00998901234567`	`+998901234567`
`90 123 45 67`	`+998901234567`
`(90) 123-45-67`	`+998901234567`
`901234567`	`+998901234567`
`71 234 56 78`	`+998712345678`

Пробелы, дефисы и скобки игнорируются. Номер проверяется по длине и допустимым кодам для страны: мобильные и городские номера Узбекистана проходят одинаково.

Не принимаются

Ввод	Почему
`8 90 123 45 67`	префикс `8` не используется в номерах Узбекистана
`0901234567`	лишний `0` перед кодом оператора
`+998 99 123 45 6`	не хватает цифры
`12345`	не номер телефона

Невалидный номер даёт 400 validation_failed с указанием поля:

{
  "error": {
    "code": "validation_failed",
    "message": "Проверьте правильность заполнения полей",
    "details": {
      "errors": [{ "path": "phone", "message": "Invalid phone number" }]
    },
    "requestId": "b6a1f0c2-8d3e-4b7a-9c5f-2e1d0a9b8c7d"
  }
}

Рекомендации для клиентов

Показывайте в поле ввода префикс +998 и принимайте от пользователя 9 цифр номера.
Отправляйте номер как есть — нормализацию выполнит API. Для сравнения номеров на клиенте используйте значение phone из ответа API.
Один номер — один аккаунт: повторная регистрация подтверждённого номера даёт 409 phone_taken, в каком бы формате ни был введён номер.