# Подтверждение мобильного телефона и подписки на СМС
:::warning

 В инструкции описаны **примеры** POST-запросов. Интеграция с Mindbox не будет работать, если использовать запросы из примеров ниже без редактирования.

 Операции именно под вашу задачу создает и описывает в техническом задании менеджер проекта, если у вас нет такого документа, то обратитесь к вашему менеджеру.
:::

## Описание метода

Осуществляется с помощью POST-запроса. Название операции настраивается в системе Майндбокс. Подробней про вызов метода можно прочитать [здесь](https://developers.mindbox.ru/docs/v3).

```xml title="V3 API"
POST https://api.mindbox.ru/v3/operations/{синхронная/асинхронная операция}?endpointId={уникальный идентификатор сайта/мобильного приложения/и т.п.}&operation={название операции}&deviceUUID={уникальный идентификатор устройства}

Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey {Секретный ключ, обязательность уточнить у менеджера}

<operation>
  <customer>
    <ids>
      <webSiteUserId>{Идентификатор клиента}</webSiteUserId>
    </ids>			
  </customer>
  <smsConfirmation>
    <code>{Код подтверждения}</code>
  </smsConfirmation>
</operation>
```

## Пример операции

```xml title="XML"
POST https://api.mindbox.ru/v3/operations/sync?endpointId=MindboxRu&operation=ConfirmMobilePhone

Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey D061p764m85bklq

<operation>
  <customer>
    <ids>
      <webSiteUserId>42</webSiteUserId>
    </ids>			
  </customer>
  <smsConfirmation>
    <code>1234567</code>
  </smsConfirmation>
</operation>
```

## Ответ

```xml title="XML"
<result>
  <status>Success</status>
  <smsConfirmation>
    <processingStatus>{Статус подтверждения}</processingStatus>
  </smsConfirmation>
</result>
```

## Статус подтверждения

| Описание | Статус операции |
|----------|------------------|
| Мобильный телефон и подписка на СМС успешно подтверждены. | SubscriptionAndMobilePhoneConfirmed |
| Подписка на СМС успешно подтверждена.<p>Мобильный телефон уже подтвержден или не требует подтверждения. </p>| SubscriptionConfirmed |
| Мобильный телефон успешно подтвержден.<p>Подписка уже подтверждена, или не требует подтверждения. </p>| MobilePhoneConfirmed |
| Мобильный телефон уже подтвержден или не требует подтверждения.<p>>Подписка уже подтверждена, или не требует подтверждения. </p>| AlreadyConfirmed |
| Некорректный код подтверждения | IncorrectConfirmationCode |
| В случае, если не найден потребитель | NotFound |