Manual Webservice Servicios

Descripción

El presente documento tiene como finalidad proporcionar la información necesaria para la correcta implementación y conexión entre el WebService del portal Multimarca con el desarrollo de un cliente consumidor para la correcta operación de cobro de servicios y consulta de saldos de servicios.

De ésta forma todas las consultas provenientes de la cuenta del cliente del portal multimarca 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 por el monto solicitado por el cliente consumidor.

Bajo ninguna circunstancia se podrá solicitar el reembolso de cobro de servicios realizados exitosamente desde la cuenta del cliente consumidor.

El tiempo máximo de respuesta por parte del WebService será de 90 Segundos para realizar un cobro de servicio.

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

URL del Webservice:

https://www.recargamarcas.com/wsServicios/index.php

URL del WSDL:

https://www.recargamarcas.com/wsServicios/index.php?WSDL

El servicio contiene 3 funciones que son:

  • SaldoServicios
  • RecargaServicios
  • Paquetes (ver manual de Webservice de Paquetes)

Para realizar pruebas puedes usar nuestro usuario demo:

Usuario demo123456
Passwd Demo123456

SaldoServicios (string).

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

Estructura de cadena de envío para obtener el saldo de servicios del usuario:

El cliente deberá enviar el siguiente string con el siguiente formato:

estrucutra
VARIABLE TIPO
Usuario String proporcionado con el nombre de usuario de acceso al Portal.
Passwd String proporcionado correspondiente a la contraseña de acceso.
Referencia La referencia es un entero siempre con el valor 0 cero.

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

estrucutra

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

estrucutra

RecargaServicios (string).

La función recibe un valor de tipo String:

Dicho String corresponde a la cadena XML que será enviada al servidor del portal multimarca para su procesamiento.

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

Estructura de cadena de envío para realizar un pago de servicio del cliente consumidor:

estrucutra
VARIABLE TIPO
Usuario String proporcionado con el nombre de usuario de acceso al Portal.
Passwd String proporcionado correspondiente a la contraseña de acceso.
Referencia String con la referencia de número de cuenta del servicio.
Dígito verificador Dígito verificador del recibo, es un número entero.
Compania String en mayúsculas de la compañía a la que se requiere pagar el servicio.
Monto Cantidad a pagar por el servicio.
Email String proporcionado con formato de correo electrónico en donde se enviará el comprobante de pago.
Extra Valor numérico siempre con valor de 0 cero.

El dígito verificador solo es para el caso de Telmex, en caso de no requerirse se debe poner un 0 (cero) en el espacio.

Estructura de cadena de respuesta POSITIVA para obtener un pago de servicio:

estrucutra
VARIABLE TIPO
Folio Número entero de comprobante de folio de pago del servicio.
Cantidad Monto del pago del servicio.
Referencia Número de referencia del servicio a pagar.
Compania Compañía a la que se realizó el pago de servicio.

Estructura de cadena de respuesta de ERROR para un pago de servicio:

estrucutra
Para cualquier duda y obtener soporte técnico por favor contacta a tu distribuidor.

Productos (string)

Dicho String corresponde a la cadena XML que será enviada al servidor del portal multimarca para su procesamiento. La funcion recibe un valor de tipo String como respuesta correspondiente a una cadena en formato XML.

Estructura de cadena de envío para obtener el listado de servicios y pines disponibles.

<Servicio><Usuario>manualesde</Usuario><Passwd>Manual2022%</Passwd><Referencia>0</Referencia></Servicio>
VARIABLE TIPO
Usuario String proporcionado con el nombre de usuario de acceso al Portal.
Passwd String proporcionado correspondiente a la contraseña de acceso.
Referencia Valor numérico siempre con valor de 0 cero.

Listado de compañías disponibles dentro del webservice.

  • SIAPA
  • AGUAKAN
  • AGUA DE TIJUANA
  • AGUA Y DRENAJE DE MONTERREY
  • ARABELA
  • AVON
  • BELCORP
  • CFE
  • DISH
  • ELEKTRA
  • FACTURATELCEL
  • IUSACELL
  • TELEFONICA
  • FULLER
  • GAS
  • ILUSION
  • INFONAVIT
  • IZZI
  • JAFRA
  • MEGACABLE
  • NATURA
  • SKY
  • STAR TV
  • TELEVIA
  • TELMEX
  • TOTAL PLAY
  • VETV
  • AMAZON
  • CALIENTE
  • CINEPOLIS 1 ACCESO
  • CINEPOLIS VIP
  • GOOGLE
  • KASPERSKY 1 PC 12 MESES
  • NETFLIX 300
  • NETFLIX 500
  • PLAYSTATION NETWORK 20 USD
  • PLAYSTATION NETWORK 50 USD
  • PRIVALIA
  • SPOTIFY
  • TARJETAS XBOX GIFT CARD 1000
  • TARJETAS XBOX GIFT CARD 200
  • XBOX LIVE 169 - 1 MES GOLD

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

<Resultado><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>SIAPA</Servicio><Nombre>AGUA DE GUADALAJARA</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>AGUAKAN</Servicio><Nombre>AGUA DE QUINTANA ROO</Nombre><Montos></Montos></Producto><Producto><Concepto>COD DE BARRAS SIN GUIONES</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>AGUA DE TIJUANA</Servicio><Nombre>AGUA DE TIJUANA</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>AGUA Y DRENAJE DE MONTERREY</Servicio><Nombre>AGUA Y DRENAJE DE MONTERREY</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>ARABELA</Servicio><Nombre>ARABELA</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia 20 digitos</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>AVON</Servicio><Nombre>AVON</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>BELCORP</Servicio><Nombre>BELCORP</Nombre><Montos></Montos></Producto><Producto><Concepto>NUM CONTRATO CFE - COD BARRAS</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>CFE</Servicio><Nombre>CFE</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>DISH</Servicio><Nombre>DISH</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia / Credito</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>ELEKTRA</Servicio><Nombre>ELEKTRA</Nombre><Montos></Montos></Producto><Producto><Concepto>NUM CELULAR 10 DIGITOS</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>FACTURATELCEL</Servicio><Nombre>FACTURA TELCEL</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>IUSACELL</Servicio><Nombre>FACTURAS IUSACELL</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>TELEFONICA</Servicio><Nombre>FACTURAS TELEFONICA / MOVISTAR</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>FULLER</Servicio><Nombre>FULLER</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>GAS</Servicio><Nombre>GAS NATURAL</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>ILUSION</Servicio><Nombre>ILUSION</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>INFONAVIT</Servicio><Nombre>INFONAVIT</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>IZZI</Servicio><Nombre>IZZI</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia Alfanumerico</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>JAFRA</Servicio><Nombre>JAFRA</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>MEGACABLE</Servicio><Nombre>MEGACABLE</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>NATURA</Servicio><Nombre>NATURA</Nombre><Montos></Montos></Producto><Producto><Concepto>Cuenta SKY</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>SKY</Servicio><Nombre>SKY</Nombre><Montos></Montos></Producto><Producto><Concepto>REFERENCIA 10 DIGITOS</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>STAR TV</Servicio><Nombre>STAR TV</Nombre><Montos></Montos></Producto><Producto><Concepto>TAG 11 NUM o 4 letras y 8 NUM </Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>TELEVIA 100</Servicio><Nombre>TELEVIA 100</Nombre><Montos><Cantidad>100</Cantidad></Montos></Producto><Producto><Concepto>TAG 11 NUM o 4 letras y 8 NUM</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>TELEVIA 200</Servicio><Nombre>TELEVIA 200</Nombre><Montos><Cantidad>200</Cantidad></Montos></Producto><Producto><Concepto>TAG 11 NUM o 4 letras y 8 NUM</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>TELEVIA 300</Servicio><Nombre>TELEVIA 300</Nombre><Montos><Cantidad>300</Cantidad></Montos></Producto><Producto><Concepto>TAG 11 NUM o 4 letras y 8 NUM</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>TELEVIA 500</Servicio><Nombre>TELEVIA 500</Nombre><Montos><Cantidad>500</Cantidad></Montos></Producto><Producto><Concepto>Teléfono</Concepto><Comision>5.5</Comision><Concepto1>Digito Verificador</Concepto1><Concepto2></Concepto2><Servicio>TELMEX</Servicio><Nombre>TELMEX</Nombre><Montos></Montos></Producto><Producto><Concepto>Referencia</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>TOTAL PLAY</Servicio><Nombre>TOTAL PLAY</Nombre><Montos></Montos></Producto><Producto><Concepto>Cuenta VETV</Concepto><Comision>5.5</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>VETV</Servicio><Nombre>VETV</Nombre><Montos></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>AMAZON 100</Servicio><Nombre>AMAZON 100</Nombre><Montos><Cantidad>100</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>AMAZON 300</Servicio><Nombre>AMAZON 300</Nombre><Montos><Cantidad>300</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>AMAZON 500</Servicio><Nombre>AMAZON 500</Nombre><Montos><Cantidad>500</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>AMAZON 800</Servicio><Nombre>AMAZON 800</Nombre><Montos><Cantidad>800</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>CALIENTE 107</Servicio><Nombre>Caliente 107</Nombre><Montos><Cantidad>107</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>CALIENTE 257</Servicio><Nombre>CALIENTE 257</Nombre><Montos><Cantidad>257</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>CALIENTE 507</Servicio><Nombre>CALIENTE 507</Nombre><Montos><Cantidad>507</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>Cinepolis 1 acceso</Servicio><Nombre>Cinepolis 1 acceso</Nombre><Montos><Cantidad>60</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>Cinepolis VIP</Servicio><Nombre>Cinepolis VIP</Nombre><Montos><Cantidad>140</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>GOOGLE 100</Servicio><Nombre>GOOGLE 100</Nombre><Montos><Cantidad>100</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>GOOGLE 200</Servicio><Nombre>GOOGLE 200</Nombre><Montos><Cantidad>200</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>GOOGLE 300</Servicio><Nombre>GOOGLE 300</Nombre><Montos><Cantidad>300</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>GOOGLE 500</Servicio><Nombre>GOOGLE 500</Nombre><Montos><Cantidad>500</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>Kaspersky 1 PC 12 MESES 399</Servicio><Nombre>Kaspersky 1 PC 12 MESES 399</Nombre><Montos><Cantidad>399</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>NETFLIX 300 300</Servicio><Nombre>NETFLIX 300</Nombre><Montos><Cantidad>300</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>NETFLIX 500 500</Servicio><Nombre>NETFLIX 500</Nombre><Montos><Cantidad>500</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>PlayStation Network 20 USD</Servicio><Nombre>PlayStation Network 20 USD</Nombre><Montos><Cantidad>410</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>PlayStation Network 50 USD</Servicio><Nombre>PlayStation Network 50 USD</Nombre><Montos><Cantidad>1025</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>PRIVALIA 107</Servicio><Nombre>Privalia 107</Nombre><Montos><Cantidad>107</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>PRIVALIA 257</Servicio><Nombre>Privalia 257</Nombre><Montos><Cantidad>257</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>PRIVALIA 507</Servicio><Nombre>Privalia 507</Nombre><Montos><Cantidad>507</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>SPOTIFY 115</Servicio><Nombre>SPOTIFY 115</Nombre><Montos><Cantidad>115</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>SPOTIFY 349</Servicio><Nombre>SPOTIFY 349</Nombre><Montos><Cantidad>349</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>TARJETAS XBOX GIFT CARD 1000 1000</Servicio><Nombre>TARJETAS XBOX GIFT CARD 1000</Nombre><Montos><Cantidad>1000</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>TARJETAS XBOX GIFT CARD 200 200</Servicio><Nombre>TARJETAS XBOX GIFT CARD 200</Nombre><Montos><Cantidad>200</Cantidad></Montos></Producto><Producto><Concepto>Celular para envio de código</Concepto><Comision>0</Comision><Concepto1></Concepto1><Concepto2></Concepto2><Servicio>Xbox Live 169 - 1 MES GOLD</Servicio><Nombre>Xbox Live 169 - 1 MES GOLD</Nombre><Montos><Cantidad>169</Cantidad></Montos></Producto></Resultado>

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

Ir al Inicio