Documentación Pasarela Redsys

Contenido[Ocultar]

Descripción

Este módulo permite realizar cobros con tarjeta desde WHMCS a través de la pasarela de Redsys.
Esta pasarela de pago es la más usada por bancos y cajas en España
El módulo está comprobado y validado para WHMCS versión 7.x

Funcionamiento del pago

  1. El cliente realiza una compra y elige como forma de pago la pasarela Redsys
  2. El cliente es redirigido a la pasarela del banco, donde se le solicitan los datos de la tarjeta y de validación
  3. El banco informa a WHMCS del resultado de la operación
  4. El cliente es redirigido de nuevo a WHMCS

De esta forma, todos los datos de la tarjeta se gestionan fuera de WHMCS y no se almacena ningún dato sensible

Instalación

Para la instalación del módulo basta con descomprimir el paquete y subirlo a la raíz de WHMCS.
Esto nos creará dos archivos y un directorio

whmcs/modules/gateways/redsys/
whmcs/modules/gateways/redsys.php
whmcs/modules/gateways/callback/redsys.php

Activación

Desde el panel de administración accedemos a la pestaña Setup > Payments > Payment Gateways
En el dseplegable seleccionamos la pasarela Redsys y pulsamos en el botón Activate

Configuración

Una vez activada la pasarela se mostrarán todas las opciones de configuración:

01-configuracion

Parámetro Descripción
Show on Order Form activa o desactiva la pasarela de pago en el formulario de pedidos
Nombre a mostrar Nombre asignado a la pasarela
Nombre del comercio Nombre de nuestro comercio que aparecerá en la pasarela
Código del comercio (FUC) Código único de comercio proporcionado por nuestro banco
Clave SHA256 Clave para el uso de SHA256 (obligatorio desde 23-11-2015)
Num. Terminal número de terminal proporcionado por nuestro banco
Moneda del Terminal código de la moneda, seleccionamos 978 para euros
Tipo Transacción Tipo de operación a realizar (dejar en 0 para realizar pagos normalmente)
Recargo variable Comisión variable que nos cobra el banco (*)
Recargo fijo Comisión fija que nos cobra el banco (*)
Entorno de Pruebas Usar la URL de pruebas o el modo real
Forzar URL Callback Permite especificar una URL para la respuesta del TPV
Modo depuración Guarda registro de las operaciones (usar sólo cuando se solicite)
Botón de pago texto que aparecerá en la factura para realizar el pago
Imagen de botón En lugar de usar un texto, es posible usar una imagen del desplegable (**)

 

(*) Recargo/Comisión

Esta comisión NO se aplica a los clientes, sólo se usa para calcular el ingreso real que supone una transacción

03-transacciones

 

(**) Imagen del botón

Es posible crear una nueva imagen para otra entidad bancaria.
Puedes añadir tu imagen personalizada en el directorio modules/gateways/redsys/img
En este directorio existe un archivo llamado "blank.psd" que es una plantilla de Photoshop para crear nuevos botones

 

Depuración de errores

La pasarela de pago guarda un registro de actividad al que se accede desde Billing > Gateway log
Aquí aparecerán los datos recibidos por la pasarela (la respuesta del banco) y el resultado de la operación.

Además, al realizar una transacción se almacena en el registro general: Utilities > Logs > Activity Log

Códigos de error

Los siguientes códigos de error aparecen en la pasarela de Redsys, dentro de la sección Notificaciones y sirven para indicar la causa del error en el callback (notificación del resultado de la operación del banco a WHMCS)

Error en RedsysError en registro de pasarelaDescripción
501 Gateway Error ERROR 001 en parametros recibidos No se han recibido todos los parámetros que se esperaban
503 Gateway Error ERROR 002 en la firma La firma que nos envía el banco no coincide con la nuestra
503 Gateway Error ERROR 003 en importe (XX/YY) El importe de la factura (XX) no coincide con el que nos envía el banco (YY)
504 Gateway Error ERROR 004 en respuesta (ZZ) El banco ha denegado la operación (motivo: ZZ)