Guía de integración iupay para VirtueMart

Guía de integración del módulo de Iupay en
VirtueMart
Versión: 1.0
30/03/2015
Referencia RS.TE.PRY.MAN.0001
Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA
Ref RS.TE.PRY.MAN.0001
<USO EXTERNO RESTRINGIDO>
Versión: 1.0
<USO EXTERNO RESTRINGIDO>
30/03/2015
i
Guía de integración Iupay en VirtueMart
La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta, o cesión a terceros
Autorizaciones y control de versión
AUTOR: Redsys
VALIDADO POR:
APROBADO POR:
EMPRESA: Redsys
EMPRESA: Redsys
EMPRESA: Redsys
Firma:
Firma:
Firma:
Fecha: 30/03/2015
Fecha: 30/03/2015
Fecha: 30/03/2015
Comentarios: La gestión de la documentación impresa es responsabilidad de la persona que la imprime.
Las versiones impresas los documentos no garantizan ser la última versión aprobada. Para consultar la
última versión acceder a la base de datos de Alejandría.
Versión
1.0
Fecha
Afecta
Breve descripción del cambio
Versión inicial
Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA
Ref RS.TE.PRY.MAN.0001
Versión: 1.0
30/03/2015
ii
Guía de integración Iupay en VirtueMart
La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta, o cesión a terceros
ÍNDICE DE CONTENIDO
1.
Objetivo ............................................................................................... 1
2.
Software necesario .............................................................................. 1
3.
Pasos a seguir ...................................................................................... 2
4.
Código generado .................................................................................. 7
Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA
Ref RS.TE.PRY.MAN.0001
Versión: 1.0
30/03/2015
iii
Guía de integración Iupay en VirtueMart
1.
Objetivo
En el presente documento se detalla el procedimiento básico para la
integración del módulo de pago de IUPAY en la tienda on-line VirtueMart
versión 2.9.9.3 o superior.
2.
Software necesario
Para poder realizar el seguimiento de esta guía es necesario tener
instalado los siguientes módulos:
1. Joomla versión 3.3.6 o superior: Sistema de gestión de contenido.
2. VirtueMart versión 2.9.9.3 o superior: Plug-in para la gestión de tiendas
on-line en Joomla.
Además deberemos tener descargado el módulo de pago de IUPAY para
VirtueMart.
Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA
Ref RS.TE.PRY.MAN.0001
Versión: 1.0
30/03/2015
1
Guía de integración Iupay en VirtueMart
3.
Pasos a seguir
Una vez instalado el sistema de Joomla y previo a la instalación del
plug-in VirtueMart en Joomla, se deben seguir los siguientes pasos:
1.
Inicialmente se debe descomprimir el directorio “.zip” del plug-in
VirtueMart
que
tiene
por
nombre
“com_virtuemart.2.9.9.3d_ext_aio.zip”.
2.
Ahora se debe descomprimir el módulo de pago de IUPAY y colocar el
directorio de nombre “iupay” en la siguiente ruta del directorio
“com_virtuemart.2.9.9.3d_ext_aio.zip” descomprimido:
 com_virtuemart.2.9.9.3d_ext_aio\admin\plugins\vmpayment\iupay
3.
A continuación se inserta código PHP en dos ficheros del directorio
“com_virtuemart.2.9.9.3d_ext_aio.zip” descomprimido, que le permiten
al mismo reconocer y configurar el módulo de pago de IUPAY. Estos
ficheros y las modificaciones pertinentes son las siguientes:
 En los ficheros que se almacenan en las siguientes rutas:
