Manual de Usuario Web Service PromoCOM Ver 2.0

ver 2.
0

Manual de Uso Web Service
Recargas Electrónicas
Activación en línea
Actualizado Septiembre 2014

ver 2.0
Introducción:
Este documento tiene como finalidad mostrar la información básica de la arquitectura y conexión
del web service para la compra de Recargas Electrónicas y Pagos de Servicios que brinda
Promocom.
De la misma forma se listan los requerimientos para la conexión al mismo y se desglosa el llamado
y respuesta de las funciones.

ver 2.0
El servicio web está publicado en la siguiente dirección:
Producción:
http://web.promocom.mx/WSRecarga/services/WSRecargaseletronicas?wsdl
La ficha técnica del Web Service es la siguiente:
Sistema operativo CentOS
Lenguaje /API Java 1.5+/Axis2
Base de datos MySQL

ver 2.0
Función compra
Función para realizar recargas electrónicas de los diferentes Carriers. Los requisitos necesarios
para solicitar una recarga electrónica mediante este servicio son:
 Estar registrado en la plataforma de venta de servicios de http://multi.promocom.mx
 Tener asignado el permiso de venta en el usuario que se va a utilizar.
 Tener asignados los productos que se van a probar en el perfil del usuario.
 Tener saldo disponible suficiente para cubrir el monto de la compra.
Los parámetros de la función son los siguientes:
Parámetro Dominio Descripción

User String Usuario asignado por
http://multi.promocom.mx
(alfanumérico)
pass String Constraseña que es necesario
codificarla a “SHA‐256” para su
envío a la función
producto String Producto según anexo tabla de
productos
numCelular String Número de celular a 10 dígitos
(5512345678)
referencia1 String Referencia para pago de servicios,
puede ser null o vacío
referencia2 String Referencia para pago de servicios,
puede ser null o vacío
montoServicio String Monto a pagar

La respuesta de esta función es un objeto de tipo ResponseRecarga, el cual contiene los siguientes
parámetros:
Parametro Dominio Descripción

folio String Folio resultante de la
recarga
nip String NIP asignado a la
transacción (aplica
según el producto)
descripcionEstatus String Motivo descriptivo
del resultado de la
operación
estatus Int Código de operación
exitosa 1. Códigos de
operación errónea 4,
5, 6, 7, 8, 9, 10, 11 y
ver 2.0
17. Ver tabla con
códigos de respuesta
numCelular String Numero al cual se

asigno la recarga
idTransacción Int Identificador único
para la operación de
compra

El request de la función de compra, tiene la siguiente forma:
<?xml version='1.0' encoding='UTF‐8'?>

<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap‐envelope">

<soapenv:Body>

<ns2:compra xmlns:ns2="http://ws.recargas.com">

<ns2:user>TUUSERNAME</ns2:user>

<ns2:pass>TUPASSWORD</ns2:pass>

<ns2:producto>TUPRODUCTO</ns2:producto>

<ns2:numCelular>TUNUMEROCELULAR</ns2:numCelular>

<ns2:referencia1>TUREFERENCIA1</ns2:referencia1>

<ns2:referencia2>TUREFERENCIA2</ns2:referencia2>

<ns2:montoServicio>TUMONTOSERVICIO</ns2:montoServicio>

</ns2:compra>

</soapenv:Body>

</soapenv:Envelope>"

A continuación se muestra un ejemplo del llamado a función de compra, con un cliente
de web service, generado mediante Axis2:

