Donaciones en cripto con GiveWP: ¿cómo acepto donaciones en cripto en GiveWP?

Payzum es un procesador de pagos cripto sin custodia y enfocado en stablecoins: los pagos se liquidan directo en wallets que controla el comercio. Para las donaciones en cripto con GiveWP publica un plugin de pasarela open source en github.com/payzum-dev/givewp-payzum. Esta guía es para ONG, fundaciones, iglesias, colegios y causas que ya recaudan con GiveWP en WordPress. Verás por qué las organizaciones suman cripto en 2026, seis preguntas para evaluar cualquier pasarela cripto para GiveWP y el plugin de Payzum paso a paso, además de lo que el plugin no hace a propósito. Si antes quieres el argumento de recaudación, lee donaciones en cripto para iglesias y ONG. Este artículo se queda dentro de GiveWP.

Por qué las ONG suman donaciones en cripto con GiveWP en 2026

GiveWP es la forma habitual de recibir donaciones en WordPress. Su ficha en WordPress.org mostraba más de 100.000 instalaciones activas el 5 de octubre de 2026, con la versión 4.18.0 publicada el 1 de octubre. Casi todos esos formularios cobran con tarjeta a través de Stripe o PayPal. Tres presiones están llevando a las organizaciones a sumar una opción cripto al lado.

Las comisiones fijas se comen los aportes pequeños. La tarifa pública de Stripe en España, consultada el 5 de octubre de 2026, es de 1,5 % + 0,25 € por tarjeta estándar del Espacio Económico Europeo y de 3,15 % + 0,25 € por tarjeta de fuera del EEE, como la de un donante en México o Colombia. Y si usas la pasarela gratuita de Stripe de GiveWP sin licencia, la propia documentación de GiveWP (actualizada el 22 de julio de 2026) indica que suma un 2 % a cada donación única, encima de la comisión de Stripe. En un aporte de 10 € con tarjeta europea son 0,60 €: el 6 %.

Los formularios de donación atraen a quienes prueban tarjetas robadas. La guía de GiveWP sobre donaciones spam, actualizada el 2 de julio de 2026, explica el motivo: un formulario de donación no tiene carrito, así que el bot que prueba números de tarjeta robados es más fácil de escribir. Y señala que «los bots suelen probar los formularios con importes de 1 hasta 5 dólares». Cada ataque deja un montón de donaciones falsas y cargos rechazados que alguien tiene que limpiar.

Parte de tus donantes ya tiene stablecoins. Migrantes que envían dinero a su país en USDT. Familias en Argentina que ahorran en dólares digitales. Desarrolladores que apoyan el proyecto open source que usan a diario. Muchos preferirían enviar USDT antes que escribir su tarjeta en un formulario, y a algunos el banco les rechaza los pagos internacionales.

Lo que le cuesta a tu causa un formulario de GiveWP solo con tarjeta

Ponle números a un mes normal. Imagina una fundación en España con la pasarela gratuita de Stripe de GiveWP, sin licencia: 200 aportes al mes con una media de 25 €, de los que 40 llegan desde Latinoamérica. Cada aporte con tarjeta europea cuesta 1,13 € y cada uno con tarjeta de fuera del EEE, 1,54 €. Son unos 241 € al mes, casi 2.900 € al año, y unos 100 € de esos 241 son solo el 2 % de GiveWP. Todo eso antes de una sola devolución o disputa.

Una donación con tarjeta también puede volver atrás. El banco del donante puede revertirla semanas o meses después, cuando el dinero ya se gastó en el programa. Pierdes la donación y, con Stripe en España, pagas además 20 € por cada disputa que recibes.

El coste silencioso es el tiempo. Un ataque de prueba de tarjetas significa horas borrando donaciones falsas, devolviendo las que pasaron y explicándole el pico a tu procesador. El remedio principal que propone GiveWP es subir la donación mínima, lo que también deja fuera a los donantes reales de 5 €.

Y está el donante que nunca ves: al que el banco le rechazó un aporte internacional, o el que quería donar en USDT y no encontró cómo hacerlo en tu formulario.

Por qué las tarjetas, la cripto con custodia y una dirección de wallet suelta no alcanzan en GiveWP

