MIEWAP
Objetivo:
El objetivo principal del MIEWAP es permitir a nuestros socios vender suscripciones wap de la misma manera en todas las compañías usando sólo una API. MovilGate está a cargo de adaptarlo a las especificaciones de cada operador. 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: Una para los casos de éxito, y otra para los casos sin éxito. MovilGate ofrece al socio una URL universal para hacer solicitudes al MIEWAP.
Especificaciones de las URLs:
MIEWAP
La URL del MIEWAP tiene el siguiente formato *:
http://200.55.6.53/suswapglobal/__COUNTRY__/__IdPartner__/__SHORTNUMBER__/__IdTranExt__/ALTA/WAP/__KEYWORD__?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
- Keyword: Keyword del servicio en la plataforma de Movilgate. Provisto por MG.
- URLOK: Provisto por el socio.
- URLERROR: Provisto por el socio.
*NOTA: Todos los parámetros son obligatorios. El valor suswapglobal dentro de la URL es fijo, no es una variable.
Ejemplo:
http://200.55.6.53/suswapglobal/py/211/70370/refid010/ALTA/WAP/LOVE?url_ok=http://www.untoque.com/ok&url_error=http://www.untoque.com/error
URL_OK y URL_ERROR
El socio tiene que proporcionar a MovilGate dos URLs: Una para los casos de éxito, y otra para los casos sin éxito. Se puede utilizar la adición de sus propios parámetros.
Cuando termina la suscripción wap 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).
- idService: [Número] El identificador del servicio al cual fue suscripto el usuario.
- serviceName: [String] El nombre del servicio al cual fue suscripto el usuario.
Los posibles valores para el statusCode y el statusMessage son:
| statusCode | statusMessage |
|---|---|
| 0 | OK |
| 3 | El servicio requerido no existe o no se encuentra el Id |
| 4 | Acceso denegado. Usted no tiene permiso para acceder a este servicio |
| 8 | Error interno. Inténtalo de nuevo en unos minutos |
| 11 | Metadatos del socio válido |
| 17 | Canal incorrecto |
| 18 | Keyword inválida |
| 23 | Tipo no válido. Debe ser ALTA / BAJA |
| 24 | Servicio ya activo |
| 34 | El usuario no está utilizando la red del operador. MSISDN no detectado. |
| 35 | Suscripción no aceptada por el usuario. |
| 135 | El servicio requerido no existe |
| 218 | No Inhibition packages are available |
| 503 | Respuesta de la plataforma del operador no válido. |
Flujo de suscripción Wap
Cuando el usuario accede a LP del socio, puede ser redirigido inmediatamente a la URL del MIEWAP. Tenga en cuenta que en este paso no es necesario pedir el MSISDN porque MG lo detecta automáticamente usando headers HTTP enriquecidos. Si el MSISDN no se puede detectar MG redirigirá a url_error con statusCode = 34.
Si el socio recibe una solicitud a url_error, y un statusCode = 34 como parámetro adicional, la suscripción debe ser manejada como una suscripción Web normal. Si se detectó MSISDN, MG redirigirá a la página de confirmación del operador. A continuación, el usuario tiene que hacer clic en el botón Aceptar o Cancelar para confirmar, o rechazar, la suscripción.
Después de eso, el Operador redirige al usuario a MG y verifica si el usuario aceptó la suscripción. Si no lo hizo, será redirigido a url_error con un statusCode = 35 entre los parámetros. Si lo hizo, el servicio será activado en el Sistema de MG y el usuario será redirigido a URL_OK con un statusCode = 0 entre los parámetros.
NOTA: Cuando MG activa al usuario, se envía la notificación de ALTA MIE habitual. Recomendamos fuertemente esperar a la misma para hacer lo mismo de su lado.
