API OTP

La API OTP se puede utilizar para generar y validar PINs en campañas VAS, asegurando una autenticación de usuario segura y eficiente.

Parámetros comunes

Consulta	Tipo	Descripción
key	Cadena	Clave API
aid	Entero	Id de Afiliado
mid	Entero	Su MID de anunciante

Generar OTP

POST https://api.offer18.com/api/af/otp_gen

Parámetros de la solicitud

Cuerpo	Tipo	Descripción
type	cadena	Tipo de solicitud
userId	cadena	ID de usuario (bajo el Socio)
msisdn	cadena	Número móvil (numérico)
partner	cadena	Nombre del socio

https://api.offer18.com/api/af/otp_gen?key=000000000&aid=0000&mid=0000&msisdn=xxxxxxxx&partner=partnername&userId=xxxx

Éxito

{
  "status": "200",
  "response": "otp_sent",
  "data": "6xxxxx00f3fa55axxxxxxxxxx567a" // data[requestId] clave y valor que se devuelven cuando la API del socio responde en la respuesta 
} 

Fallo

{     
  "status": "400",     
  "error": "invalid_user_credentials" 
}

---

Verificar OTP

POST https://api.offer18.com/api/af/otp_verify

Parámetros de la solicitud

Cuerpo	Tipo	Descripción
userId	cadena	ID de usuario
msisdn	cadena	Número móvil
otp	cadena	OTP recibido por el usuario
partner	cadena	Nombre del socio
request_id	cadena	ID de solicitud para seguimiento

https://api.offer18.com/api/af/otp_verify?key=000000000&aid=0000&mid=0000&msisdn=xxxxxxxx&partner=partnername&userId=xxxx&request_id=xxxxx&otp=xxxxx

Ejemplo de respuesta de la API

Éxito

{     
  "status": "200",     
  "response": "otp_verified" 
} 

Fallo

{     
  "status": "400",     
  "error": "invalid_user_credentials" 
}

---

Para interacciones seguras, siempre llame a la API desde el lado del servidor.