Debido al decremento de comisiones por parte de Movistar los paquetes Movistar tienen un costo adiconal del 5% por recarga.

Descripción

La presente página tiene como finalidad proporcionar la información necesaria para la correcta implementación y conexión entre el WebService del portal con el desarrollo de un cliente consumidor para la correcta operación de Recargas electrónicas y consulta de Saldos. De ésta forma todas las consultas provenientes de la cuenta del cliente del portal son total responsabilidad del cliente y del sistema desde donde se realizan las peticiones.

Consideraciones Generales

Todas las peticiones que reciban una respuesta exitosa por parte del WebService generarán un costo para el cliente consumidor.

Bajo ninguna circunstancia se podrá solicitar el reembolso de recargas realizadas exitosas desde la cuenta del cliente consumidor.

El tiempo máximo de respuesta por parte del WebService será de 90 Segundos para realizar una recarga electrónica de tiempo aire.

Cada cliente consumidor es responsable de sus claves de acceso al WebService proporcionadas por el portal.

Manual del Webservice:


https://www.ventatelcel.com/ws/index.php?wsdl

El servicio contiene 3 funciones que son:

  • ObtenSaldo
  • RecargaEWS
  • Paquetes (ver manual de Webservice de Paquetes)
  • ProductosPDV

Para realizar pruebas puedes usar nuestro usuario demo:

Usuario demo123456
Passwd Demo123456

ObtenSaldo(string).

La función recibe un valor de tipo String: Dicho String corresponde a la cadena XML que será enviada al servidor del portal para su procesamiento. Ésta función regresará un valor de tipo String como respuesta correspondiente a una cadena XML. Estructura de cadena de envío para obtener el saldo del usuario:

Estructura de cadena de respuesta POSITIVA para obtener el saldo del cliente consumidor:

Estructura de cadena de respuesta de ERROR para obtener el saldo del cliente consumidor:

RecargaEWS(string).

La función recibe un valor de tipo String: Dicho String corresponde a la cadena XML que será enviada al servidor del portal para su procesamiento. Ésta función regresará un valor de tipo String como respuesta correspondiente a una cadena XML.

Estructura de cadena de envío para obtener una recarga electrónica del cliente consumidor:

VARIABLE TIPO
Usuario String proporcionado con el nombre de usuario de acceso al Portal.
Passwd String proporcionado correspondiente a la contraseña de acceso.
Telefono String de 10 caracteres del número telefónico al que se realizará la recarga.
Carrier Compañía (Telcel, Movistar, Unefon, Iusacell (para AT&T también mandar como Iusacell), Nextel, Virgin, Cierto, Maztiempo, Alo).
Monto Cantidad a recargar al número telefónico.

Estructura de cadena de respuesta POSITIVA para obtener una recarga electrónica de tiempo aire:

VARIABLE TIPO
Folio Número Entero de hasta 15 dígitos comprobante de folio de recarga.
Cantidad Número Entero de la cantidad abonada al número telefónico.
Telefono Número telefónico al que se realizó la recarga.
Carrier Compañía de Telefonía a la que pertenece el número telefónico.

Estructura de cadena de respuesta de ERROR para obtener una recarga electrónica de tiempo aire:

VerificaRecarga(string).

La función VerificaRecarga se utiliza para verificar una recarga que por problema de timeout o error desconocido no se conozca el status.

La verificación de la recarga se debe realizar en caso de no haber recibido respuesta después de 90 segs (máximo a 100segs).
Si la recarga es exitosa la función devolverá el número de autorización, en caso contrario devolverá el tag de ERROR.

Ésta función regresará un valor de tipo String como respuesta correspondiente a una cadena XML .

Estructura de cadena de envío para verificar una recarga electrónica del cliente:

VARIABLE TIPO
Usuario String proporcionado con el nombre de usuario de acceso al Portal.
Passwd String proporcionado correspondiente a la contraseña de acceso.
Telefono String de 10 caracteres del número telefónico al que se realizó la recarga.
Carrier String del nombre del carrier al cual se hizo la recarga.
Fecha Fecha en formato AAAA-MM-DD de la fecha en que se desea consultar una recarga.
Monto Cantidad entera del monto de la recarga a consultar.

Estructura de cadena de respuesta POSITIVA para una recarga electrónica realizada:

VARIABLE TIPO
Exito Número de folio/autorización de la recarga consultada.

Estructura de cadena de respuesta de ERROR para obtener una recarga electrónica no realizada:

ProductosPDV(string).

La función recibe un valor de tipo String: Dicho String corresponde a la cadena XML que será enviada al servidor del portal para su procesamiento. Ésta función regresará un valor de tipo String como respuesta correspondiente a una cadena XML. Estructura de cadena de envío para obtener los productos disponibles:

<Recarga><Usuario>demo123456</Usuario><Passwd>Demo123456</Passwd><Catalogo>0</Catalogo></Recarga>
VARIABLE TIPO
Usuario String proporcionado con el nombre de usuario de acceso al Portal.
Passwd String proporcionado correspondiente a la contraseña de acceso.
Catalogo
  • 0 para obtener Recargas y paquetes disponibles.
  • 2 para obtener únicamente los paquetes disponibles.

Estructura de cadena de respuesta POSITIVA para obtener los productos disponibles:

<Resultado><Servicio>TELCEL SIN LIMITE<Producto><Nombre>SIN LIMITE 20 - 60MB 200MB WHATS 1d</Nombre><Montos>20006</Montos></Producto><Producto><Nombre>SIN LIMITE 30 - 80MB 300MB WHATS 3d</Nombre><Montos>30006</Montos></Producto><Producto><Nombre>SIN LIMITE 50 - 300MB 500MB WHATS-REDES 7d</Nombre><Montos>50006</Montos></Producto><Producto><Nombre>SIN LIMITE 80 - 400MB 1000MB REDES SOC 13d</Nombre><Montos>80006</Montos></Producto><Producto><Nombre>SIN LIMITE 100 - 800MB WHATS 17d</Nombre><Montos>100006</Montos></Producto><Producto><Nombre>SIN LIMITE 150 - 1000MB REDSOC ILIM 28d</Nombre><Montos>150006</Montos></Producto><Producto><Nombre>SIN LIMITE 200 - 1500MB REDES SOC ILIM 30d</Nombre><Montos>200006</Montos></Producto><Producto><Nombre>SIN LIMITE 300 - 2500MB y REDES SOC ILIMITADAS 33d</Nombre><Montos>300006</Montos></Producto><Producto><Nombre>SIN LIMITE 500 - 5000MB y REDES SOC ILIMITADAS 33d</Nombre><Montos>500006</Montos></Producto></Servicio><Servicio>TELCEL INTERNET AMIGO<Producto><Nombre>AMIGO 20 - 80MB y 200MB WHATS 1d</Nombre><Montos>20005</Montos></Producto><Producto><Nombre>AMIGO 30 - 120MB y 300MB WHATS 3d</Nombre><Montos>30005</Montos></Producto><Producto><Nombre>AMIGO 50 - 400MB y 500MB WHATS 7d</Nombre><Montos>50005</Montos></Producto><Producto><Nombre>AMIGO 100 - 1000MB y redes ilimitado 17d</Nombre><Montos>100005</Montos></Producto><Producto><Nombre>AMIGO 150 - 1500MB y redes ilimitado 28d</Nombre><Montos>150005</Montos></Producto><Producto><Nombre>AMIGO 200 - 2000MB y redes ilimitado 30d</Nombre><Montos>200005</Montos></Producto><Producto><Nombre>AMIGO 300 - 3500MB y redes ilimitado 33d</Nombre><Montos>300005</Montos></Producto><Producto><Nombre>AMIGO 500 - 6500MB y redes ilimitado 33d</Nombre><Montos>500005</Montos></Producto></Servicio><Servicio>TELCEL<Producto><Nombre>RECARGA 10</Nombre><Montos>10</Montos></Producto><Producto><Nombre>RECARGA 20</Nombre><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 80</Nombre><Montos>80</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Montos>500</Montos></Producto></Servicio><Servicio>MOVISTAR INTERNET<Producto><Nombre>MOVISTAR 1D 35MB $10</Nombre><Montos>10007</Montos></Producto><Producto><Nombre>MOVISTAR 3D 100MB $30</Nombre><Montos>30007</Montos></Producto><Producto><Nombre>MOVISTAR 7D 200MB $60</Nombre><Montos>60007</Montos></Producto><Producto><Nombre>MOVISTAR 15D 450MB $80</Nombre><Montos>80007</Montos></Producto><Producto><Nombre>MOVISTAR 21D 750MB $120</Nombre><Montos>120007</Montos></Producto><Producto><Nombre>MOVISTAR 30D 1.5GB $200</Nombre><Montos>200007</Montos></Producto><Producto><Nombre>MOVISTAR 30DP 3GB $300</Nombre><Montos>300007</Montos></Producto></Servicio><Servicio>MOVISTAR<Producto><Nombre>RECARGA 10</Nombre><Montos>10</Montos></Producto><Producto><Nombre>RECARGA 20</Nombre><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 40</Nombre><Montos>40</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 60</Nombre><Montos>60</Montos></Producto><Producto><Nombre>RECARGA 70</Nombre><Montos>70</Montos></Producto><Producto><Nombre>RECARGA 80</Nombre><Montos>80</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 120</Nombre><Montos>120</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 250</Nombre><Montos>250</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 400</Nombre><Montos>400</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Montos>500</Montos></Producto></Servicio><Servicio>ALO<Producto><Nombre>RECARGA 10</Nombre><Montos>10</Montos></Producto><Producto><Nombre>RECARGA 20</Nombre><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Montos>500</Montos></Producto></Servicio><Servicio>CIERTO<Producto><Nombre>RECARGA 20</Nombre><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Montos>500</Montos></Producto></Servicio><Servicio>FLASH<Producto><Nombre>RECARGA 10</Nombre><Montos>10</Montos></Producto><Producto><Nombre>RECARGA 20</Nombre><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 40</Nombre><Montos>40</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 60</Nombre><Montos>60</Montos></Producto><Producto><Nombre>RECARGA 70</Nombre><Montos>70</Montos></Producto><Producto><Nombre>RECARGA 80</Nombre><Montos>80</Montos></Producto><Producto><Nombre>RECARGA 120</Nombre><Montos>120</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 250</Nombre><Montos>250</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 400</Nombre><Montos>400</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Montos>500</Montos></Producto></Servicio><Servicio>IUSACELL / ATT<Producto><Nombre>RECARGA 10</Nombre><Montos>10</Montos></Producto><Producto><Nombre>RECARGA 20</Nombre><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 70</Nombre><Montos>70</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Montos>500</Montos></Producto></Servicio><Servicio>MAZTIEMPO<Producto><Nombre>RECARGA 10</Nombre><Montos>10</Montos></Producto><Producto><Nombre>RECARGA 20</Nombre><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 60</Nombre><Montos>60</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 120</Nombre><Montos>120</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Montos>500</Montos></Producto></Servicio><Servicio>NEXTEL<Producto><Nombre>RECARGA 30</Nombre><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Montos>500</Montos></Producto></Servicio><Servicio>TUENTI<Producto><Nombre>RECARGA 50</Nombre><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 80</Nombre><Montos>80</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 250</Nombre><Montos>250</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Montos>300</Montos></Producto></Servicio><Servicio>UNEFON<Producto><Nombre>RECARGA 10</Nombre><Montos>10</Montos></Producto><Producto><Nombre>RECARGA 20</Nombre><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 70</Nombre><Montos>70</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Montos>500</Montos></Producto><Producto><Nombre>RECARGA 750</Nombre><Montos>750</Montos></Producto></Servicio><Servicio>VIRGIN<Producto><Nombre>RECARGA 20</Nombre><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 40</Nombre><Montos>40</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Montos>500</Montos></Producto></Servicio><Servicio>WEEX<Producto><Nombre>RECARGA 10</Nombre><Montos>10</Montos></Producto><Producto><Nombre>RECARGA 20</Nombre><Montos>20</Montos></Producto><Producto><Nombre>RECARGA 30</Nombre><Montos>30</Montos></Producto><Producto><Nombre>RECARGA 40</Nombre><Montos>40</Montos></Producto><Producto><Nombre>RECARGA 50</Nombre><Montos>50</Montos></Producto><Producto><Nombre>RECARGA 60</Nombre><Montos>60</Montos></Producto><Producto><Nombre>RECARGA 70</Nombre><Montos>70</Montos></Producto><Producto><Nombre>RECARGA 80</Nombre><Montos>80</Montos></Producto><Producto><Nombre>RECARGA 100</Nombre><Montos>100</Montos></Producto><Producto><Nombre>RECARGA 120</Nombre><Montos>120</Montos></Producto><Producto><Nombre>RECARGA 150</Nombre><Montos>150</Montos></Producto><Producto><Nombre>RECARGA 200</Nombre><Montos>200</Montos></Producto><Producto><Nombre>RECARGA 250</Nombre><Montos>250</Montos></Producto><Producto><Nombre>RECARGA 300</Nombre><Montos>300</Montos></Producto><Producto><Nombre>RECARGA 400</Nombre><Montos>400</Montos></Producto><Producto><Nombre>RECARGA 500</Nombre><Montos>500</Montos></Producto></Servicio></Resultado>

Estructura de cadena de respuesta de ERROR para obtener los productos disponibles:

Ir al Inicio