Integración Portales de Descargas Externos
Método descarga
WapPush al cliente con el URL de descarga
Este método implica al proveedor del Portal externo a enviarle un WapPush al cliente.
Esta Url de descarga es responsabilidad del Portal Externo.
El cobro se debe realizar por medio del IdTran que se origino al solicitar el producto por un MO-SMS.
Monofónicos/Logos
Este método implica enviar el contenido al cliente vía SMS , es responsabilidad del Portal Externo el enviar el contenido.
El cobro se debe realizar por medio del IdTran que se origino al solicitar el producto.
Por navegación del sitio móvil del portal externo
En este caso el Portal Externo debe validar al cliente según lo indicado en el punto 3 de este documento.
Con esta validación el Portal Externo obtendrá un IdTran valido para realizar los cobros del cliente asociados a una sesión.
Cobro/Confirmación de las Descargas
URL Cobro Descarga
Esta url es de uso interno entre Movilgate y el Portal Externo. Su objetivo es realizar los cobros de las descargas.
http://200.55.6.53:12020/url_cobro_partner
POST:
| ig | id_producto desde sitio externo (string) no se puede repetir para un mismo IdTran en un lapso de tiempo predefinido (generalmente 48 horas) |
|---|---|
| tprod | código tasación (1;2;3;4;5;6;7;8;9;etc) (int) |
| 1. Polifónicos | |
| 2. Wallpapers | |
| 3. Screensavers | |
| 4. Truetones | |
| 5. SpeechTones/Fx | |
| 6. Video | |
| 7. App Java | |
| 8. Monofónicos | |
| 9. Logos | |
| 10. etc | |
| Pedir los códigos al área comercial si es que no están en esta lista | |
| url_download | no usado (string http |
| label | no usado (string |
| IdTran | Entregado en la generación del MO-SMS o Mediante la navegación WAP (ver punto 3) (int) |
Los IdTran se mantienen seis meses en la plataforma y pasado un tiempo pueden volver a uno el contador.
El resultado de esta transacción es el TicketId vía xml:
<?xml version="1.0">
<response>
<ticketid value="12345678"/ >
</response>
El resultado de esta transacción es el TicketId vía xml:
| Campos de la Respuesta al POST | Descripción |
|---|---|
| TicketId | Ticket Id para la identificación del cobro en el POST de notificación que realiza Movilgate. Este valor es un entero que se incrementa, pasado un tiempo es posible que este entero vuelva a uno el contador. |
URL Notificación de Cobro
Debe ser provista por el partner para ser usada para hacer un POST HTTP con el resultado de la tasación.
http://www.partners.com.ar/movistar/movilgate.php
POST:
El resultado de esta transacción es el estado del cobro via xml:
<?xml version="1.0">
<response>
<ticketid idtran="2992" value="12345678" status="BILLED" tran_status="6"/ >
</response>
- ticketid: ticket del GW Billing
- IdTran: Entregado en la generación del MO o en la Navegación con Proxy Reverso Wap/Wap2 (int)
- Value: Valor del TicketId (int)
- status: Estado de la transacción
- BILLED
- FAILED
- ERROR
- tran_status: Mapeo global a todos los carriers.
| Código | Mensaje |
|---|---|
| 1 | El contenido no esta disponible |
| 2 | Para descargar este contenido debe tener Activo el servicio de Mensajes de Texto |
| 3 | Servicio de Descarga de Contenidos Suspendido |
| 4 | Su linea no tiene saldo suficiente para descargar este contenido |
| 5 | Momentáneamente el servicio no esta disponible |
| 6 | Contenido autorizado |
| 7 | Por favor |
| X? | Siempre averigue si hay mas codigos asociados al protocolo para un carrier especifico |
Integración navegación del Portal externo mediante un Proxy Reverso Wap1.x/Wap2
Este caso es cuando no existe un WapPush asociado y se requiere capturar los números de teléfono/operador de los clientes y el IdTran navegando por el sitio de descargas.
En la siguiente figura se aprecia un esquema gráfico de los headers que agrega Movilgate con el fin de identificar el teléfono de y el operador del cliente, además de dar un IdTran para realizar los cobros de las transacciones.
Para capturar un IdTran y teléfono de un cliente, cuando el sitio del portal externo lo requiera, este debe invocar el siguiente url:
http://wap.untoque.com:8080/ruta_movilgate/cgi_del_sitio_del_portal_externo.php
o
http://200.55.6.53:8080/ruta_movilgate/cgi_del_sitio_del_portal_externo.php
Es importante tener claro cual url de la parte http se debe invocar, dependiendo del País/Operador Movilgate puede recibir los MSISDN desde el operador en distintos nombres, manteniéndose el puerto 8080.
En la transacción que estaría llegando al sitio del Portal Externo estarán presentes los headers asociados por Movilgate:
| X-Movilgate-MSISDN | Teléfono Cliente |
|---|---|
| X-Movilgate-Carrier | Carrier |
| X-Movilgate-TranId | TranId para cobrar |
Estos headers servirán, al igual, que en el caso del wappush, para cobrarle al cliente.
La url de movilgate /ruta_movilgate/ apunta al sitio del portal externo mediante un PROXY REVERSO, es decir algo como esto:
