Webservice de Recargas Electrónicas
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 4 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:
| 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 |
|
Estructura de cadena de respuesta POSITIVA para obtener los productos disponibles:
Estructura de cadena de respuesta de ERROR para obtener los productos disponibles:
