Guía de integración del módulo de Redsys en VirtueMart

Tamaño: px

Comenzar la demostración a partir de la página:

Download "Guía de integración del módulo de Redsys en VirtueMart"

Domingo Aranda Escobar
hace 8 años
Vistas:

Guía de integración del módulo de Redsys en VirtueMart Versión: 1.0 30/03/2015 Referencia RS.ED.IND.MAN.

1 Guía de integración del módulo de Redsys en VirtueMart Versión: /03/2015 Referencia RS.ED.IND.MAN.0043 Ref RS.ED.IND.MAN.0043 <USO EXTERNO RESTRINGIDO> Versión: 1.0 <USO EXTERNO RESTRINGIDO> 30/03/2015 i

IND.MAN.0043 Ref RS.ED.IND.MAN.0043 <USO EXTERNO RESTRINGIDO> Versión: 1.

2 La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta, o cesión a terceros Guía de integración Redsys en VirtueMart 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 Fecha Afecta Breve descripción del cambio 1.0 Versión inicial Versión: 1.0 ii

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

3 La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta, o cesión a terceros Guía de integración Redsys en VirtueMart ÍNDICE DE CONTENIDO 1. Objetivo Software necesario Pasos a seguir Código generado... 7 Versión: 1.0 iii

integración Redsys en VirtueMart ÍNDICE DE CONTENIDO 1. Objetivo... 1 2.

4 1. Objetivo En el presente documento se detalla el procedimiento básico para la integración del módulo de pago de REDSYS en la tienda on-line VirtueMart versión 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 o superior: Sistema de gestión de contenido. 2. VirtueMart versión 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 REDSYS para VirtueMart. Versión: 1.0 1

5 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 d_ext_aio.zip. 2. Ahora se debe descomprimir el módulo de pago de REDSYS y colocar el directorio de nombre redsys en la siguiente ruta del directorio com_virtuemart d_ext_aio.zip descomprimido: com_virtuemart d_ext_aio\admin\plugins\vmpayment\redsys 3. A continuación se inserta código PHP en dos ficheros del directorio com_virtuemart d_ext_aio.zip descomprimido, que le permiten al mismo reconocer y configurar el módulo de pago de REDSYS. Estos ficheros y las modificaciones pertinentes son las siguientes: En los ficheros que se almacenan en las siguientes rutas: com_virtuemart d_ext_aio\script.vmallinone.php com_virtuemart d_ext_aio\admin\script.vmallinone.php Se debe incluir en la línea 127 de ambos ficheros la siguiente instrucción: $this->installplugin ('VM Payment - Redsys', 'plugin', 'redsys', 'vmpayment'); Y se debe incluir en la línea 404 de ambos ficheros la siguiente instrucción: $q = 'UPDATE `# extensions` SET `ordering`= 1 WHERE `element` ="redsys"'; $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 redsys del que se estableció una nueva ruta en el Paso 2. Versión: 1.0 2

$Ahora se debe descomprimir el módulo de pago de REDSYS y colocar el directorio de nombre redsys 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\redsys 3.$

6 Se deben modificar las líneas 206 y 207 del fichero almacenado en la ruta redsys/redsys.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 Redsys.png en la siguiente ruta del directorio donde este alojado Joomla: \Joomla\images\stories\virtuemart\payment\Redsys.png 7. En este punto ya está integrado el módulo de REDSYS en VirtueMart, sólo falta realizar la compresión de todos los ficheros de com_virtuemart d_ext_aio y obtener como resultado el directorio com_virtuemart d_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 Redsys. 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 Redsys, tal y como se muestra en la siguiente imagen: Versión: 1.0 3

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.

7 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 Redsys. 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: Versión: 1.0 4

Esto se consigue mediante la pestaña Configuration del menú de nuestra forma de pago, que presenta al

8 1. Logo: Se debe establecer el valor Redsys.png. En caso de no modificarlo, no aparecerá el logo en el momento del pago. 2. Entorno de Redsys: 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. Tipos de pago permitidos: Se indican los métodos de pago que queremos que se presenten al cliente. Cabe destacar que para que el cliente puede pagar a través de Iupay, el comercio debe tener activado el servicio de pago con Iupay. 6. Clave secreta de encriptación: Se indica la clave de encriptación que tenemos. 7. Número de terminal: Se indica el terminal del TPV. Versión: 1.0 5

Número de comercio (FUC): Se indica el número de comercio que nuestra entidad nos ha comunicado. 5.

9 8. Tipo de firma: Se selecciona el tipo de firma del comercio. 9. Tipo de moneda: Se selecciona la moneda de nuestro terminal TPV (Normalmente Euros). 10. Tipo de transacción: Se indica el tipo de transacción (Normalmente 0 ). 11. Activar idiomas: Se debe marcar como desactivada. 12. Recargo: Opción que permite utilizar un recargo en las operaciones procesadas mediante Redsys Currency: (Su configuración es opcional) Esta opción es útil si la moneda de pago no es la moneda de pago predeterminado. Versión: 1.0 6

Tipo de transacción: Se indica el tipo de transacción (Normalmente 0 ). 11. Activar idiomas: Se debe marcar como desactivada. 12.

10 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 REDSYS se le mostrará el siguiente resultado: Versión: 1.0 7

Documentos relacionados

Guía de integración del módulo de Redsys en Prestashop

Guía de integración del módulo de Redsys en Prestashop Versión: 2.4.3 15/01/2015 Referencia RS.DD.AGD.MAN.006 Ref RS.DD.AGD.MAN.006 Versión: 2.4.3 15/01/2015