Descripción
Este módulo permite realizar cobros con tarjeta desde WHMCS a través de la pasarela CECA.
Esta pasarela de pago es utilizada por muchas entidades España (Caixabank, Bankia, Ibercaja, Unicaja, Cajasur, etc)
El módulo está comprobado y validado para WHMCS versión 7.6
Funcionamiento del pago
- El cliente realiza una compra y elige como forma de pago la pasarela CECA
- 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/ceca/
whmcs/modules/gateways/ceca.php
whmcs/modules/gateways/callback/ceca.php
Activación
Desde el panel de administración accedemos a la pestaña Setup > Payments > Payment Gateways
En el dseplegable seleccionamos la pasarela CECA 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 |
| Código comercio (MerchantID) | Código identificativo del comercio (se extrae del TPV) |
| Código entidad (AcquirerBIN) | Código identificativo de la Caja (se extrae del TPV) |
| Clave de encriptación | Clave para firmar las llamadas al TPV (se extrae del TPV) |
| Terminal ID | Número de terminal proporcionado por nuestra Caja |
| Exponente | Actualmente será siempre 2 |
| Tipo moneda | Código ISO-4217 correspondiente a la moneda (978 para euros) |
| Entorno de Pruebas | Usar la URL de pruebas o el modo real |
| 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 (*) |
(*) 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/ceca/img
En este directorio existe un archivo llamado "blank.psd" que es una plantilla de Photoshop para crear nuevos botones
Algunos de los campos para configurar el módulo en WHMCS se pueden extraer directamente de la consola de administración de CECA:
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