![[ve]](http://static.trabajofreelance.com/images/flags/ve.gif "País: Venezuela")
![[V]](http://static.trabajofreelance.com/images/icons/usrchecked.gif "Datos verificados"){kind=icon}
Instalación y configuración del Botón de Pago
(merchantv2.war) en ambiente Unix/Linux,
para comercios o tiendas
virtuales del Banco Mercantil - Venezuela
Instalación.
Colóquese en el directorio donde desee realizar la instalación, se recomienda
/usr/local/tomcat/webapps/
, realice los siguientes pasos:
Cambiar los permisos del archivo con el siguiente comando:chmod 755 merchantv2.war
Reinicie el servicio del Tomcat usando sus archivos shutdown.sh y startup.sh,estó hara que se descomprima un archivo con el mismo nombre del archivo
merchantv2.war, es decir, que deberá generarlo así:
/usr/local/tomcat/webapps/merchantv2
Si no se genera el directorio /merchantv2 proceda a crearlo manualmente, y amover el archivo merchantv2.war a este nuevo directorio, con la finalidad de
descomprimirlo: (tome en cuenta que el contenido del archivo merchantv2.war no
tiene un directorio base, es decir que descomprimirá los archivos en el directorio
actual)
o
mkdir merchantv2 (crea el directorio)o
mv merchantv2.war /usr/local/tomcat/webapps/merchantv2/ (mueve elarchivo merchantv2.war al directorio creado)
o
cd merchantv2/ (coloca al usuario en el directorio creado)o
jar -xvf merchantv2.war (descomprime el contenido del archivomerchantv2.war)
o
rm merchantv2.war (elimina el archivo merchantv2.war para liberarespacio)
Configuración.
Para configurar el Botón de Pago se requiere:
Agregar el contexto ó directorio virtual de merchantv2 en el Tomcat, para ellodebe abrir en modo de edición el archivo
server.xml ubicado en/usr/local/tomcat/conf
o
Se debe agregar un tag Context casi al final del archivo server.xml,justo antes de cerrar el tag del Host, como se puede observar a
continuación:
Donde el contexto a agregar debe ser así:
docBase="/usr/local/tomcat/webapps/merchantv2 debug="0" privileged="true" /> Antes:
Después:
docBase="/usr/local/tomcat/webapps/merchantv2" debug="0" privileged="true" />
Una vez modificado el archivo de configuración server.xml del Tomcat, es
requerido reiniciar el servicio, para que los cambios surtan efecto.
NOTA: Asumiendo que han decidido llamar el contexto por el nombre que
lleva por defecto merchantv2, si ha sido cambiado, lógicamente deberán
considerar el nuevo nombre del directorio virtual sustituyendo el nombre
merchantv2 por el que ha decidido usted.
Si desea conocer más detalles acerca de la configuración de Tomcat y sus
archivos, puede dirigirse al siguiente URL:
http://jakarta.apache.org/tomcat/tomcat-4.0-doc/config/index.html
Configuración de los botones de pago (Débito y Crédito):o
Debe abrir en modo de edición el archivo A_merc.jsp ubicado en/usr/local/tomcat/webapps/merchantv2
Dentro del archivo busque la etiqueta botón de débito; y dentro de la cual existen los atributos:
serverUrl
= "https://170.224.166.139/todo1v2/FrontServlet"path
= "C:/Tomcat/webapps/merchantv2/WEB-INF/lib/Todo1.jar"invoiceNumber
= "<%= invoiceNumber%>"tax
= "<%= tax%>"extra
= "<%= extra%>"totalAmount
= "<%= totalAmount %>"/>serverUrl
= "https://170.224.166.139/todo1v2/FrontServlet"path
= "C:/Tomcat/webapps/merchantv2/WEB-INF/lib/Todo1.jar"invoiceNumber
= "<%= invoiceNumber%>"tax
= "<%= tax%>"extra
= "<%= extra%>"totalAmount
= "<%= totalAmount %>"/>Establezca el valor del atributo
serverUrl a la siguiente dirección:https://170.224.166.139/todo1v2/FrontServlet
Establezca el valor del atributo
path por la dirección física donde se ha ubicado elkit e-pagos (Todo1.jar) personalizado para su comercio o tienda virtual, en el
servidor donde este reside, si ha seguido paso a paso este manual y no ha decidido
modificar las rutas propuestas, el archivo Todo1.jar debe encontrarse en la
siguiente ruta:
/usr/local/tomcat/webapps/merchantv2/WEB-INF/lib/Todo1.jar
El objetivo de esta página es generar el (los) botón (es) de pago con la firma
digital, para lo cual requiere el archivo Todo1.jar (kit e-pagos) personalizado para
su comercio o tienda virtual, dicho kit contiene la llave privada de cada comercio,
que se usará para firmar la siguiente información a enviar al Banco:
invoiceNumber: (Número de factura o identificador de transacción)o
Importancia: Requerido.o
Formato: Alfanumérico (dígitos y/o números), su longitud no debe exceder losdoce (12) caracteres, no debe contener caracteres especiales ni espacios.
o
Utilidad: Identifica de manera única cada transacción de comercio electrónicoproveniente de un comercio o tienda virtual (Por ejemplo: un número secuencial);
si este valor es repetido, la transacción será rechazada.
totalAmount: (Monto total a pagar por el tarjeta habiente)o
Importancia: Requerido.o
Formato: Numérico, si el monto total posee cifras decimales, se debe usar elformato inglés, con separador decimal punto (.) y dos (2) decimales. (Por ejemplo:
Bs. 1000.00 equivalente a mil bolívares).
o
Utilidad: Identifica el monto total a pagar por el tarjeta habiente y acreditar ala cuenta beneficiaria del comercio o tienda virtual.
serverUrl: (Dirección del servidor de Todo1 donde se solicitan los datos)o
Importancia: Requerido.o
Formato: El valor del serverUrl debe ir entre comillas dobles (serverUrl =https://170.224.166.139/todo1v2/FrontServlet)
o
Utilidad: Identifica la dirección URL del servidor de e-pagos TODO1, al que sehará el llamado para tomar el control de la transacción.
path:o
Importancia: Requerido.o
Formato: El valor del path debe ir entre comillas dobles (path =/usr/local/tomcat/webapps/merchantv2/WEB-INF/lib/Todo1.jar)
o
Utilidad: Identifica la dirección física donde usted ha ubicado el kit e-pagos(Todo1.jar) personalizado para su comercio o tienda virtual.
extra:o
Importancia: Opcional.o
Formato: Alfanumérico (dígitos y/o números), máximo 512 caracteres.o
Utilidad: Enviar información personal para identificar el pago, el valor que seenvíe en este parámetro, igualmente será retornado. Por ejemplo: direcciones de
correo electrónico, tipo de transacción (débito ó crédito), información personal del
comercio o tienda virtual, etc.
tax:o
Importancia: Opcional.o
Formato: Numérico, si el impuesto posee cifras decimales, se debe usar elformato inglés, con separador decimal punto (.) y dos (2) decimales. (Por ejemplo:
Bs. 1000.00 equivalente a mil bolívares).
o
Utilidad: En comercio electrónico del Banco Mercantil - Venezuela, NO se usael atributo impuesto (tax), este valor debe ser incluido en el monto total
(totalAmount).
El comercio o tienda virtual debe generar está página (con los diseños de su
preferencia), manteniendo los logos de las marcas Visa, Master Card, Llave
Mercantil (en caso de requerirlo) y el e-pagos Mercantil que es el logo del producto;
además debe especificar los valores correspondiente al pago a realizar, esto es
invoiceNumber, totalAmount, serverUrl, path, extra. Para este ejemplo merchantv2
permite el ingreso manualmente de estos valores en la página index_merc.jsp.
Configuración del archivo de verificación de mensajes de respuesta:o
Debe abrir en modo de edición el archivo verifyconfirmation.jsp ubicadoen
/usr/local/tomcat/webapps/merchantv2Dentro del archivo busque el siguiente fragmento de código fuente:
try{
MerchantHelper helper = new MerchantHelper();helper.setPath("C:/Tomcat/webapps/merchantv2/WEB-INF/lib/Todo1.jar");
En el método helper.setPah( ), establezca la dirección física donde se ha ubicado
el kit e-pagos (Todo1.jar) personalizado para su comercio o tienda virtual, en el
servidor donde este reside, si ha seguido paso a paso este manual y no ha decidido
modificar las rutas propuestas, el archivo Todo1.jar debe encontrarse en la
siguiente ruta:
/usr/local/tomcat/webapps/merchantv2/WEB-INF/lib/Todo1.jar
try{
MerchantHelper helper = new MerchantHelper();
helper.setPath("/usr/local/tomcat/webapps/merchantv2/WEB-INF/lib/Todo1.jar");
Existe soporte de parte del Banco para apoyar la instalación.
![[GeoTrust]](http://static.trabajofreelance.com/images/seal/geotrust.gif "GeoTrust")
![[PayPal]](http://static.trabajofreelance.com/images/seal/paypal.gif "PayPal")
![[Visa]](http://static.trabajofreelance.com/images/seal/visa.gif "Visa")
![[MasterCard]](http://static.trabajofreelance.com/images/seal/mastercard.gif "MasterCard")
![[Feeds]](http://static.trabajofreelance.com/images/seal/rss.png "Feeds")
![[Blog]](http://static.trabajofreelance.com/images/seal/wordpress.png "Blog")
![[Facebook]](http://static.trabajofreelance.com/images/seal/facebook.png "Facebook")
![[Twitter]](http://static.trabajofreelance.com/images/seal/twitter.png "Twitter")
![[Linkedin]](http://static.trabajofreelance.com/images/seal/linkedin.png "Linkedin")
![[Youtube]](http://static.trabajofreelance.com/images/seal/youtube.png "Youtube")