|
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.
|
Inicio
| Afiliados
| Mapa del Sitio
| Entrar
o Registrarse
