Cómo instalar Bizum en Gravity Forms sin errores

Cobrar una reserva, una inscripción o un donativo desde un formulario no debería obligar al usuario a abandonar la página. Al instalar Bizum en Gravity Forms, el objetivo es precisamente ese: ofrecer un método de pago conocido en España dentro del flujo del formulario, con confirmación correcta y datos de cobro trazables para quien administra el sitio.

Pero Bizum no se añade como un campo más de Gravity Forms ni se configura solo con un número de teléfono. En la mayoría de proyectos WordPress, la operación depende de una pasarela bancaria compatible, normalmente RedSys, de las credenciales facilitadas por la entidad bancaria y de un plugin diseñado específicamente para conectar ese flujo con Gravity Forms.

Qué necesitas antes de instalar Bizum en Gravity Forms

El primer requisito es disponer de Bizum para comercio electrónico contratado con tu banco. No es lo mismo que tener Bizum activado como particular en la aplicación bancaria. Para cobrar desde una web, la entidad debe habilitar el servicio de pago online y proporcionar los datos técnicos asociados al comercio.

Según el banco y la configuración contratada, recibirás un código de comercio, un número de terminal, una clave de firma o secreto de encriptación, el entorno de pruebas y el entorno real. Estos datos son sensibles: no conviene compartirlos por correo, almacenarlos en documentos públicos ni introducirlos en un plugin que no gestione correctamente la comunicación con la pasarela.

También necesitas WordPress con Gravity Forms activo y un formulario que tenga sentido cobrar. Puede ser un formulario de reserva, una matrícula, una donación puntual, la venta de una entrada o una solicitud de servicio con importe variable. El cálculo del importe debe estar bien resuelto antes de conectar la pasarela. Si el formulario permite seleccionar opciones, cantidades o extras, revisa que las reglas de precios y los campos condicionales produzcan el total esperado.

Por último, hace falta un addon de pago compatible con Gravity Forms y Bizum. Una integración genérica de RedSys puede no cubrir el flujo de este método dentro del formulario, y una extensión creada para WooCommerce no sirve automáticamente en Gravity Forms. La compatibilidad concreta con la plataforma es el punto que evita instalaciones incompletas y procesos de pago rotos.

Cómo instalar Bizum en Gravity Forms paso a paso

El proceso es directo cuando se separan la instalación del plugin, la configuración bancaria y las pruebas. Intentar hacerlo todo en producción suele ser el origen de los errores más difíciles de diagnosticar.

Instala el addon específico para Gravity Forms

Descarga el plugin desde el proveedor elegido e instálalo desde el administrador de WordPress, en Plugins > Añadir nuevo > Subir plugin. Después, actívalo y verifica que aparece una sección de configuración de pagos o una nueva opción dentro de los ajustes del formulario.

Un addon bien integrado debe trabajar con los feeds de Gravity Forms. Un feed define cuándo se ejecuta el cobro, qué formulario lo activa, qué importe se envía y qué ocurre cuando el pago se aprueba o queda pendiente. Esta arquitectura permite tener distintos formularios con reglas de cobro diferentes sin mezclar configuraciones.

En proyectos con requerimientos técnicos específicos, una solución como la pasarela Bizum para Gravity Forms de Codection reduce el trabajo de desarrollo propio al centrarse en la compatibilidad entre el formulario y la operativa bancaria.

Introduce las credenciales de pruebas

Antes de usar datos reales, configura el entorno de pruebas si tu banco lo proporciona. Introduce el código de comercio, terminal, moneda, tipo de firma y clave de pruebas exactamente como aparecen en la documentación bancaria. Un espacio adicional, una clave equivocada o un terminal asociado a otro entorno pueden impedir que la petición llegue correctamente.

En esta fase, revisa además la URL de retorno o notificación configurada por el addon. La pasarela debe poder comunicar a WordPress el resultado definitivo de la operación. El retorno del navegador informa al cliente, pero la notificación del servidor es la que debe actualizar el estado de pago de forma fiable.

La web necesita HTTPS válido. No basta con que el formulario parezca seguro: el certificado debe estar activo, el sitio no debe cargar recursos inseguros y las URLs configuradas deben coincidir con el dominio final. Si se trabaja en un dominio temporal o en un entorno de staging, confirma que la pasarela acepta esa dirección para pruebas.

Crea el feed de pago en el formulario

Abre el formulario de Gravity Forms y entra en su área de pagos o feeds. Crea un nuevo feed de Bizum y asigna el importe. Si el formulario tiene un precio fijo, la configuración será sencilla. Si el total depende de productos, campos de cantidad o cálculos, selecciona el campo o total que el addon reconoce como importe final.

