# Интеграция 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://knowledgebase.offer18.com/ru/set/integraciya/integraciya-otp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.