> 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="https://1880954721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F41f2EboJipeUA6flsLGK%2Fuploads%2F8ACNtCRYGHhg9wDNITdr%2Fimage.png?alt=media&amp;token=fa8eb5d5-f8f3-4019-93a3-a5e18fc1f5a6" 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="https://1880954721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F41f2EboJipeUA6flsLGK%2Fuploads%2FDuDZ0jVTXqZOTeqWGKXJ%2Fimage.png?alt=media&amp;token=91c163ca-f675-4c0a-a665-f5e570d8754f" 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="https://1880954721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F41f2EboJipeUA6flsLGK%2Fuploads%2FeS2z2kgKirDCCXSyxyrl%2Fimage.png?alt=media&amp;token=341d091c-bf95-451c-b0e0-9d76aa442e04" 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.