Reconocimiento de encabezados enriquecidos
Objetivo:
El objetivo principal de PROXYWAP es permitir a nuestros socios recibir el MSISDN y Carrier utilizando sólo una API para todas las compañías / países. Esta solución funciona como un proxy entre nuestro socio y el Operador utilizando redirección HTTP y añadiendo parámetros adicionales para informar el resultado de la operación. El socio tiene que proporcionar a MovilGate dos URLs: Uno en los casos de éxito, y otro para los casos sin éxito. MovilGate ofrece al socio una URL universal para hacer peticiones a PROXYWAP.
Especificaciones de las URLs:
PROXYWAP
http://200.55.6.53/proxywapglobal/__COUNTRY__/__IdPartner__/__SHORTNUMBER__/__IdTranExt__/DETECT/WAP/?url_ok=__URLOK__&url_error=__URLERROR__
Donde:
- COUNTRY: 2 letras que representan el código de país.
- IdPartner: Id de socio en la plataforma de Movilgate. Provisto por MG.
- SHORTNUMBER: Número corto correspondiente al servicio. Provisto por MG
- IdTranExt: Identificador numérico del Integrador externo
- URLOK: Provisto por el socio.
- URLERROR: Provisto por el socio.
NOTA: Todos los parámetros son obligatorios. Los valores proxywapglobal, DETECT, WAP dentro de la URL son fijos, no son variables.
Los posibles valores para el statusCode y el statusMessage son:
| statusCode | statusMessage |
|---|---|
| 0 | OK |
| 8 | Error interno. Inténtalo de nuevo en unos minutos |
| 11 | Metadatos del socio válido |
| 17 | Canal incorrecto |
| 34 | El usuario no está utilizando la red del operador. MSISDN no detectado. |
| 503 | Respuesta de la plataforma del operador no válido. |
Ejemplo:
http://200.55.6.53/proxywapglobal/py/211/70370/refid010/DETECT/WAP/?url_ok=http://www.untoque.com/ok&url_error=http://www.untoque.com/error
El socio tiene que proporcionar a MovilGate dos URLs: Una para los casos de éxito, y otra para los casos sin éxito. Se pueden agregar parámetros propios a las mismas.
Si el usuario es detectado MovilGate añade los siguientes parámetros adicionales al redirigir a URL_OK o URL_ERROR:
- IdRef: [Número] Número de transacción creado para esta solicitud.
- IdTranExt: [Número] El identificador numérico de la transacción provisto por el socio.
- statusCode: [Número] El código de estado de retorno.
- statusMessage: [String] El texto asociado con el estado de retorno.
- msisdn: [Número] El número de teléfono del usuario.
userdomain: [String] <Número corto>.<Carrier>.<País> (ej: 1234.cti.ar).
Ejemplos:
- MSISDN detectado: http://www.untoque.com/ok?IdRef=35&IdTranExt=jdl123&statusCode=0&statusMessage=Ok&msisdn=541124776716&userdomain=70370.smsc1.personal.ar
- MSISDN no detectado: http://www.untoque.com/error?IdRef=34&IdTranExt=jdl123&statusCode=34&statusMessage=User%20is%20not%20using%20operator%20network.%20MSISDN%20not%20detected
Flujo de reconocimiento de encabezados
Cuando el usuario accede al Portal o URL del socio, él / ella puede ser inmediatamente redirigido a la URL PROXYWAP. Tenga en cuenta que en este paso no es necesario pedir el MSISDN porque MG lo detecta automáticamente usando el enriquecimiento de cabecera. Si el MSISDN no se puede detectar MG redirigirá a url_error con statuscode = 34.
Si el socio recibe una solicitud para url_error, y un statuscode = 34 como parámetro adicional, el socio debe proporcionar un método diferente al usuario para validar su indentidad, tal como validación de inicio de sesión. Si se detectó el MSISDN, MG redirigirá a la url_ok del socio con un código de estado = 0, donde el socio puede conceder acceso directo al usuario si es un usuario válido.
Flujo