Las tarjetas y PayPal ganan en alcance y pierden en coste y finalidad. Casi cualquier donante puede usarlas y, con el complemento Recurring Donations de GiveWP, gestionan las donaciones mensuales. Mantenlas. Pero el porcentaje más la comisión fija castiga a los aportes pequeños, las donaciones se pueden revertir y el formulario de tarjeta es justo lo que buscan los bots.

Las plataformas de donación cripto con custodia resuelven la aceptación, no la custodia. El donante paga a la dirección de la plataforma, la plataforma guarda un saldo y te lo transfiere según su calendario. Ese saldo es algo que un proveedor puede congelar o retrasar. Y si la plataforma no se integra con GiveWP, la donación vive en su panel en lugar de en tus informes de GiveWP.

Una dirección de wallet suelta en la página de donar se salta todo lo demás. No cuesta nada y el pago es final. Pero GiveWP nunca se entera: no hay registro de la donación, ni recibo por email, ni avance de la campaña, ni historial del donante. Alguien termina cruzando transacciones de la blockchain con emails de agradecimiento a mano.

Lo que necesita una organización es una pasarela que se comporte como cualquier otra pasarela de GiveWP: registro de la donación, recibo y total de campaña. Y que se liquide como cripto: final, en segundos y en una wallet que controla tu organización.

Cómo elegir una pasarela de donaciones cripto para GiveWP: seis preguntas

Seis preguntas separan una pasarela que puedes usar en plena campaña de una de la que te vas a arrepentir. Házselas a cualquier proveedor, también a nosotros. Los nombres de menú van en inglés; si tu WordPress está en español, pueden aparecer traducidos.

1. ¿Dónde se liquidan los fondos? ¿En la wallet propia de tu organización, o en un saldo que el proveedor guarda y te paga después? Solo lo primero deja a todo el mundo sin forma de congelar el dinero.
2. ¿Aparece en los formularios de Visual Form Builder? Desde GiveWP 3.0, GiveWP guarda listas de pasarelas separadas para sus dos editores de formularios, Visual Form Builder y Option-Based Form Editor, en GiveWP → Settings → Payment Gateways. Una pasarela hecha solo para la API antigua puede estar instalada y activada y aun así no salir nunca en un formulario moderno.
3. ¿Qué completa la donación? La documentación de GiveWP dice que una donación queda Pending hasta que la pasarela avisa a tu sitio por webhook o IPN, y que termina como Abandoned si ese aviso nunca llega. Que el donante vea la página de gracias no prueba nada. Busca una notificación de servidor a servidor con la firma verificada sobre los bytes crudos de la petición y una ventana contra repeticiones.
4. ¿Se comprueba el importe? Un estado finished dice que se pagó una factura. No dice que esa factura fuera por el importe de esta donación. La pasarela debe comparar el importe y la moneda liquidados con la donación antes de marcarla como Complete.
5. ¿Qué pasa con un reintento, o con dos avisos a la vez? Los proveedores de pago reenvían notificaciones. Si dos se procesan juntas, una donación puede completarse dos veces: dos recibos y el aporte contado dos veces en el total de la campaña.
6. ¿Encaja con tu stack y puedes leer el código? GiveWP 4.18 funciona con PHP 7.4 o superior, pero muchas pasarelas piden un PHP más nuevo. Las estadísticas de WordPress.org del 5 de octubre de 2026 muestran cerca del 74 % de los sitios WordPress en PHP 8.1 o superior y un 16,5 % todavía en 7.4. Revisa el tuyo, y prefiere código que tu desarrollador, o un voluntario, pueda auditar.

Nuestra guía de plugins de pago cripto open source convierte las preguntas 3, 4 y 6 en una auditoría de 15 minutos que puedes hacerle a cualquier repositorio.

Cómo gestiona una donación en cripto la pasarela de Payzum para GiveWP

El plugin es una pasarela de pago de GiveWP construida sobre su API de pasarelas de nueva generación y registrada para los formularios de Visual Form Builder. Hace dos cosas. Convierte una donación enviada en un checkout de Payzum. Y deja que una notificación firmada, y nada más, complete la donación.

En el formulario: una opción de pago más

