> 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/es/red/integracion/integracion-otp.md).

# Integración OTP

La API de oferta OTP (contraseña de un solo uso) es un método de verificación de servidor a servidor comúnmente utilizado en campañas de Servicios de Valor Agregado Móvil (mVAS). Estas campañas proporcionan servicios adicionales más allá de las llamadas y SMS básicos, como entretenimiento, alertas y servicios de datos.

El uso de la verificación OTP ayuda a:

* Mejorar la calidad de los leads
* Reducir el fraude
* Aumentar la fiabilidad general de la campaña

<figure><img src="/files/76178ac1c30aa0ead9e6e684ef3c8fc67eb3f0c5" alt=""><figcaption></figcaption></figure>

### Cómo funciona la API OTP

#### **Generar OTP**

* Cuando un usuario envía su número de móvil en una página de destino, se genera un OTP único con límite de tiempo.
* El OTP se entrega mediante una llamada API al usuario y esta acción se registra como un **clic** en Offer18.

#### **Verificar OTP**

* El usuario introduce el OTP recibido en su dispositivo móvil.
* El OTP se valida mediante una llamada API y esto se registra como una **conversión** en Offer18.

\
Para configurar la integración OTP, siga los pasos a continuación:

1. Vaya a Integración **»** Integración OTP
2. En **"Credenciales"** sección, defina **"Nombre"** para la integración
3. Añada el **"URL de la API de envío de OTP" »** añada claves y valores para el endpoint de la API
4. Añada **"URL de la API de verificación de OTP" »** añada claves y valores para el endpoint de la API
5. Enviar y siguiente

<figure><img src="/files/62f285b05bc80834bf007aeb95483da6d7c7d32f" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Para la **"URL de la API de envío de OTP",** {msisdn} es un valor obligatorio.\
Para la **"URL de la API de verificación de OTP",** tanto {msisdn} como {otp} son valores obligatorios.\
Si la API del anunciante requiere parámetros obligatorios adicionales, agréguelos a las llamadas de API respectivas según sea necesario.
{% endhint %}

### Generar endpoints de API OTP para los afiliados

1. Después de enviar la configuración de la API, continúe con **"Endpoints de la API de afiliados".**
2. Añada **"Título de la página"** para la página de destino.&#x20;
3. Seleccione el ID del afiliado&#x20;
4. Haga clic en **"Generar"** para los endpoints de la API OTP y el script de la página de destino

<figure><img src="/files/80ed5382af884b15dc90988a222a4f1d1e4544e5" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
El acceso a la API debe estar habilitado para el afiliado.
{% endhint %}

### Respuesta de la API OTP

```javascript
Generar OTP
{
  "status": "200",
  "response": "otp_sent_successfully",
}
```

```javascript
Verificar OTP
{
  "status": "200",
  "response": "otp_verified_successfully"
}
```

Para respuestas fallidas, revise la respuesta de la API de su anunciante.

***

### Script de la página de destino OTP

Descargue el script de la página de destino y compártalo con su afiliado para que pueda integrarlo en su aplicación o repositorio. Si no tienen una página de destino dedicada, pueden usar este script directamente como parte de su configuración existente. La integración requiere una configuración mínima.

El script inserta automáticamente el ID del afiliado, las credenciales de la API y otros parámetros requeridos según el ID del afiliado seleccionado en la configuración. Todos los datos transaccionales, como MSISDN y OTP, se rellenan dinámicamente en tiempo de ejecución durante el flujo OTP, garantizando una comunicación fluida entre la página de destino y las API OTP.

> El script se descargará en PHP.