Pasarela Unificada de Redsys
Pasarela Unificada de Redsys
Pasarela Unificada de Redsys
Versión: 1.0
Fecha: 19/09/2022
Referencia: RS.ADQUI.CNOPRESENCECOMM.MAN.0015
EMITIDO POR: Rafael Román de VALIDADO POR: Dpto. de APROBADO POR: Dpto. de
los Reyes Comercio Electrónico Comercio Electrónico
ÍNDICE
OBJETIVO 4
SOFTWARE NECESARIO 5
La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta o cesión a terceros.
TIPOS DE INTEGRACIONES 7
INSTALACIÓN Y USO 11
7.1 PRESTASHOP 11
7.1.1 SOFTWARE NECESARIO 11
7.1.2 INSTALACIÓN 11
7.1.3 CONFIGURACIÓN DEL MÓDULO 12
7.1.4 REALIZACIÓN DE DEVOLUCIONES 15
7.2 WOOCOMMERCE PARA WORDPRESS 16
7.2.1 SOFTWARE NECESARIO 16
7.2.2 INSTALACIÓN 16
7.2.3 CONFIGURACIÓN DEL MÓDULO 18
7.2.4 REALIZACIÓN DE DEVOLUCIONES 20
7.3 MAGENTO 21
7.3.1 SOFTWARE NECESARIO 21
7.3.2 INSTALACIÓN 21
7.3.3 CONFIGURACIÓN DEL MÓDULO 23
7.3.4 REALIZACIÓN DE DEVOLUCIONES 24
8.1 PRESTASHOP 25
8.2 WOOCOMMERCE PARA WORDPRESS 25
8.3 MAGENTO 25
Objetivo
El presente documento tiene como objetivo detallar los pasos necesarios para la instalación del
módulo en las principales tiendas de comercio electrónico (Prestashop, WooCommerce para
Wordpress y Magento). Además, se pretende detallar todas las opciones de configuración y las
funcionalidades disponibles en el mismo, para así servir como guía de usuario y poder sacar el
La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta o cesión a terceros.
Software necesario
Redsys Servicios de Procesamiento S.L. (en adelante, Redsys), declara que, a los efectos de cumplir
con la normativa vigente en materia de protección de datos, Redsys actúa como encargado del
tratamiento por cuenta de sus clientes con los que tiene suscritos acuerdos en este sentido
conforme a GDPR. Redsys no será en ningún caso responsable de incumplimientos en materia de
La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta o cesión a terceros.
Tipos de integraciones
En este apartado, se procederá a detallar todas las integraciones de las que dispone el módulo. Por
defecto, todas las integraciones vienen desactivadas para que el comercio active sólo las que
necesite.
La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta o cesión a terceros.
El módulo permite a los clientes realizar pagos con tarjeta o utilizando Bizum. Desde la última
versión de los módulos por separado que ha estado disponible para su descarga, a este módulo
unificado, se han realizado numerosos cambios.
configuración propio, por lo que podrá utilizar un terminal para recibir los pagos con tarjeta
y otro para Bizum, por ejemplo.
• Pago OneClick: También conocido como “pago por referencia”, es una modalidad de pago
en la que el cliente puede guardar la tarjeta con la que va a pagar para que, la próxima vez
que vaya a realizar una operación, sólo tenga que seleccionar su tarjeta guardada. El
comercio no debe preocuparse por el cumplimiento de la política PCI-DSS ya que se
guarda una referencia asociada al comercio, y no los datos de la tarjeta en sí.
• Activación: Controle si el pago debe mostrarse a los clientes como opción de pago
disponible.
La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta o cesión a terceros.
• Clave de Encriptación SHA-256: Esta clave permite firmar todas las operaciones enviadas
por el módulo y ha debido ser provista de ella por su Entidad Bancaria. Recuerde guardarla
en un lugar seguro. Para realizar pruebas en el entorno Sandbox, puede usar:
sq7HjrUOBfKmC576ILgskD5srU870gJ7 o la provista por su Entidad Bancaria.
• Nombre del Comercio: Nombre de su comercio que se establecerá a la hora de enviar las
operaciones. El nombre del comercio no puede superar los 50 caracteres.
• Pago por Referencia: El Pago por Referencia, también conocido como pago 1-click,
permite al cliente guardar su tarjeta para futuras compras en formato de Token y de forma
totalmente segura.
• Pago seguro usando 3D Secure: Esta opción permite enviar información adicional del
cliente que está realizando la compra, proporcionando más seguridad a la hora de
autenticar la operación. Se recomienda dejar activada.
• Estado del pedido al verificarse el pago: Aquí puede configurar el estado en el que se
mostrará el pedido en el apartado "Pedidos" de su backoffice una vez el módulo reciba la
notificación de que el pago ha sido correcto.
• Permitir número de pedido extendido: Marque esta opción si su terminal está configurado
para admitir números de pedidos extendidos. Esto es útil para tiendas cuyos números de
pedidos podrían exceder las doce posiciones que tiene como máximo un número de
pedido estándar.
• URL para operaciones correctas: Este campo, denominado URL_OK, establece a qué
La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta o cesión a terceros.
página se redirigirá al cliente al volver de Redsys una vez la operación haya finalizado y
esta sea correcta. 'Si este campo se rellena, se ignorará la configuración del parámetro
establecida en el Portal de Administración del TPV Virtual. Tenga en cuenta que deberá
establecer este campo con la dirección completa de la página a la que quiere redirigir,
usando protocolo (https://) y dominio completos.
• URL para operaciones erróneas: 'Este campo, denominado URL_KO, establece a qué
página se redirigirá al cliente al volver de Redsys una vez la operación haya finalizado y
esta haya tenido algún error. Si este campo se rellena, se ignorará la configuración del
parámetro establecida en el Portal de Administración del TPV Virtual. Tenga en cuenta
que deberá establecer este campo con la dirección completa de la página a la que quiere
redirigir, usando protocolo (https://) y dominio completos.
Instalación y uso
7.1 Prestashop
7.1.1 Software necesario
Para el seguimiento de esta guía será necesario tener instalada la tienda on-line Prestashop,
La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta o cesión a terceros.
7.1.2 Instalación
Una vez instalado el sistema de Prestashop se deben seguir los siguientes pasos para la instalación
y configuración del módulo de Redsys:
1) Para la instalación del módulo de pago de Redsys hay que entrar en el área de
administración de la tienda virtual. En ella, seleccione la opción de “Módulos” o “Plugins”.
2) Se mostrará una pantalla con toda la información sobre los módulos que tenemos
instalados. En caso de tener instalada alguna versión anterior del módulo de pago Redsys,
se debe desinstalar y eliminar previo a la realización de los siguientes pasos.
a. Si se ha tenido otra versión anterior a la Pasarela Unificada de Redsys, es
recomendable acceder vía FTP a los archivos de la plataforma y comprobar que
no ha quedado ningún rastro del módulo antiguo, así como comprobar que no han
quedado claves residuales en la Base de Datos del comercio.
3) Pulsaremos sobre el botón “Añadir nuevo módulo” o “Subir módulo”. Según la versión de
Prestashop instalada.
a. Seleccionaremos el archivo comprimido redsyspur.zip que se encuentra dentro
del archivo comprimido que hemos descargado de la web de desarrolladores.
4) Si el módulo se ha subido correctamente, se podrá visualizar un mensaje de confirmación.
5) Una vez hecho esto, el módulo estará instalado en el sistema Prestashop y tan solo faltará
habilitar el módulo y configurarlo para poder operar con él.
Y, por último, las configuraciones adicionales del módulo, que son comunes a dos o más
integraciones y se han situado en este apartado para evitar la duplicidad de opciones.
La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta o cesión a terceros.
En esta pantalla, es necesario pulsar sobre el botón “Reembolso parcial”. En algunas versiones de
Prestashop, se dispone también del botón “Reembolso total” y se puede usar si queremos realizar
un reembolso total, pero el primero mencionado también vale para este cometido como se verá a
continuación. Una vez pulsado el botón, se abrirá un cuadro de diálogo donde se podrán detallar
los parámetros de la devolución.
Si se ha pulsado en este botón y se quiere realizar una devolución total, se puede rellenar el
apartado de “Cantidad” del producto y el importe se actualizará sólo. Cuando todo esté conforme,
se deberá pulsar el botón de confirmación.
7.2.2 Instalación
Para realizar la instalación y configuración del Plugin de Redsys, debe haberse instalado antes la
extensión de Woocommerce, de lo contrario la web podría quedar inaccesible, aunque el módulo
tiene métodos para detectar que no se están cumpliendo los requistos. En cualquier caso, si esto
pasase, borre la carpeta ‘redsyspur’ del módulo recién instalado de la carpeta del módulo en
Wordpress. Usualmente esta carpeta se encuentra en
{instalación_wordpress}/wp-content/plugins
Una vez eliminada, la web debería volver a funcionar y cargar correctamente. Si se cumplen los
requisitos, los pasos para realizar la correcta instalación son los siguientes:
1) Acceder al apartado ‘plugins’ del backoffice de la tienda, seguidamente, se selecciona la
opción ‘añadir nuevo’ del menú desplegable.
2) En la parte superior, se debe pulsar sobre el botón ‘subir plugin’. Una vez hecho, aparecerá
un cuadro para poder seleccionar un archivo comprimido para subir.
a. Se debe seleccionar el archivo comprimido redsyspur.zip que se encuentra dentro
del archivo comprimido que se ha descargado de la web de desarrolladores.
3) Una vez se ha subido este archivo, se puede proceder a la activación. Ahora el módulo
aparecerá activado en la lista de plugins o extensiones de Wordpress. Desde esta lista, se
puede acceder directamente a la configuración del módulo.
En este punto, ya se ha realizado la instalación del módulo y las tres opciones de integración
deberían aparecer desactivadas. En Wordpress, los tres métodos de pago están por separado, y la
configuración se debe hacer uno por uno. Para configurar cada método de pago, se deberá pulsar
sobre el botón “Configuración” o “Gestionar” de cada opción.
Las opciones de configuración son prácticamente similares en los tres tipos de integración por lo
que sólo se detalla la opción de configuración de la pasarela de redirección.
Todas las configuraciones sólo afectan al módulo donde se configura, por lo que si se quiere utilizar
el mismo terminal para el pago por tarjeta y para el pago con Bizum, se deberá realizar la
configuración en los dos módulos.
La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta o cesión a terceros.
Una vez en los detalles de la orden, se deberá buscar la opción de “Reembolso” y pinchar en ella.
Esto abrirá un menú en el que se deberán rellenar los datos de la devolución. En esta plataforma,
sí que se deberán poner manualmente el importe a devolver, además de tener un recuadro donde
indicar el motivo de la devolución.
Una vez rellenos todos los campos, se debe pulsar sobre el botón que realiza la devolución usando
la pasarela de Redsys. Si todo va correctamente, se recibirá un mensaje de confirmación.
7.3 Magento
7.3.1 Software necesario
Para poder realizar el seguimiento de esta guía es necesario tener instalados los siguientes
módulos:
• Software de acceso vía FTP a los archivos del servidor donde está instalada la tienda
virtual como, por ejemplo, FileZilla.
Además, deberá disponer de la última versión del módulo de pago, descargado desde la web de
pagosOnline de Redsys.
7.3.2 Instalación
Para llevar a cabo la instalación, se deberá descomprimir el archivo que se ha descargado desde la
web de pagosOnline de Redsys. Hecho esto, es necesario acceder vía FTP a los archivos del
servidor.
1) Verificar que existe la ruta {instalación_magento}/app/code. Si esta ruta no estuviera
disponible (posiblemente la carpeta ‘code’ no exista), crearla. En esta ruta, se debe situar
la carpeta que se ha descomprimido primeramente. La arquitectura de ficheros debe
quedar como sigue:
2) Para ver el módulo de pago una vez seguidos estos pasos, se debe compilar la plataforma
y actualizar los estáticos. Para ello, es necesario moverse a {instalación_magento}/bin y en
este directorio ejecutar los siguientes comandos por consola:
php magento setup:upgrade
php magento setup:static-content:deploy -f
php magento cache:clean
php magento cache:flush
Las opciones de configuración son prácticamente similares en los tres tipos de integración por lo
que sólo se detalla la opción de configuración de la pasarela de redirección.
Todas las configuraciones sólo afectan al módulo donde se configura, por lo que si se quiere utilizar
el mismo terminal para el pago por tarjeta y para el pago con Bizum, se deberá realizar la
configuración en los dos módulos.
Una vez abierta la orden, se debe pinchar en el apartado de facturas, y encontrar la factura que se
ha generado al realizar el pedido. Una vez en ella, se deberá pulsar sobre el botón que dice “Credit
Memo”, también puede poner “Devolución” en caso de que la plataforma esté traducida. Una vez
pulsado el botón, la plataforma se actualizará y en la parte baja se mostrará los datos con los que
realizar la devolución.
Cuando los datos estén listos, se podrá realizar la devolución pulsando sobre “Refund” o
“Devolución”.
8.1 Prestashop
• Tras activar el módulo y configurarlo, no aparece ningún método de pago de los
disponibles en la plataforma.
La propiedad intelectual de este documento pertenece a Redsys. Queda prohibida su reproducción, venta o cesión a terceros.
Esto puede deberse a que se haya activado el modo depuración de la tienda que, en
algunos casos, desactiva todos los métodos de pago. También se debe revisar en el
apartado de métodos de pago, que el módulo esté activado para las regiones y las divisas
correctas.
• Pese a que guardo la configuración en los ajustes del módulo, esta no se aplica y cuando
vuelvo a entrar a la configuración no se ha guardado correctamente.
Esto es debido a que el módulo no está pudiendo actualizar correctamente las claves en la
base de datos. En este caso es recomendable desinstalar el módulo para que limpie la base
de datos y se vuelva a instalar. Si el problema persiste, se pueden cambiar los ajustes
directamente en la base de datos, dentro de la tabla ps_configuration, todas las claves que
contengan “REDSYS”.
8.3 Magento
• El módulo no me aparece en la configuración de los métodos de pago.
Es posible que no se haya compilado bien la plataforma. Pruebe a repetir de nuevo la
secuanecia de comandos. Si el problema persiste, ejecute primero el comando
php magento setup:di:compile
Hecho esto, si sigue sin ver el módulo, revise los logs de la Plataforma.