Un formulario de reserva, inscripción o solicitud puede convertirse en un punto de cobro directo. Para instalar CECA en Contact Form 7 correctamente no basta con añadir un campo de importe: hay que conectar el formulario con el entorno bancario, definir qué ocurre antes y después del pago y verificar que la operación queda confirmada aunque el cliente cierre la pestaña.
Esta integración es especialmente útil cuando no necesitas un carrito completo de WooCommerce. Por ejemplo, para cobrar una señal de reserva, una matrícula, una donación puntual, una inscripción a un evento o un servicio con precio fijo. Contact Form 7 recoge los datos y CECA procesa el pago en la pasarela bancaria.
Qué necesitas antes de configurar CECA
La parte técnica empieza fuera de WordPress. Debes tener contratado el servicio de comercio electrónico con tu entidad bancaria y solicitar acceso a CECA. El banco facilitará los datos necesarios para identificar el comercio y firmar las operaciones. Sin estas credenciales, ningún plugin podrá enviar cobros reales.
Normalmente necesitarás el número de comercio, el terminal, la clave secreta o clave de firma y las direcciones del entorno de pruebas y producción. El nombre exacto de cada dato puede variar según la documentación de tu banco y la versión de la plataforma CECA. Conviene conservar esa información en un lugar seguro y no enviarla por correo sin protección.
También necesitas una instalación de WordPress actualizada, Contact Form 7 activo y un certificado SSL válido. La página donde el usuario completa el formulario, las páginas de retorno y todo el sitio deben funcionar mediante HTTPS. Aunque la tarjeta se introduce en el entorno bancario, un sitio sin HTTPS genera desconfianza y puede provocar problemas con las URLs de notificación.
Por último, instala un plugin específicamente compatible con CECA y Contact Form 7. Es importante comprobar esta compatibilidad de forma explícita. Un módulo creado para WooCommerce no añade pagos a los formularios de Contact Form 7, ya que ambos plugins gestionan datos, pedidos y estados de forma distinta.
Instalar CECA en Contact Form 7 sin perder datos
Antes de hacer cambios, crea una copia de seguridad de la web y, si es posible, trabaja primero en un entorno de pruebas. No es una precaución excesiva: un error en la configuración de retorno puede hacer que el pago se complete en el banco pero no quede registrado como esperas en WordPress.
Instala y activa el plugin de pasarela CECA para Contact Form 7 desde el archivo proporcionado por el desarrollador o desde el repositorio correspondiente. Tras la activación, localiza su página de ajustes. Según el plugin, puede aparecer dentro del menú de Contact, en Ajustes o como un apartado propio de pagos.
Introduce las credenciales de CECA en los campos indicados y activa inicialmente el modo de pruebas. No copies espacios al principio o al final de las claves. Una clave con un carácter adicional es suficiente para invalidar la firma de las operaciones y generar errores difíciles de interpretar.
En esta fase debes configurar las URLs que intervienen en el proceso. La URL de retorno es la página a la que se redirige al cliente al finalizar el pago. La URL de notificación, también llamada respuesta online o callback según la entidad, es la dirección que CECA utiliza para comunicar el resultado al sitio. Esta segunda comunicación es la que debe tener prioridad al actualizar el estado interno de una operación.
La redirección del cliente no garantiza que el pago haya sido aceptado. Puede cerrar la ventana, perder la conexión o volver atrás después de pagar. Por eso, el plugin debe validar la notificación firmada recibida desde CECA antes de marcar una reserva, una inscripción o una solicitud como pagada.
Crear el formulario de cobro
Una vez guardados los ajustes generales, crea o edita el formulario en Contact Form 7. Incluye los datos imprescindibles para identificar la solicitud: nombre, correo electrónico, teléfono si es necesario y el servicio o modalidad seleccionada. Pide solo lo que vaya a utilizarse en la gestión posterior. Formularios más cortos suelen reducir abandonos.
El importe puede ser fijo o depender de una selección del usuario. Para un pago fijo, como una reserva de 50 euros, la configuración es más sencilla y reduce riesgos. Para importes variables, el plugin debe poder asociar de forma segura cada opción con una cantidad válida. No conviene confiar únicamente en un campo de texto editable por el visitante para determinar el importe a cobrar.
Si vendes varias modalidades, configura una lista desplegable o botones de opción y asigna el importe desde la lógica del plugin. Por ejemplo, una inscripción general, una inscripción reducida y una reserva de plaza. Comprueba que la etiqueta visible para el usuario coincide con la cantidad enviada a CECA.
En los ajustes de pago vinculados al formulario, selecciona la pasarela CECA, define la moneda admitida y establece la descripción que recibirá la operación. Una referencia clara ayuda a conciliar movimientos posteriormente. En vez de usar una descripción genérica como “Pago web”, utiliza algo identificable, como “Reserva consulta septiembre” o “Inscripción jornada profesional”.
Define cuándo se envían los correos
Contact Form 7 puede enviar un email cuando se remite el formulario, pero ese momento no equivale necesariamente a un pago aprobado. Si el correo confirma una reserva antes de validar CECA, el usuario puede interpretar que tiene plaza aunque abandone el proceso bancario o su tarjeta sea rechazada.
Lo adecuado es diferenciar entre una notificación de solicitud recibida y una confirmación de pago. La primera puede servir al equipo interno para revisar la petición. La segunda debe enviarse solo cuando el plugin haya recibido y validado la respuesta correcta de CECA.
Si tu operativa requiere intervención manual, como la asignación de fechas o la comprobación de disponibilidad, comunica al cliente que el pago confirma la solicitud o la señal, no necesariamente el servicio final. El texto debe reflejar el flujo real de tu negocio.
Pruebas que debes realizar antes de pasar a producción
El modo de pruebas permite revisar el ciclo completo sin cobrar a clientes reales. Haz pruebas con los datos de tarjeta de prueba proporcionados por CECA o por tu entidad. Si el banco no ha habilitado un entorno de pruebas para tu comercio, solicita el procedimiento recomendado antes de activar pagos en directo.
No pruebes solo una compra correcta. Necesitas comprobar qué sucede cuando la operación es aceptada, rechazada o cancelada por el usuario. Revisa también el comportamiento si este vuelve a la web desde el navegador sin completar el pago.
Durante cada prueba, verifica cuatro elementos: que el importe mostrado coincida con el configurado, que CECA reciba la referencia correcta, que la notificación llegue al sitio y que el registro final quede con el estado esperado. Si el plugin genera registros de transacciones, anota el identificador de cada operación para contrastarlo con el panel bancario.
Cuando el flujo funcione, cambia las credenciales al entorno real y desactiva el modo de pruebas. Haz una operación de importe reducido para confirmar que las URLs de producción, la firma y los correos se comportan igual que en el entorno de pruebas.
Errores habituales al integrar CECA con Contact Form 7
El error más común es mezclar credenciales de pruebas con la URL de producción, o al contrario. Cada entorno tiene su propia configuración y no son intercambiables. Otro fallo frecuente es configurar una página de gracias como si fuera la notificación bancaria. La página visible al cliente puede ser útil, pero no sustituye la verificación automática del servidor.
También aparecen incidencias cuando un plugin de caché guarda una versión antigua de la página de retorno, cuando un firewall bloquea peticiones externas o cuando una regla de seguridad impide que CECA acceda a la URL de notificación. Si los pagos figuran como aprobados en el banco pero no en WordPress, revisa primero los registros del plugin, los logs del servidor y los bloqueos del firewall.
Los campos dinámicos requieren atención adicional. Si el cliente selecciona una opción y el importe se modifica con JavaScript, debes confirmar que el valor final enviado al servidor no puede ser manipulado. La validación del importe debe ocurrir en la lógica del plugin o en el servidor, no solo en el navegador.
Por último, evita modificar directamente archivos del plugin para adaptar textos o reglas de negocio. Esos cambios se perderán con una actualización y complicarán el soporte. Si necesitas campos, reglas de precio, reservas o acciones posteriores al pago que el plugin estándar no cubre, un desarrollo a medida suele ser una solución más mantenible. Codection trabaja precisamente con integraciones de pago para WordPress cuando la operativa requiere ajustes específicos.
Un cobro desde formulario funciona bien cuando respeta una idea simple: el formulario recoge la solicitud, CECA autoriza el pago y el sitio actúa únicamente después de validar esa respuesta. Mantener esa separación te permitirá gestionar reservas, inscripciones y servicios con menos incidencias y con una trazabilidad mucho más clara.