El donante ve Crypto / Stablecoins (Payzum) junto a tus otras pasarelas, sin campos adicionales. Al enviar el formulario, el plugin crea una factura de Payzum por el importe de la donación en la moneda del formulario. El importe viaja como texto exacto, así que no se redondea por el camino.

La factura lleva una referencia formada por el ID de la donación y los últimos ocho caracteres de su clave de compra, para que un ID adivinado no pueda casar con la donación de otra persona. También lleva una clave de idempotencia, así que un reintento de red no crea una segunda factura para el mismo aporte.

Después el donante paga en el checkout alojado de Payzum, con código QR, dirección de depósito y estado en vivo, desde cualquier wallet y sin crear una cuenta. Por defecto se le redirige ahí. También puedes abrir el checkout como modal sobre tu página o incrustado en lugar del formulario.

El plugin no elige la moneda. El checkout ofrece solo los tokens que aceptas, que configuras en tu panel de Payzum en Merchants → Settings → Accepted tokens, y Payzum hace cumplir esa lista por su lado. Para casi todas las organizaciones eso significa USDT y USDC en redes rápidas y baratas: Solana confirma en unos 0,4 segundos, y Base y Polygon en unos dos. Si aceptas también otras criptos, la conversión automática opcional a USDC o USDT está disponible en la mayoría de las redes compatibles.

Después del pago: la notificación firmada la completa

Payzum avisa a tu sitio en /?give-listener=payzum. Antes de leer un solo campo, el plugin verifica una firma HMAC-SHA-512 sobre los bytes crudos de la petición con tu secreto de webhook. La comparación se hace en tiempo constante y se rechaza todo lo que caiga fuera de una ventana de 10 minutos. Una firma incorrecta recibe un 401.

Luego el plugin toma un bloqueo de base de datos por donación, para que dos avisos de la misma donación no se procesen a la vez. Si el bloqueo está ocupado, responde 503 y Payzum reintenta, así que ver de vez en cuando un «busy» en el log de accesos es normal. Además, ignora cualquier ID de evento que ya haya procesado.

Con un pago finished, el plugin compara el importe y la moneda liquidados con la donación, con medio céntimo de tolerancia. Pagar de más no es problema. Un importe menor, otra moneda o un importe ilegible pasan la donación a Processing con una nota: «reported as finished but … held for review, NOT completed», es decir, retenida para revisión y no completada. Solo si coincide queda como Complete. El plugin también anota qué moneda eligió el donante.

El cliente HTTP y la verificación de la firma vienen del SDK oficial payzum/payzum-php, incluido dentro del plugin, así que no hace falta Composer. La ingeniería detrás de este patrón está en webhooks firmados para pagos cripto.

Lo que hace GiveWP después

Para GiveWP, una donación en cripto completada es una donación completada. Sale tu email de recibo, el aporte suma a la meta de la campaña y aparece en tu lista de donaciones, en tus informes y en el historial del donante. Tu flujo de agradecimiento no cambia.

Adónde va el dinero

Directo a la wallet configurada en tu panel de Payzum. El código del plugin no contiene ninguna dirección de wallet, y Payzum nunca retiene los fondos: no hay saldo que retirar, congelar ni esperar. Según el readme del plugin, a Payzum solo le envía el importe, la moneda, la referencia de la donación y tus URL de aviso y de retorno, sin datos personales del donante. El modelo está explicado en qué es un procesador de pagos cripto sin custodia.

Cómo configurar las donaciones en cripto con GiveWP, paso a paso

Casi todo el tiempo se va en la prueba en staging, que es el paso que vale la pena hacer bien.

