Descripción
Este módulo permite realizar cobros con tarjeta desde WHMCS a través de la pasarela de Sermepa/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 6.x y 7.0
Funcionamiento del pago
- El cliente realiza una compra y elige como forma de pago la pasarela Sermepa/Redsys
- El cliente es redirigido a la pasarela del banco, donde se le solicitan los datos de la tarjeta y de validación
- El banco informa a WHMCS del resultado de la operación
- 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/sermepa/
whmcs/modules/gateways/sermepa.php
whmcs/modules/gateways/callback/sermepa.php
Activación
Desde el panel de administración accedemos a la pestaña Setup > Payments > Payment Gateways
En el dseplegable seleccionamos la pasarela Sermepa y pulsamos en el botón Activate
Configuración
Una vez activada la pasarela se mostrarán todas las opciones de configuración:
| Parámetro | Descripción |
| Show on Order Form | activa o desactiva la pasarela de pago en el formulario de pedidos |
| Display Name | 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
(**) 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/sermepa/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 Redsys | Error en registro de pasarela | Descripció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) |