public class WSRecargaseletronicasTest {
‐
public void testcompra() throws java.lang.Exception{

com.recargas.ws.client.WSRecargaseletronicasStub stub =
new com.recargas.ws.client.WSRecargaseletronicasStub();//the default implementation should point to the
right endpoint
ver 2.0
com.recargas.ws.client.WSRecargaseletronicasStub.Compra compra2=

(com.recargas.ws.client.WSRecargaseletronicasStub.Compra)getTestObject(com.recargas.ws.client.WSRecarga
seletronicasStub.Compra.class);

stub.compra(
compra2);
}
//Create an ADBBean and provide it as the test object
public org.apache.axis2.databinding.ADBBean getTestObject(java.lang.Class type) throws java.lang.Exception{
return (org.apache.axis2.databinding.ADBBean) type.newInstance();
}
public static void main(String[] args)
{
URL log4jConf = WSTDSTStub.class.getResource("/resources/log4j.properties");
PropertyConfigurator.configure(log4jConf);
Logger logger= Logger.getLogger("CommonsHTTPTransportSender");
logger.debug("Log4J configurado");

WSRecargaseletronicasStub stub;
try
{
stub = new WSRecargaseletronicasStub();
Compra com=new Compra();
com.setUser("TUUSERNAME");
com.setPass("TUPASSWORD");
com.setProducto("TUPRODUCTO");
com.setNumCelular("TUNUMEROCELULAR");
com.setReferencia1("TUREFERENCIA1");
com.setReferencia2("TUREFERENCIA2");
com.setMontoServicio("TUMONTOVENTA");

CompraResponse res=stub.compra(com);
MensajesDebug.imprimeMensaje("Estatus: "+res.get_return().getEstatus());
MensajesDebug.imprimeMensaje("DecsEstatus:
"+res.get_return().getDescripcionEstatus());
MensajesDebug.imprimeMensaje("Folio: "+res.get_return().getFolio());
MensajesDebug.imprimeMensaje("NIP: "+res.get_return().getNip());
MensajesDebug.imprimeMensaje("Celular: "+res.get_return().getNumCelular());

}
catch (Exception ex)
{
//ex.printStackTrace();
MensajesDebug.imprimeMensaje(ex);
}
}
}

A continuación mostramos un ejemplo del XML response de Función de compra:
< "l version='1.0' encoding='UTF‐8'?>


ver 2.0
<soapenv:Body>

<ns:compraResponse xmlns:ns="http://ws.recargas.com">

<ns:return xmlns:xsi="http://www.w3.org/2001/XMLSchema‐instance"
xmlns:ax21="http://ws.recargas.com/xsd" xsi:type="ax21:ResponseRecarga">

<ax21:descripcionEstatus>VENTA EXITOSA</ax21:descripcionEstatus>

<ax21:estatus>1</ax21:estatus>

<ax21:folio>5214587</ax21:folio>

<ax21:idTransaccion>45</ax21:idTransaccion>

<ax21:nip>45457869</ax21:nip>

<ax21:numCelular>5512345678</ax21:numCelular>

</ns:return>
</ns:compraResponse>
</soapenv:Body>
</soapenv:Envelope>

Función comisionServicio
Los requisitos necesarios para consultar la comisión por un pago de servicio mediante este servicio
son:
 Tener disponible la venta de estos productos desde su usuario de venta asignado.
ver 2.0

user String Asignado por
(alfanumérico)
pass String Es necesario codificarlo a “SHA‐256”
para su envío a la función
sku String Producto según anexo tabla de
productos

El response de esta función es un objeto de tipo ResponseRecarga, el cual contiene los siguientes
parámetros:

descripcionEstatus String Motivo descriptivo del resultado de
la operación
estatus Int Código de operación exitosa 1.
Códigos de operación errónea 4, 5,
6, 7, 9, 10, 11, 14, 16 y 20. Ver tabla
de códigos de respuesta
comision String Importe de la comisión que debe de
incluir el monto total de la
operación de un pago de servicios.

Ejemplo forma de XML “comisionServicio”
Request

<soapenv:Body>
<ns2:comisionServicio xmlns:ns2="http://ws.recargas.com">
<ns2:user>TU_USER</ns2:user>
<ns2:pass>TU_PASSWORD</ns2:pass>
<ns2:sku>PRODCUTO</ns2:sku>
</ns2:comisionServicio>
</soapenv:Body>
</soapenv:Envelope>
ver 2.0
Response

<soapenv:Body>
<ns:comisionServicioResponse xmlns:ns="http://ws.recargas.com">
<ns:return xmlns:ax21="http://ws.recargas.com/xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema‐instance"
xsi:type="ax21:ResponseRecarga">
<ax21:comision>5.0</ax21:comision>
<ax21:descripcionEstatus>Comision Asignada</ax21:descripcionEstatus>
<ax21:folio></ax21:folio>
<ax21:nip></ax21:nip>
<ax21:numCelular></ax21:numCelular>
<ax21:saldo></ax21:saldo>
</ns:return>
</ns:comisionServicioResponse>
</soapenv:Body></soapenv:Envelope>
Función compraServicio
Los requisitos necesarios para solicitar un pago de servicios mediante este servicio son:
 Tener asignado el permiso de venta en el usuario que se va a utilizar.
 Tener asignados los productos que se van a probar en el perfil del usuario.
 Tener saldo disponible suficiente para cubrir el monto de la compra.

ver 2.0

(alfanumérico)
producto String Producto según anexo tabla de
productos
numCelular String Número de celular a 10 dígitos
(5512345678)
referencia1 String Fecha de vencimiento del recibo
(dd‐MM‐yyyy)
referencia2 String Referencia de pago. Ver matriz de
referencia
referencia3 String Referencia según servicio. Ver
matriz de referencias
referencia4 String A reserva para futuros productos.
Tipo de dato a enviar “0”
comision String Monto de la comisión la cual se
obtiene mediante el método
comisionServicio.
montoServicio String Monto del recibo a pagar

parámetros:
Parametro Dominio Descripción

folio String Folio resultante de la
recarga
nip String NIP asignado a la
transacción (aplica
según el producto)
descripcionEstatus String Motivo descriptivo
del resultado de la
operación
estatus Int Código de operación
exitosa 1. Códigos de
operación errónea 4,
5, 6, 7, 8, 9, 10 y 11.
Ver tabla con códigos
de respuesta
ver 2.0
numCelular String Número para

notificar al usuario
(Depende del
producto)
idTransaccion int Identificador único
para la operación de
pago

Ejemplo forma de XML “compraServicio”
Request

<soapenv:Body>
<ns2:compraServicio xmlns:ns2="http://ws.recargas.com">
<ns2:user>TU_USER</ns2:user>
<ns2:pass>TU_PASSWORD</ns2:pass>
<ns2:producto>PRODUCTO</ns2:producto>
<ns2:numCelular>CELULAR</ns2:numCelular>
<ns2:referencia1>referencia1</ns2:referencia1>

<ns2:montoServicio>MONTO_+_COMISION</ns2:montoServicio>
</ns2:compraServicio>
</soapenv:Body>
</soapenv:Envelope>

Response

<soapenv:Body>
<ns:compraServicioResponse xmlns:ns="http://ws.recargas.com">
<ns:return xmlns:ax21="http://ws.recargas.com/xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema‐instance"
<ax21:comision>
</ax21:comision>
<ax21:descripcionEstatus>Venta Exitosa</ax21:descripcionEstatus>
<ax21:folio xsi:nil="true" />
<ax21:nip xsi:nil="true" />
<ax21:numCelular>5454545454</ax21:numCelular>
<ax21:saldo>
</ax21:saldo>
</ns:return>
</ns:compraServicioResponse>
</soapenv:Body>
ver 2.0
</soapenv:Envelope>

Función consultaSaldo
Los requisitos necesarios para solicitar el saldo mediante este servicio son:
Los parámetros son los siguientes:

(alfanumérico)

parámetros:

ver 2.0

saldo String Saldo disponible de la empresa a la
cual pertenece el usuario.
la operación
6, 11, 12 y 13. Ver tabla con códigos
de respuesta

Ejemplo forma de XML “consultaSaldo”
Request
<?xml version='1.0' encoding='UTF‐8'?><soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap‐
envelope">

<soapenv:Body>

<ns2:consultaSaldo xmlns:ns2="http://ws.recargas.com">

<ns2:user>MIUSERNAME</ns2:user>

<ns2:pass>MIPASSWORD</ns2:pass>

</ns2:consultaSaldo>

</soapenv:Body>

</soapenv:Envelope>

Response
<"l version='1.0' encoding='UTF‐8'?><soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap‐envelope">

<soapenv:Body>

<ns:consultaSaldoResponse xmlns:ns="http://ws.recargas.com">

<ns:return xmlns:xsi="http://www.w3.org/2001/XMLSchema‐instance" xmlns:ax21="http://ws.recargas.com/xsd"

<ax21:descripcionEstatus>Consulta Exitosa</ax21:descripcionEstatus>






<ax21:saldo>475057.825</ax21:saldo>

ver 2.0
</ns:return>

</ns:consultaSaldoResponse>

</soapenv:Body>

</soapenv:Envelope>

Función estatusProducto
Los requisitos necesarios para consultar el estatus de un producto mediante este servicio son:

(alfanumérico)
sku String Producto según anexo tabla de
productos

parámetros:

la operación
ver 2.0
6, 7, 11, 14 y 16. Revisar tabla de

Ejemplo forma de XML “estatusProducto”
Request
envelope">

<soapenv:Body>

<ns2:estatusProducto xmlns:ns2="http://ws.recargas.com">



<ns2:sku>TELCEL100</ns2:sku>

</ns2:estatusProducto>


Response
<"l version='1.0' encoding='UTF‐8'?>


<soapenv:Body>

<ns:estatusProductoResponse xmlns:ns="http://ws.recargas.com">


<ax21:descripcionEstatus>Producto Activo</ax21:descripcionEstatus>







</ns:return>

</ns:estatusProductoResponse>

ver 2.0
Función estatusPlataforma
Los requisitos necesarios para solicitar verificar el estatus de la plataforma mediante este servicio
son:

(alfanumérico)

parámetros:

la operación
Código de operación errónea 4, 5, 6,
11, 17 y 19. Validar tabla de códigos
de respuesta

Ejemplo forma de XML “estatusPlataforma”
ver 2.0
Request
envelope">

<soapenv:Body>

<ns2:estatusPlataforma xmlns:ns2="http://ws.recargas.com">



</ns2:estatusPlataforma>

</soapenv:Body>

</soapenv:Envelope>

Response
<"l version='1.0' encoding='UTF‐8'?><soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap‐envelope">

<soapenv:Body>

<ns:estatusPlataformaResponse xmlns:ns="http://ws.recargas.com">


<ax21:descripcionEstatus>Plataforma Activa, Acceso Seguro</ax21:descripcionEstatus>







</ns:return>

</ns:estatusPlataformaResponse>
</soapenv:Body>

</soapenv:Envelope>

ver 2.0

Función cambioPassword
Los requisitos necesarios para realizar el cambio de contraseña mediante este servicio son:


(alfanumérico)
passOld String Contraseña actual y es necesario
codificarlo a “SHA‐256” para su
passNew String Nueva contraseña y es necesario
codificarlo a “SHA‐256” para su

parámetros:

la operación
6, 11, 17 y 22. Revisar tabla de

Ejemplo forma de XML “cambioPassword”
Request
envelope">

<soapenv:Body>
ver 2.0

<ns2:cambioPassword xmlns:ns2="http://ws.recargas.com">


<ns2:passOld>MIPASWORD</ns2:passOld>

<ns2:passNew>MINEWPASSWORD</ns2:passNew>

</ns2:cambioPassword>


Response
<"l version='1.0' encoding='UTF‐8'?>


<soapenv:Body>

<ns:cambioPasswordResponse xmlns:ns="http://ws.recargas.com">


<ax21:descripcionEstatus>Operación exitosa</ax21:descripcionEstatus>







</ns:return>

</ns:cambioPasswordResponse>


ver 2.0

ANEXO

TABLA DE PRODUCTOS

Abonos de Tiempo Aire
MOVISTAR IUSACELL UNEFON NEXTEL TELCEL
MOVISTAR10 IUSACELL50 UNEFON50 NEXTEL30 TELCEL20
MOVISTAR60 IUSACELL300 UNEFON300 TELCEL200
MOVISTAR70 IUSACELL500 UNEFON500 TELCEL300
MOVISTAR80 TELCEL500
MOVISTAR100
MOVISTAR120
MOVISTAR150
MOVISTAR200
MOVISTAR250
MOVISTAR300
MOVISTAR400
MOVISTAR500

Modulo de internet y Mensajes.
Para el módulo de paquete de datos y sms se harán las peticiones de la siguiente forma:
PRODUCTO MONTO TIPO DE

RECARGA
MOVIINT1H 9.0 Internet 1 hr
MOVIRS24H 15.0 Redes Sociales 24
hrs
MOVIINT1D 19.0 Internet 1 dia
MOVICC24H 19.0 Correo y chat 24
hrs
MOVICC7D 30.0 Correo y chat 7
dias
ver 2.0
MOVIRS7D 50.0 Redes Sociales 7

dias
MOVCONECTA 90.0 Conecta 50 en 15
MOVIINT7D 99.0 Internet 7 dias
MOVICC30D 100.0 Correo y Chat 30
dias
MOVIRS30D 150.0 Redes Sociales 30
dias
MOVIINT30D 199.0 Internet 30 dias
MOVNAVEGA 210.0 Navega 200 en
15
MOVDATS20M 279.0 Datos
Semestrales 20
Mb
MOVDESC800 299.0 Descarga 800 en
15
MOVDATA20M 499.0 Datos Annual
20Mb
MOVSEMESTRAL 529.0 Datos
Semestrales
50Mb
MOVANUAL 949.0 Datos Annual
50Mb
MOVISMS23 20.0 23 SMS

Rutina Java JDK1.5+ para la encriptación SHA‐256
String pass=”tuPassword”;
MessageDigest digest = MessageDigest.getInstance("SHA-256");

digest.reset();
digest.update(pass.getBytes());
byte[] hash = digest.digest();
StringBuffer hexString = new StringBuffer();

for (int i=0;i<hash.length;i++) {
String dummy = Integer.toHexString(0xFF & hash[i]);
if (dummy.length()==1){
dummy="0"+dummy;
}
hexString.append(dummy);
}
pass=hexString.toString();

ver 2.0
Códigos de respuesta:
Estatus Descripción
1 Operación exitosa
4 No se encontró el usuario indicado
5 Password incorrecto
6 Usuario no registrado en la plataforma
7 Producto inválido
8 Error al buscar el producto
9 Transacción cancelada (motivo variable)
10 Transacción denegada (motivo variable)
11 Usuario y/o empresa inactivos
12 No se encontró el saldo de la empresa
13 Error al buscar el saldo
14 Producto inactivo
15 Producto activo
16 Error al buscar el producto
17 Plataforma fuera de línea, intente más tarde
18 Plataforma en línea
19 Error al consultar el estatus de la plataforma
20 No hay comisión asignada
21 Dato de depósito erróneo (motivo variable)
22 Error al tratar de cambiar la contraseña

Uso de referencias por servicio:
Producto Celular Referencia1 Referencia2 Referencia3 Referencia4 Monto de Comisión

ver 2.0
Servicio
Número de Fecha de vencimiento del Teléfono con Comisión por
Dígito verificador
TELMEX notificación recibo. Formato: dd‐MM‐ clave LADA
1 Digito
0 Monto del recibo método
del cliente YYYY 10 Dígitos comisionServicio
Número de Fecha de vencimiento del Número de Comisión por
DISH notificación recibo. Formato: dd‐MM‐ cliente 0 Monto del recibo método
del cliente YYYY 14 Digitos comisionServicio
CFE notificación recibo. Formato: dd‐MM‐ servicio Número de medidor 0 Monto del recibo método
SKY notificación recibo. Formato: dd‐MM‐ cuenta 0 Monto del recibo método
Número de Fecha de vencimiento del Comisión por
NumTeléfono
AXTEL notificación recibo. Formato: dd‐MM‐
26 Dígitos
0 Monto del recibo método
del cliente YYYY comisionServicio
FACTURA
MOVISTAR
notificación recibo. Formato: dd‐MM‐ referencia 0 Monto del recibo método
Número de
referencia
ADT notificación recibo. Formato: dd‐MM‐
Por el momento
Nombre del titular 0 Monto del recibo método
no disponible
MEGACABLE notificación recibo. Formato: dd‐MM‐ suscriptor Nombre del titular 0 Monto del recibo método
GOBIERNO Número de Fecha de vencimiento del Número de Comisión por
CHIHUAHUA notificación recibo. Formato: dd‐MM‐ referencia Nombre del titular 0 Monto del recibo método
MUNICIPIO DE Número de
referencia
NAUCALPAN notificación recibo. Formato: dd‐MM‐
Por el momento
no disponible
Número de
CAPAMA referencia
notificación recibo. Formato: dd‐MM‐
Por el momento
no disponible
Número de
NATURALBESA referencia
Por el momento
no disponible
Número de
IUSACELL SECSA referencia
Por el momento
no disponible
CABLEMAS
notificación recibo. Formato: dd‐MM‐ referencia Nombre del titular 0 Monto del recibo método
Número de
ESTRELLAS BS referencia
Por el momento
no disponible
Número de
AVON referencia
14 Digitos (Ref.
Banamex)
ver 2.0
Número de
FULLER referencia
Por el momento
no disponible
GAS NATURAL
GLOBALCARD
del cliente YYYY 16 dígitos comisionServicio
INFONAVIT
TELNOR
Número de
SIAPA referencia
Próxima
actualización

Manual de Usuario Web Service PromoCOM Ver 2.0

Încărcat de

Informații document

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Manual de Usuario Web Service PromoCOM Ver 2.0

Încărcat de

Drepturi de autor:

Formate disponibile

ver 2.

Parámetro Dominio Descripción

Parametro Dominio Descripción

numCelular String Numero al cual se

Parámetro Dominio Descripción

Parámetro Dominio Descripción

Parámetro Dominio Descripción

user String Asignado por

Parametro Dominio Descripción

numCelular String Número para

Parámetro Dominio Descripción

Parámetro Dominio Descripción

Parámetro Dominio Descripción

Parámetro Dominio Descripción

Parámetro Dominio Descripción

Parámetro Dominio Descripción

Parámetro Dominio Descripción

Parámetro Dominio Descripción

PRODUCTO MONTO TIPO DE

MOVIRS7D 50.0 Redes Sociales 7

MessageDigest digest = MessageDigest.getInstance("SHA-256");

StringBuffer hexString = new StringBuffer();

Producto Celular Referencia1 Referencia2 Referencia3 Referencia4 Monto de Comisión

S-ar putea să vă placă și