1. Revisa tu stack. Necesitas PHP 8.1 o superior, porque el SDK incluido usa funciones nuevas del lenguaje, además de GiveWP 3.0 o superior y un sitio servido por HTTPS. El plugin está verificado con GiveWP 4.16. GiveWP ya va por la 4.18.0, así que haz el paso 8 en una copia de staging antes de salir en vivo.
2. Prepara tu cuenta de comercio en Payzum. Regístrate en merchant.payzum.com y añade la wallet que controla tu organización. Elige los tokens que aceptas, por ejemplo USDT y USDC en Solana, Base y Polygon. Copia tu API key desde la sección Merchants y apunta tu secreto de webhook (IPN).
3. Instala el plugin. Descarga payzum-give-1.3.2.zip desde la página Releases del repositorio. En WordPress, ve a Plugins → Añadir nuevo → Subir plugin, elige el zip y actívalo. GiveWP tiene que estar activo antes. No uses el botón verde «Download ZIP» de GitHub: ese archivo se descomprime en una carpeta con el nombre equivocado.
4. Pega tus credenciales. Ve a GiveWP → Settings → Payment Gateways y abre la sección de Payzum. Pega la API key y el secreto de webhook, y pon Environment en Staging / sandbox por ahora. Staging tiene sus propias claves; una clave de producción no funciona ahí. Mientras falte alguna de las dos credenciales, la pasarela no aparece en tus formularios y un aviso en el administrador te dice qué falta.
5. Registra la URL de IPN. La misma pantalla muestra Your IPN URL, algo como https://tu-sitio.org/?give-listener=payzum. Pégala en los ajustes de webhook de Payzum. El plugin además la envía con cada factura. Tiene que aceptar peticiones POST desde internet: una autenticación básica, una página de mantenimiento o una regla de firewall que la bloquee dejarán las donaciones en Pending hasta que GiveWP las marque como Abandoned.
6. Actívala para Visual Form Builder. Sin salir de Payment Gateways, abre la pestaña Visual Form Builder y activa Payzum. Es el paso que más se olvida, porque el editor de opciones tiene su propia lista aparte. Si todavía usas formularios del editor de opciones, pruébalos en staging: la documentación de Payzum apunta a los formularios de Visual Form Builder.
7. Elige el modo de moneda y de visualización. Deja Currency mode en Fiat y Fiat price currency en Site currency, salvo que los importes de tu formulario ya estén en una cripto. Elige Redirect, Modal o Inline. Si tu sitio envía una Content-Security-Policy, permite merchant.payzum.com en script-src, frame-src y connect-src para los modos modal e incrustado.
8. Prueba en staging. Haz una donación pequeña en un formulario de prueba. Debe pasar de Pending a Complete con la nota «Payzum: donation confirmed in full (finished)». Comprueba que llega el email de recibo y que se mueve el total de la campaña.
9. Sal en vivo. Cambia Environment a Production, pega tu clave y tu secreto de producción, y haz una donación real pequeña.

Los ajustes de la pasarela, de un vistazo

No hay selector de monedas ni campo para la cabecera de la firma, a propósito. Tus monedas viven en el panel de Payzum y la cabecera la fija la plataforma, así que nada en esta pantalla puede desincronizarse de tu cuenta.

Qué pasa en GiveWP en cada estado del pago

Nada de esta tabla lo dispara el navegador del donante. Una pestaña cerrada no puede perder una donación pagada, y una visita de retorno falsa no puede completar una sin pagar.

Lo que la pasarela cripto para GiveWP no hace

Conviene saberlo antes de anunciar la opción:

• No hay donaciones recurrentes. La pasarela solo acepta aportes únicos. La cripto la envía el donante desde su wallet, así que no se puede cobrar sola cada mes. La pasarela no declara soporte de suscripciones, y cuando un donante cambia un formulario de Visual Form Builder a donación recurrente, GiveWP quita a Payzum de la lista. Mantén tu pasarela de tarjetas para las donaciones mensuales.
• Las devoluciones salen de tu wallet. Payzum nunca retiene los fondos, así que no tiene de dónde devolver. Envía tú mismo las stablecoins de vuelta y registra la devolución en GiveWP.
• Las diferencias de importe necesitan a una persona. Un pago de menos o en otra moneda espera en Processing con una nota hasta que alguien de tu equipo decida.
• Un aporte muy pequeño puede quedar por debajo del mínimo de la red. Cada moneda y red tiene un importe mínimo. Por debajo, el donante ve un mensaje claro que le pide aportar más o elegir otro método. Revisa los mínimos de los tokens que aceptas.
• Distribución. A 5 de octubre de 2026, el plugin se distribuye como release de GitHub, payzum-give-1.3.2.zip. No está publicado en el directorio de plugins de WordPress.org.

Casos de uso: ONG que reciben donaciones en cripto con GiveWP

La configuración es la misma para todas. Lo que cambia es qué parte se paga sola.

