> For the complete documentation index, see [llms.txt](https://knowledgebase.offer18.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.offer18.com/ru/set/integraciya/integraciya-otp.md).

# Интеграция OTP

Поток предложения API OTP (одноразового пароля) — это метод серверной проверки, который обычно используется в кампаниях Mobile Value-Added Services (mVAS). Эти кампании предоставляют дополнительные услуги помимо базовых звонков и SMS, такие как развлечения, уведомления и сервисы передачи данных.

Использование проверки OTP помогает:

* Повысить качество лидов
* Снизить мошенничество
* Повысить общую надежность кампании

<figure><img src="/files/df948798ec5622aaaaa8453be5c8355989cf1736" alt=""><figcaption></figcaption></figure>

### Как работает OTP API

#### **Сгенерировать OTP**

* Когда пользователь отправляет свой номер мобильного телефона на лендинге, генерируется уникальный OTP с ограниченным сроком действия.
* OTP доставляется пользователю через API-вызов, и это действие записывается как **клик** в Offer18.

#### **Проверить OTP**

* Пользователь вводит OTP, полученный на своем мобильном устройстве.
* OTP проверяется через API-вызов, и это записывается как **конверсия** в Offer18.

\
Чтобы настроить интеграцию OTP, выполните следующие шаги:

1. Перейдите в раздел Integration **»** OTP Integration
2. В разделе **"Credentials"** задайте **"Name"** для интеграции
3. Добавьте **"OTP Send API URL" »** добавьте ключи и значения для конечной точки API
4. Добавьте **"OTP Verify API URL" »** добавьте ключи и значения для конечной точки API
5. Submit & Next

<figure><img src="/files/dcb7d5ce58d662e1a4d12d500e266cbdc338e147" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Для **"OTP Send API URL",** {msisdn} является обязательным значением.\
Для **"OTP Verify API URL",** обязательными являются оба значения: {msisdn} и {otp}.\
Если API рекламодателя требует каких-либо дополнительных обязательных параметров, добавьте их в соответствующие API-вызовы по мере необходимости.
{% endhint %}

### Сгенерируйте конечные точки OTP API для аффилиатов

1. После отправки настроек API перейдите в **"Affiliate API Endpoints".**
2. Добавьте **"Page Title"** для лендинга.&#x20;
3. Выберите Affiliate ID&#x20;
4. Нажмите **"Generate"** для конечных точек OTP API и скрипта лендинга

<figure><img src="/files/a64a02da87325f0fddb9c86857b443b57692c58a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Доступ к API должен быть включен для аффилиата.
{% endhint %}

### Ответ OTP API

```javascript
Сгенерировать OTP
{
  "status": "200",
  "response": "otp_sent_successfully",
}
```

```javascript
Проверить OTP
{
  "status": "200",
  "response": "otp_verified_successfully"
}
```

В случае неудачных ответов, пожалуйста, проверьте ответ API вашего рекламодателя.

***

### Скрипт лендинга OTP

Скачайте скрипт лендинга и передайте его вашему аффилиату, чтобы он мог интегрировать его в свое приложение или репозиторий. Если у него нет отдельного лендинга, он может использовать этот скрипт напрямую в рамках своей существующей настройки. Интеграция требует минимальной конфигурации.

Скрипт автоматически подставляет Affiliate ID, учетные данные API и другие необходимые параметры на основе выбранного affiliate id в конфигурации. Все транзакционные данные, такие как MSISDN и OTP, динамически подставляются во время выполнения в процессе OTP, обеспечивая бесшовную связь между лендингом и OTP API.

> Скрипт будет загружен в формате PHP.