Установка и изменение номера телефона для 3DS¶

Чтобы клиент мог успешно проходить 3DS-аутентификацию для совершения покупок с карты, QIWI необходимо знать его актуальный номер телефона. На этот номер клиент получает SMS-сообщение с защитным кодом для подтверждения личности.

Для виртуальной или именной пластиковой карты номер телефона впервые устанавливается при создании заказа на выпуск карты — партнёр передаёт его в параметре personPhone.

Для неименной пластиковой карты номер телефона впервые устанавливается при активации — партнёр передаёт его в параметре personPhone.

Если номер изменился, партнёру необходимо сообщить об этом платформе — отправить запрос к Cards-lifecycle API. В запросе нужно передать актуальный номер и идентификатор карты, которой владеет клиент — cardTokenId. Идентификатор партнёр узнаёт при создании заказа на выпуск карты или получении информации о заказе.

Чтобы своевременно узнавать об изменении номера телефона, партнёр может:

• периодически запрашивать у клиента подтверждение его личных данных;
• самостоятельно отслеживать факт изменения номера — если это допустимо с точки зрения действующего законодательства.

Пример успешного сценария установки и изменения номера телефона изображён на диаграмме ниже.

sequenceDiagram
%%{init: {
    "sequence" : {
        "wrap":true,
        "messageFontSize":14,
        "noteFontSize":14,
        "actorMargin":112}}}%%
    participant P as Партнёр
    participant B as BaaS
      Note left of P: Клиент заказал карту в интерфейсе
      P->>+B: Сценарий «Выпуск виртуальной карты»/«Выпуск пластиковой карты»
      Note right of P: productId, clientId, accountId, personPhone
      B-->>-P: cardTokenId
      Note left of P: Номер телефона клиента (владельца карты) изменился
      P->>+B: Запрос на изменение номера телефона
      Note right of P: productId, cardTokenId, personPhone
      B-->>-P: Ответ на запрос изменения номера телефона
      Note left of B: personPhone

Запросы описаны в документации Cards-lifecycle API. Упомянутые на диаграмме сценарии см. в статьях:

• «Выпуск виртуальной карты»;
• «Выпуск пластиковой карты».