com_virtuemart.2.9.9.3d_ext_aio\script.vmallinone.php
com_virtuemart.2.9.9.3d_ext_aio\admin\script.vmallinone.php
Se debe incluir en la línea 127 de ambos ficheros la siguiente
instrucción:
$this->installPlugin
'vmpayment');
('VM
Payment
-
Iupay',
'plugin',
'iupay',
Y se debe incluir en la línea 404 de ambos ficheros la siguiente
instrucción:
$q = 'UPDATE `#__extensions` SET `ordering`= 1 WHERE `element`
="iupay"';
$db->setQuery($q);
$db->query();
4.
(OPCIONAL) De carácter opcional, ya que no es imprescindible para el
correcto funcionamiento del módulo, se pueden modificar los valores de
los parámetros correspondientes a la “Url_KO” y la “Url_OK”. Estos
valores se modificarán en un fichero del directorio “iupay” del que se
estableció una nueva ruta en el Paso 2.
Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA
Ref RS.TE.PRY.MAN.0001
Versión: 1.0
30/03/2015
2
Guía de integración Iupay en VirtueMart
Se deben modificar las líneas 196 y 197 del fichero almacenado en la
ruta iupay/iupay.php, tal y como se muestra en la siguiente imagen:

URL_OK/URL_KO: durante el proceso del pago, y una vez que
se muestra al cliente la pantalla con el resultado del mismo, es
posible redirigir su navegador a una URL para las transacciones
autorizadas y a otra si la transacción ha sido denegada. A estas
se las denomina URL_OK y URL_KO, respectivamente. Se trata
de dos URL que pueden ser proporcionadas por el comercio.
5.
En caso de no haber modificado la “Url_KO” y la “Url_OK” en el paso
anterior, se tiene que verificar la configuración del comercio en el
módulo de administración de Redsys, donde la opción “Parámetros en
las URLs” debe tener el valor “SI”.
6.
A continuación se debe colocar el fichero “Iupay.png” en la siguiente
ruta del directorio donde este alojado Joomla:
 \Joomla\images\stories\virtuemart\payment\Iupay.png
7.
En este punto ya está integrado el módulo de IUPAY en VirtueMart, sólo
falta
realizar
la
compresión
de
todos
los
ficheros
de
“com_virtuemart.2.9.9.3d_ext_aio” y obtener como resultado el
directorio “com_virtuemart.2.9.9.3d_ext_aio.zip”.
8.
Una vez instalado VirtueMart en Joomla, se debe acceder a su módulo
de administración para realizar la configuración del módulo de Iupay.
Para ello, una vez en la administración de Joomla, se debe acceder a la
pestaña VirtueMart.
La opción “Payment Methods” nos permite crear una forma de pago si
pulsamos la opción “new” en el menú de la parte superior. Esta opción
nos permite elegir la pasarela de pago que utilizaremos en nuestra
forma de pago, en nuestro caso Iupay, tal y como se muestra en la
siguiente imagen:
Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA
Ref RS.TE.PRY.MAN.0001
Versión: 1.0
30/03/2015
3
Guía de integración Iupay en VirtueMart
9.
Una vez se ha guardado la información del “Payment Method”, se debe
establecer la configuración de la pasarela de pago, en nuestro caso
Iupay. Esto se consigue mediante la pestaña “Configuration” del menú
de nuestra forma de pago, que presenta al administrador un formulario
para realizar la configuración del módulo.
A continuación se presenta una imagen de este formulario y una
descripción de todos los elementos que lo componen:
Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA
Ref RS.TE.PRY.MAN.0001
Versión: 1.0
30/03/2015
4
Guía de integración Iupay en VirtueMart
1.
Logo: Se debe establecer el valor “Iupay.png”. En caso de no
modificarlo, no aparecerá el logo en el momento del pago.
2.
Entorno de Iupay: Se selecciona el valor según corresponda si
estamos en fase de pruebas, de integración, etc.
3.
Nombre del comercio: Se indica el nombre del comercio.
4.
Número de comercio (FUC): Se indica el número de comercio que
nuestra entidad nos ha comunicado.
5.
Clave secreta de encriptación: Se indica la clave de encriptación
que tenemos.
6.
Número de terminal: Se indica el terminal del TPV.
7.
Tipo de firma: Se selecciona el tipo de firma del comercio.
8.
Tipo de moneda: Se selecciona la moneda de nuestro terminal
TPV (Normalmente Euros).
Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA
Ref RS.TE.PRY.MAN.0001
Versión: 1.0
30/03/2015
5
Guía de integración Iupay en VirtueMart
9.
Tipo de transacción:
(Normalmente “0”).
Se
indica
el
tipo
de
transacción
10. Activar idiomas: Se debe marcar como desactivada.
11. Recargo: Opción que permite utilizar
operaciones procesadas mediante Iupay.
un
recargo
en
las
12. Email Currency: (Su configuración es opcional) Esta opción es útil
si la moneda de pago no es la moneda de pago predeterminado.
Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA
Ref RS.TE.PRY.MAN.0001
Versión: 1.0
30/03/2015
6
Guía de integración Iupay en VirtueMart
4.
Código generado
En este apartado se detalla el código que la tienda on-line de VirtueMart
presenta al usuario, una vez se hayan realizado los pasos del anterior
apartado (Apartado 3) de manera correcta.
En la siguiente imagen se muestra un ejemplo de pedido de un usuario al
cual, una vez seleccionado la opción de pago de IUPAY se le mostrará el
siguiente resultado:
Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA
Ref RS.TE.PRY.MAN.0001
Versión: 1.0
30/03/2015
7

Download Report