Descripción
Este plugin integra la pasarela de pago de ifthenpay con GiveWP para que los donantes puedan pagar con los métodos de pago locales más populares de Portugal, directamente desde tus formularios de donación.
Las donaciones se procesan a través del sistema seguro Pay-By-Link de ifthenpay — nunca se almacenan datos de tarjeta o bancarios en tu sitio web.
Después de iniciar una donación, el donante es redirigido a una página de pago segura alojada por ifthenpay para completar la transacción. Ifthenpay notifica entonces a tu sitio mediante un callback servidor a servidor para que el estado de la donación se actualice automáticamente, incluso para métodos offline/asíncronos como Multibanco y Payshop.
En pocas palabras, obtienes:
* Donaciones puntuales a través de los formularios de donación de GiveWP
* Un proceso de «Connect Backoffice» para vincular tu cuenta de ifthenpay con unos pocos clics
* Sincronización automática de los métodos de pago (con logotipos en modo claro u oscuro) desde tu Backoffice de ifthenpay
* Dos diseños de campos para el formulario de donación: una tarjeta completa o una fila compacta integrada
* Confirmación de pago segura y automática mediante callback de servidor a servidor
* Compatibilidad con Multibanco, MB WAY, Payshop, tarjeta de crédito y más
* No se almacenan números de tarjeta en tu sitio web
Todos los ajustes se gestionan dentro de GiveWP y tu Backoffice de ifthenpay. El plugin está diseñado para que los propietarios del sitio puedan gestionar donaciones sin necesitar conocimientos técnicos avanzados.
Características principales
- Integración completa con el flujo de pasarela de pago de formularios de donación de GiveWP
- Transacciones seguras mediante ifthenpay Pay-By-Link (redirección externa a un checkout alojado)
- Confirmación de pago automática, servidor a servidor (funciona para métodos asíncronos/offline como Multibanco y Payshop)
- Compatibilidad con múltiples métodos de pago (Multibanco, MB WAY, Payshop, Tarjeta de Crédito y más)
- Flujo «Conectar Clave de Backoffice» con sincronización automática de clave de pasarela y métodos de pago (logotipos claros y oscuros)
- Dos diseños de campo para el formulario de donación — tarjeta completa o fila compacta en línea — con tema claro/oscuro/automático
- Estado de la donación en tiempo real en GiveWP
- Compatibilidad multilingüe (EN, ES, FR, PT)
- Enfoque centrado en la seguridad (ningún dato de tarjeta almacenado)
Requisitos
- Una cuenta de comerciante de ifthenpay activa.
- Una Clave de Pasarela GiveWP configurada para GiveWP (solicítala al soporte de ifthenpay).
- Clave de Backoffice
- WordPress 6.5+ y PHP 8.2+, con GiveWP instalado y activado.
- HTTPS (SSL) activado en tu sitio.
- WP-Cron en funcionamiento — el cron predeterminado de WordPress (activado por visitas al sitio) o una tarea cron real a nivel de servidor que acceda a wp-cron.php. Es necesario para que el estado de la donación se actualice después del callback de ifthenpay; consulta las Preguntas Frecuentes más abajo si has desactivado WP-Cron.
Servicios externos
Este plugin se integra con la plataforma de pago de ifthenpay para procesar pagos de los formularios de donación de GiveWP. Ifthenpay es un servicio de terceros que proporciona procesamiento de pagos seguro para Multibanco, MB WAY, Payshop, Tarjeta de Crédito y otros métodos de pago locales portugueses.
-
GiveWP
- Qué es y para qué sirve: Un complemento para la gestión de donaciones. Este complemento registra «ifthenpay» como una de sus pasarelas de pago para que los donantes puedan seleccionarla al finalizar la compra.
-
ifthenpay: Backoffice e integraciones
- Qué es y para qué sirve: El Backoffice de ifthenpay es el panel de control para comerciantes que se utiliza para gestionar las integraciones y las configuraciones de pago. El complemento utiliza la API de ifthenpay para consultar tus claves de pasarela y métodos de pago, generar enlaces de pago «Pay-By-Link» y registrar la URL de devolución de llamada de servidor a servidor.
- Qué datos se envían y cuándo:
- Durante la configuración: la Clave de Backoffice (para listar tus Claves de Pasarela GiveWP disponibles) y la Clave de Pasarela (para registrar la URL de callback).
- Durante el procesamiento del pago: el ID de la donación, el importe, la descripción, el idioma, la fecha de caducidad del enlace, las cuentas de métodos de pago activados, las URL de retorno de éxito/error/cancelación, y el método de pago preseleccionado (si lo hay).
- Durante los callbacks: el ID de la donación, una clave antiphishing, el importe pagado, el ID de solicitud de ifthenpay, y, en caso de pago fallido o cancelado, un código de estado.
- Al solicitar la activación de un nuevo método de pago: la Clave de Backoffice, la Clave de Pasarela, el método de pago, tu correo de administrador de WordPress, y la URL, nombre, versión de WordPress, versión de GiveWP y versión del plugin de tu sitio, enviados por correo al soporte de ifthenpay (suporte@ifthenpay.com).
- Requisitos de red y VPN: Se realizan solicitudes HTTPS salientes a las API de ifthenpay para la configuración, la generación de enlaces y la validación del estado. Los servidores protegidos por cortafuegos estrictos o VPN salientes restrictivas deben incluir en la lista de dominios permitidos los siguientes dominios para evitar que se agote el tiempo de espera de la conexión:
- api.ifthenpay.com
- ifthenpay.com
- Acuerdo de licencia de usuario final (EULA): EULA
- Política de privacidad: Política de privacidad
Todas las solicitudes de red se realizan del lado del servidor mediante HTTPS. Las credenciales sensibles se almacenan de forma segura y no están expuestas públicamente. No se almacenan datos brutos de tarjeta ni bancarios.
Licencia
Este plugin está licenciado bajo la GPLv3.
Asistencia
Si necesitas ayuda, utiliza el foro de soporte de WordPress.org:
Comprobaciones previas a la publicación:
* El método de pago debe estar habilitado en Gateway Key Y asociado a tu integración con GiveWP
* Debes utilizar las versiones actuales recomendadas de WordPress, PHP y GiveWP
* WP-Cron debe estar en funcionamiento (o una tarea cron del servidor debe ejecutar wp-cron.php con regularidad); una donación que se queda «pendiente» tras un pago realizado con éxito suele deberse a un problema con el cron, no a un problema del plugin
Servicio de asistencia comercial disponible (no es necesario proporcionar una dirección de correo electrónico directa): helpdesk.ifthenpay.com
* Asistencia de ifthenpay: suporte@ifthenpay.com
* Documentación de GiveWP: Documentación de GiveWP
Capturas
Instalación
- Instala y activa GiveWP, luego sube el archivo zip del plugin mediante Plugins Añadir Nuevo Subir, o instálalo desde WordPress.org, y Actívalo.
- Credenciales: Asegúrate de que tu cuenta de ifthenpay tiene una Clave de Pasarela GiveWP activa con los métodos de pago deseados activados.
- Configuración: Ve a GiveWP Ajustes Pasarelas de Pago ifthenpay y haz clic en «Conectar con ifthenpay» para vincular tu Clave de Backoffice.
- Configuración: Elige tu clave de pasarela de pago, activa los métodos de pago, establece un método predeterminado, una descripción y los días de validez en «Pasarela y métodos de pago»; selecciona un diseño de campos en «Diseño de campos».
- Activa la pasarela de ifthenpay en tus formularios de donación.
FAQ
-
¿Este plugin requiere GiveWP?
-
Sí. GiveWP (Give – Donation Plugin) debe estar instalado y activo para usar este plugin.
-
¿Dónde consigo una clave de Backoffice de ifthenpay?
-
Regístrate en https://ifthenpay.com para obtener tu clave de Backoffice y una Clave de Pasarela GiveWP.
-
¿Admite donaciones recurrentes?
-
No en esta versión. Solo se admiten donaciones únicas mediante Pay-By-Link.
-
¿Se almacenan los datos de pago?
-
No. El plugin no almacena números de tarjeta ni datos bancarios completos. Solo se almacenan las referencias mínimas necesarias para la conciliación del pago.
-
¿Qué métodos de pago son compatibles?
-
Cualquier método activado en tu Clave de Pasarela de ifthenpay (p. ej. Multibanco, MB WAY, Payshop, Tarjeta de Crédito, Cofidis, Google Pay, Apple Pay, Pix).
-
¿Cómo funciona el proceso de pago?
-
Después de iniciar una donación, el donante es redirigido fuera del sitio a una página de pago segura alojada por ifthenpay. El regreso del navegador del donante solo muestra una confirmación de éxito/error/cancelación — el estado real de la donación lo establece un callback servidor a servidor, por lo que también funciona con métodos offline/asíncronos como Multibanco o Payshop.
-
¿Qué ocurre si una donación falla o se cancela?
-
La donación se marca como Fallida o Cancelada en cuanto el callback de ifthenpay informa del resultado. Los donantes pueden iniciar una nueva donación para volver a intentarlo.
-
¿Por qué no se actualizó el estado de mi donación inmediatamente después de pagar?
-
El callback servidor a servidor de ifthenpay se recibe al instante, pero GiveWP finaliza el estado de la donación mediante el Action Scheduler de WordPress, que normalmente se ejecuta a través de WP-Cron. En sitios con poco tráfico, o sitios con WP-Cron desactivado (DISABLE_WP_CRON) sin una tarea cron real de servidor en su lugar, esto puede introducir un pequeño retraso antes de que el estado se actualice visiblemente. Si esto ocurre de forma constante, configura una tarea cron a nivel de servidor para llamar a wp-cron.php cada pocos minutos.
-
¿Qué pasa si un método de pago que quiero todavía no muestra una cuenta?
-
Haz clic en «Solicitar activación», junto a ese método en la tabla «Pasarela y métodos de pago», para enviar un correo electrónico al servicio de asistencia de ifthenpay solicitando que se active en tu clave de pasarela.
-
¿Puedo personalizar la experiencia de pago?
-
Sí. Puedes configurar el diseño del campo (tarjeta completa o en línea), el tema de color (automático, claro, oscuro), el título de la pasarela, la descripción de pago predeterminada y los días de caducidad del enlace de pago.
-
¿Hay un entorno de pruebas (sandbox)?
-
ifthenpay puede proporcionar entidades de prueba; si no están disponibles, usa una donación real de bajo valor para las pruebas.
-
¿Qué tan segura es la integración?
-
Todas las solicitudes están cifradas mediante HTTPS; cada callback se verifica frente a una clave antiphishing y el importe de donación esperado, y no se almacena ningún dato sensible de tarjeta.
-
¿Por qué fallan los enlaces de pago o se agota el tiempo de espera durante la configuración?
-
Es posible que el cortafuegos de tu servidor o tu VPN estén bloqueando las solicitudes salientes. Para funcionar, el complemento debe conectarse a las API de ifthenpay. Asegúrate de que tu administrador de red permita el tráfico HTTPS saliente hacia los dominios de ifthenpay.
Reseñas
No hay valoraciones para este plugin.
Colaboradores y desarrolladores
«ifthenpay | Payments for GiveWP» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores
«ifthenpay | Payments for GiveWP» está traducido en 1 idioma. Gracias a los traductores por sus contribuciones.
Traduce «ifthenpay | Payments for GiveWP» a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
1.0.0
- Lanzamiento inicial: integración de la pasarela de pago de GiveWP, ifthenpay Pay-By-Link, flujo de Conexión de la Clave de Backoffice, compatibilidad multimétodo, diseños de campo tarjeta completa/en línea.