Conviene asociar datos internos útiles, como el correo electrónico, el nombre del cliente, el identificador de reserva o la referencia de pedido. Aunque Bizum no requiere que el comprador introduzca todos estos datos en la pasarela, conservarlos en la entrada de Gravity Forms facilita la conciliación posterior.

Las condiciones del feed merecen atención. Por ejemplo, una academia puede mostrar Bizum solo para pagos únicos, mientras que una organización puede usarlo únicamente en donativos nacionales. Si hay varios métodos de pago en el mismo formulario, las reglas condicionales deben impedir que dos feeds intenten cobrar la misma entrada.

Define el comportamiento después del pago

La confirmación no debe presentarse antes de recibir una respuesta válida de la pasarela. Configura la lógica para que el formulario quede marcado como pagado, aprobado o completado solo tras la notificación correcta. Si el cliente cancela, abandona el proceso o el banco rechaza la operación, la entrada debe reflejarlo sin activar reservas, correos finales o accesos de pago.

Aquí es habitual separar los mensajes. Un correo puede confirmar la recepción de la solicitud y otro, condicionado al pago aprobado, puede confirmar la plaza, el pedido o la reserva. Esta diferencia evita prometer un servicio que todavía no se ha cobrado.

Pruebas que conviene hacer antes de activar el entorno real

No basta con comprobar que el botón redirige a Bizum. Haz al menos una prueba de pago aprobado, una cancelación desde la pasarela y una operación rechazada. Después de cada caso, revisa la entrada en Gravity Forms, el estado del pago, los correos enviados y cualquier acción automática conectada al formulario.

Si el formulario dispara una integración con un CRM, crea una reserva en un calendario o entrega contenido, verifica que esas acciones ocurren solo cuando corresponde. En un sitio de eventos, por ejemplo, reservar una plaza tras un pago cancelado puede generar sobreventa. En donaciones, registrar una aportación como completada sin confirmación bancaria distorsiona los informes.

Cuando las pruebas estén correctas, sustituye las credenciales de pruebas por las de producción y cambia el entorno real en la configuración del addon. Haz un pago real de importe reducido si la operativa del negocio lo permite. Es la manera más segura de validar que las claves, el terminal y las notificaciones están asociados correctamente al entorno definitivo.

Errores frecuentes al configurar Bizum en Gravity Forms

El error más común es confundir Bizum entre particulares con Bizum para comercio electrónico. El primero no permite integrar un cobro automatizado en Gravity Forms. El segundo depende de un contrato de comercio y de la infraestructura de la entidad bancaria.

También es frecuente usar credenciales de pruebas en producción, o al contrario. El síntoma suele ser una pantalla de error en la pasarela, una firma inválida o una operación que no se registra en WordPress. Revisa siempre que código de comercio, terminal, clave y modo de operación pertenezcan al mismo entorno.

Otro problema aparece cuando WordPress recibe la vuelta del usuario, pero no la notificación del banco. Puede deberse a un firewall, a reglas de seguridad demasiado restrictivas, a una URL incorrecta o a una instalación que bloquea peticiones externas. En ese caso, el cliente puede ver una confirmación en su navegador mientras el formulario permanece pendiente. Los registros del plugin y los logs del servidor ayudan a localizar el punto de fallo.

Finalmente, evita editar el plugin para cambiar textos, importes o comportamientos básicos. Las modificaciones directas se pierden al actualizar y complican el soporte. Es preferible resolverlo con ajustes del formulario, filtros documentados o desarrollo a medida cuando la lógica del proyecto realmente lo exige.

¿Bizum es adecuado para cualquier formulario?

Bizum funciona especialmente bien para cobros únicos y audiencias que operan en España: reservas, matrículas, donativos, entradas y pagos de servicios. Su principal ventaja es la familiaridad del método para el usuario final, lo que puede reducir fricción en formularios donde pedir una tarjeta no aporta valor adicional.

No es necesariamente la mejor opción para todos los casos. Si necesitas pagos recurrentes, cobros internacionales o una suscripción con renovaciones automáticas, conviene valorar otros métodos y la capacidad concreta de tu banco y tu addon. También puede ser recomendable ofrecer tarjeta como alternativa, según el perfil de clientes y el tipo de operación.

La instalación correcta no termina al ver la pasarela activa. Un formulario de pago está listo cuando el importe llega bien al banco, la respuesta vuelve a WordPress, la entrada cambia de estado y el negocio ejecuta solo las acciones que corresponden a un cobro aprobado. Esa comprobación final es la que convierte una integración técnica en un proceso de venta fiable.

Nota: Hay una valoración incrustada en esta entrada, por favor, visita esta entrada para valorarla.

Almacenamos las IPs desde la que se envían las valoraciones para evitar fraudes