Módulo Pasarela CECA

Contenido[Ocultar]

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

  1. El cliente realiza una compra y elige como forma de pago la pasarela CECA
  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/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:

ceca 02 whmcs

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:

ceca 01 config

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