• Protectora de animales que vive de aportes pequeños. Una protectora en Valencia recibe casi todo en aportes de 10 a 20 € con la pasarela gratuita de Stripe de GiveWP, sin licencia: 0,60 € de cada 10 €. Suma Payzum como segunda opción y acepta USDC en Base y Solana. Un aporte de 10 USDC llega a la wallet de la protectora segundos después de la confirmación, con una comisión de red de céntimos. Y la opción cripto no tiene campo de tarjeta que puedan sondear los bots.
• Escuelas rurales financiadas por la diáspora. Una ONG en Guatemala lanza una campaña en GiveWP para construir aulas en Huehuetenango. Los migrantes en Estados Unidos aportan USDT, muchas veces desde las mismas wallets que usan para enviar remesas. Cada aporte suma a la meta que muestra el formulario. Después la ONG paga al constructor y a los proveedores desde esa misma wallet, varios a la vez, con los pagos masivos en stablecoins de Payzum.
• Comedor comunitario en Buenos Aires. Muchos donantes en Argentina ahorran en USDT para protegerse de la inflación, como contamos en stablecoins y peso argentino. Un comedor que recauda con GiveWP suma la opción cripto: los vecinos donan en dólares digitales que ya tienen, y el comedor recibe USDT en su wallet en lugar de pesos que pierden valor mientras esperan la liquidación.
• GivingTuesday en una iglesia hispana de Texas. El 1 de diciembre de 2026, GivingTuesday, una iglesia en Houston con una campaña de becas en GiveWP recibe 5.000 USDC de un miembro de la congregación. Con la tarifa benéfica de PayPal en EE. UU. (1,99 % + 0,49 $, según su página de comisiones actualizada el 1 de octubre de 2026), ese mismo aporte costaría 99,99 $. On-chain cuesta la comisión de red, suma a la meta en cuanto se confirma, y ninguna disputa puede quitarlo después de anunciar el resultado.

Payzum para GiveWP frente a Stripe, PayPal y una dirección de wallet suelta

Comparados con criterios neutrales. Las cifras de Stripe son su tarifa pública en España, consultada el 5 de octubre de 2026; las de PayPal, su tarifa benéfica en EE. UU. con la página de comisiones actualizada el 1 de octubre de 2026. El 2 % de GiveWP sale de su documentación de la pasarela gratuita de Stripe, actualizada el 22 de julio de 2026.

Una plataforma de donaciones cripto con custodia es otra opción razonable si prefieres que alguien se encargue de todo: guarda los fondos y te los transfiere según su calendario. Payzum es para organizaciones que quieren cada aporte en su propia wallet y registrado en GiveWP. No tienes que dejar nada: la mayoría suma Payzum como una pasarela más junto a las tarjetas.

Objeciones frecuentes, resueltas

«Nuestros donantes no tienen cripto.»

La mayoría no, y seguirán donando con tarjeta. La opción cripto es para quienes sí tienen: migrantes que ya mueven dinero en stablecoins, donantes que ahorran en USDT, desarrolladores y simpatizantes cripto. Añade una línea a tu lista de pasarelas y no cambia nada para el resto.

«Nuestra junta no quiere monedas volátiles.»

No hace falta. Acepta solo USDT y USDC y cada aporte llega como una stablecoin en dólares. Los importes del formulario siguen en tu moneda: en modo fiat, el donante paga el equivalente en la moneda que elige. Si aceptas también otras criptos, la conversión automática opcional a USDC o USDT está disponible en la mayoría de las redes compatibles. USDT vs USDC para pagos te ayuda a elegir.

«¿Cómo emitimos el recibo de una donación en cripto?»

GiveWP registra el aporte en la moneda de tu formulario y envía su email de recibo de siempre, y el plugin anota qué moneda se usó. Cómo se valora y se certifica fiscalmente una donación en cripto depende de tu país, así que confirma el texto de tus certificados con tu asesor.

«No instalamos código de pagos que no podemos leer.»

Bien, y no tienes por qué. El plugin son tres archivos PHP, un archivo JavaScript y el SDK oficial incluido, todo público bajo la GPL, la misma licencia que WordPress. No guarda datos de tarjeta ni direcciones de wallet, no envía a Payzum datos personales del donante y rechaza las notificaciones sin firma antes de leerlas.