Una organización puede tener un formulario de donación bien diseñado y una causa convincente, pero si el cobro falla al volver desde el banco, la donación queda en espera o el donante no recibe confirmación. Añadir CECA a GiveWP requiere resolver precisamente esa parte: conectar el formulario con la pasarela bancaria, enviar la operación correctamente y actualizar su resultado dentro de WordPress.
La integración no consiste solo en mostrar un botón de pago con tarjeta. GiveWP necesita saber cuándo una donación ha sido aprobada, cancelada o rechazada para registrar el importe, enviar los recibos y mantener los informes financieros correctos. Por eso conviene plantear la configuración como un flujo completo, no como una simple conexión de credenciales.
Qué necesitas antes de conectar CECA
El punto de partida es disponer de una cuenta de comercio activa con CECA y tener habilitado el pago por internet. El banco o la entidad adquirente facilitará los datos necesarios para operar, que pueden variar según el contrato: identificador de comercio, terminal, claves de firma, entorno de pruebas y URL de acceso a la pasarela.
También debes revisar qué versión y configuración de GiveWP utiliza el sitio. No todas las pasarelas de pago funcionan como extensiones intercambiables sin ajustes. Una integración desarrollada para GiveWP debe ser compatible con el sistema de formularios, el proceso de creación de donaciones y la gestión de estados del plugin.
Antes de instalar nada, confirma tres aspectos. El primero es que el certificado SSL está activo en todo el sitio, no únicamente en la página de donación. El segundo es que WordPress puede recibir peticiones externas sin bloqueos del firewall, caché o plugins de seguridad. El tercero es que tienes acceso a los ajustes técnicos de CECA para configurar las URLs de notificación y retorno.
Cómo añadir CECA a GiveWP sin perder el control del pago
La forma más fiable de añadir CECA a GiveWP es utilizar una pasarela creada específicamente para este plugin o desarrollar una integración a medida que siga su arquitectura. Intentar reutilizar un módulo pensado para WooCommerce, un formulario genérico o un sistema de reservas suele causar problemas: cada plataforma crea, confirma y almacena los pagos de forma distinta.
Una vez instalada la extensión compatible, CECA debe aparecer como método de pago dentro de los ajustes de GiveWP. Desde ahí se introducen las credenciales suministradas por la entidad bancaria y se selecciona el entorno adecuado. Durante las pruebas, utiliza siempre las claves de test. Mezclar una URL de pruebas con credenciales de producción es una causa habitual de errores de firma y respuestas inválidas.
El proceso correcto suele seguir esta secuencia: GiveWP crea una donación pendiente, el donante es redirigido a la página segura de CECA, realiza la autenticación requerida por su banco y CECA comunica el resultado al sitio web. Solo tras validar esa comunicación, la donación debe pasar a completada.
Ese último paso es el que más atención merece. La página de retorno que ve el donante sirve para mejorar su experiencia, pero no debería ser la única fuente de confirmación. Un usuario puede cerrar el navegador antes de volver al sitio, perder la conexión o modificar la URL. La notificación servidor a servidor de CECA es la que permite confirmar el cobro con mayor seguridad.
Configura las URLs de retorno y notificación
Según el modelo de integración de CECA, tendrás que indicar una URL para la respuesta del pago y, en algunos casos, una URL de retorno para éxito, cancelación o error. La extensión de GiveWP debe proporcionar estas direcciones o gestionarlas internamente.
No sustituyas estas URLs por la página pública del formulario de donación salvo que la documentación técnica de la integración lo indique expresamente. La notificación necesita llegar a un endpoint preparado para verificar la firma, localizar la donación pendiente y actualizar su estado. Una página normal de WordPress no cumple esa función por sí sola.
Comprueba además que la URL utiliza HTTPS, no redirige varias veces y no exige inicio de sesión. Si una regla de seguridad bloquea las solicitudes del banco por su dirección IP, agente de usuario o método POST, el donante podría ver el pago aprobado en su banco mientras GiveWP mantiene la donación como pendiente.
Verifica firma, importe y estado de la operación
Una integración bancaria seria no debe dar por válida una respuesta solo porque llega a una URL concreta. La respuesta de CECA tiene que verificarse con la firma o mecanismo de autenticación definido por el banco. Asimismo, el sistema debe comparar el importe recibido con el importe previsto y vincular el pedido bancario con la donación creada en GiveWP.
Esta validación evita errores operativos y reduce el riesgo de que una petición manipulada marque donaciones como pagadas. El identificador de operación debe ser único y trazable. Si el donante intenta pagar dos veces o vuelve atrás en el navegador, la integración debe evitar duplicar el registro de ingresos.
En GiveWP, los estados son relevantes para la operativa diaria. Una donación pendiente no debe activar mensajes de agradecimiento propios de una donación confirmada, ni incluirse como ingreso efectivo en los informes. Las operaciones rechazadas o canceladas deben conservar información suficiente para que el administrador pueda revisar el caso sin almacenar datos sensibles de tarjeta.
Pruebas que conviene hacer antes de publicar
No actives CECA en producción sin realizar pruebas completas. El objetivo no es comprobar únicamente que aparece la pantalla de pago, sino validar el ciclo entero desde el formulario hasta el estado final de la donación.
Prueba una operación autorizada y verifica que GiveWP la marca como completada, que el importe coincide y que el donante recibe la confirmación correspondiente. Después prueba una operación cancelada y otra rechazada. En ambos casos, revisa que no se contabilicen como ingresos y que el usuario reciba un mensaje claro para volver a intentarlo o elegir otro método de pago.
También es recomendable revisar qué ocurre si el donante paga correctamente pero no regresa al navegador. Si la notificación de CECA está bien configurada, GiveWP debería actualizar la donación aunque la página final no llegue a cargarse. Esta prueba detecta muchas integraciones que parecen funcionar en una demostración, pero fallan en condiciones reales.
Por último, consulta los registros de la pasarela y de WordPress. Los logs ayudan a identificar firmas incorrectas, respuestas mal formadas, peticiones bloqueadas y errores de comunicación. Activa registros técnicos solo mientras los necesites y evita guardar claves privadas, datos bancarios completos o información personal innecesaria.
Errores frecuentes al integrar CECA en donaciones
El error más común es configurar únicamente el retorno visual del donante y olvidar la notificación bancaria. El segundo es usar datos de producción antes de haber terminado las pruebas. También aparecen incidencias cuando un plugin de caché sirve una versión antigua del formulario, cuando una herramienta de seguridad bloquea la llamada externa o cuando el servidor limita solicitudes POST.
Otro problema habitual es tratar las donaciones recurrentes como si fueran cobros únicos. Si tu entidad necesita cuotas mensuales, revisa antes si el contrato CECA y la integración disponible soportan tokenización, pagos recurrentes o el modelo específico requerido. No todos los contratos de comercio ni todas las pasarelas para GiveWP cubren esta necesidad.
La compatibilidad con SCA y autenticación reforzada también debe considerarse desde el inicio. En pagos con tarjeta dentro del Espacio Económico Europeo, el flujo de autenticación puede redirigir al donante a su banco. La pasarela debe manejar esa vuelta sin perder la referencia de la donación ni crear registros duplicados.
Cuándo usar una integración específica o un desarrollo a medida
Una extensión ya preparada es la opción más eficiente cuando el proyecto utiliza el flujo estándar de GiveWP: donación única, pago con tarjeta, respuesta bancaria y recibo automatizado. Reduce el tiempo de implementación y permite mantener el método de pago dentro de la administración habitual de WordPress.
Un desarrollo a medida tiene sentido cuando existen requisitos fuera de ese flujo. Por ejemplo, una entidad puede necesitar campos de referencia propios, conexión con un CRM, conciliación contable, reglas distintas por campaña o una experiencia de confirmación personalizada. En esos casos, adaptar la integración al proceso real evita depender de soluciones genéricas que no conocen la operativa bancaria española.
Codection trabaja este tipo de compatibilidades con un enfoque centrado en la pasarela, el plugin concreto y el proceso de cobro final. La decisión correcta depende menos del número de opciones disponibles y más de que CECA pueda informar a GiveWP del resultado de cada operación de forma verificable.
Antes de abrir el formulario al público, realiza una última donación de prueba desde el punto de vista del donante y otra desde el panel de administración. Si ambos lados coinciden – cobro, estado, recibo e informe – tendrás una base fiable para que cada aportación llegue donde debe llegar.