Documentación de Charitable

Aprende a sacar el máximo partido a Charitable con instrucciones claras y paso a paso.

Cómo conectar Charitable con GoCardless

GoCardless cobra las donaciones directamente de la cuenta bancaria de un donante mediante domiciliación bancaria, por lo que sus donantes no necesitan tarjeta de crédito ni débito. Los pagos bancarios suelen costar alrededor del 1% por donación en lugar del 2,5% al 3% que cobran la mayoría de las pasarelas de pago con tarjeta, lo que deja más dinero para su causa.

Esta guía detalla la instalación del complemento, la habilitación de la pasarela, la creación de su token de acceso, la adición de un webhook y la prueba de todo antes de aceptar donaciones reales.

GoCardless está disponible en los planes Básico y superiores.

¿Qué hay en esta guía?

Antes de empezar

Necesitará su propia cuenta de GoCardless antes de empezar. Si aún no tiene una, puede registrarse en gocardless.com.

Charitable se conecta directamente a esa cuenta. Nunca se le pedirá que se conecte a través de una cuenta de socio, por lo que los detalles de sus donantes y sus transacciones se mantienen entre usted y GoCardless.

GoCardless funciona con esquemas de domiciliación bancaria en más de 30 países.

  • Bacs cubre el Reino Unido, las Islas del Canal, la Isla de Man y Gibraltar.
  • SEPA Core cubre la Eurozona, incluyendo Austria, Bélgica, Chipre, Estonia, Finlandia, Francia, Alemania, Grecia, Irlanda, Italia, Letonia, Lituania, Luxemburgo, Malta, Mónaco, Países Bajos, Portugal, San Marino, Eslovaquia, Eslovenia y España.
  • ACH cubre los Estados Unidos.
  • PAD cubre Canadá.
  • BECS cubre Australia y BECS NZ cubre Nueva Zelanda.
  • Autogiro cubre Suecia y Betalingsservice cubre Dinamarca.

También necesitarás PHP 7.2 o superior y Charitable 1.6.55 o superior.

Nota: Los pagos bancarios no son instantáneos. Una donación de GoCardless permanece como Pendiente en tu panel de control durante unos días antes de marcarse como Pagada. Eso es normal, y la webhook que configures más tarde es lo que la actualizará por ti.

Después de completar el formulario de donación en su sitio web, los donantes serán redirigidos a una página de pago alojada por GoCardless.

Página de pago de GoCardless

Esto mantiene los pagos seguros, ya que GoCardless se encarga de todos los datos confidenciales.

Instalación del complemento GoCardless

Para instalar el complemento, dirígete a Charitable » Complementos y busca GoCardless en la lista. Haz clic en “Instalar complemento”, luego haz clic en “Activar” una vez que la instalación finalice.

La página de Complementos de Charitable con GoCardless listado bajo Disponible en tu plan y un botón Instalar Complemento

Si prefieres instalar desde un archivo zip, puedes descargar el complemento y subirlo tú mismo.

  1. Descarga el archivo zip de GoCardless desde la página de tu cuenta de Charitable.
  2. En tu panel de WordPress, ve a Plugins » Añadir nuevo » Subir plugin.
  3. Elige el archivo zip que descargaste y haz clic en “Instalar ahora”.
  4. Haz clic en “Activar plugin”.

Nota: Si nunca antes has instalado un complemento de Charitable, nuestra guía para instalar extensiones de Charitable cubre ambos métodos con más detalle.

Habilitación de la pasarela

La activación del complemento no activa la pasarela por sí sola, así que hay un paso más.

Para activarla, ve a Charitable » Ajustes » Pasarelas de pago. Verás GoCardless listado con las otras pasarelas. Haz clic en “Activar pasarela” junto a él.

GoCardless listado en la pestaña Pasarelas de Pago de la Configuración de Charitable con un botón Habilitar Pasarela

Después de que la página se recargue, aparece un botón verde “Ajustes de pasarela” junto a GoCardless, junto con un enlace “Establecer como predeterminada” y un botón “Desactivar pasarela”.

La fila de GoCardless después de habilitar la pasarela, mostrando Establecer como predeterminada, Configuración de Pasarela y Deshabilitar Pasarela

Consejo profesional: También puedes activar la pasarela directamente desde la página de Plugins. Justo después de activar el complemento, haz clic en el enlace “Activar pasarela GoCardless” que se muestra debajo del nombre del plugin.

Creación de su token de acceso en GoCardless

Charitable utiliza un token de acceso para comunicarse con tu cuenta de GoCardless. Un token de acceso es una larga cadena de caracteres que sustituye a tu inicio de sesión, y lo creas dentro de tu panel de GoCardless.

Crear un token de acceso desde la página de Desarrolladores en el panel de GoCardless
  1. Para empezar, inicia sesión en tu cuenta de GoCardless en manage.gocardless.com.
  2. Haz clic en “Desarrolladores” en el menú de la barra lateral.
  3. En la parte superior derecha, haz clic en “Crear”, luego haz clic en “Token de acceso”.
  4. Dale al token un nombre que reconozcas más tarde. “Charitable” funciona bien.
  5. Copia el token de acceso que te da GoCardless.

Importante: Trata tu token de acceso como una contraseña. Cualquiera que lo tenga puede actuar sobre tu cuenta de GoCardless, así que no lo publiques en un foro de soporte ni lo compartas por chat.

Añadir su token de acceso en Charitable

Para abrir los ajustes de la pasarela, ve a Charitable » Ajustes » Pasarelas de pago y haz clic en “Ajustes de pasarela” junto a GoCardless.

La página de configuración de la pasarela GoCardless en Charitable mostrando Etiqueta de Pasarela, Token de Acceso en Vivo, Token de Acceso Sandbox, Secreto de Webhook y Divisas Soportadas

Verás cinco ajustes en esta página.

  • Etiqueta de pasarela es el nombre que los donantes ven para esta opción de pago en tu formulario de donación. Por defecto dice GoCardless, y puedes cambiarlo a algo como “Transferencia bancaria” si es más claro para tus patrocinadores.
  • Token de acceso en vivo es donde pegas el token de acceso de tu cuenta de GoCardless en vivo.
  • Token de acceso de prueba es donde pegas el token de acceso de tu cuenta de prueba de GoCardless. Charitable utiliza este mientras el Modo de prueba está activado, y puedes dejarlo vacío hasta que estés listo para probar.
  • El Secreto del Webhook es el secreto que configuras en el endpoint de webhook de tu GoCardless. Lo crearás en la siguiente sección, así que puedes volver y rellenarlo después.
  • Las Monedas Soportadas te permiten verificar cualquier moneda adicional que quieras aceptar a través de GoCardless, como el Dólar Australiano, el Dólar Canadiense o el Euro. La moneda base de tu sitio se añade automáticamente.

Una vez que tu token de acceso en vivo esté en su lugar, haz clic en “Guardar Cambios”.

Añadir su punto de conexión webhook

Un webhook es un mensaje que GoCardless envía a tu sitio web cuando algo sucede con un pago después de que el donante ha abandonado tu sitio.

Sin uno, Charitable nunca se entera cuando se cobra o falla un pago pendiente, y las donaciones de renovación de la extensión de Donaciones Recurrentes no se registrarán.

El menú Crear en GoCardless con la opción Punto de conexión webhook
Haz clic en “Crear”, luego en “Endpoint de webhook” en la página de Desarrolladores de GoCardless
  1. Para crearlo, vuelve a la página de Desarrolladores en GoCardless, haz clic en “Crear”, y luego en “Endpoint de webhook”.
  2. Asígnale un “Nombre”. Charitable funciona bien aquí, para que puedas saber más tarde para qué es el webhook.
  3. Establece la “URL” a la dirección de inicio de tu sitio web seguida de /charitable-listener/gocardless. Para un sitio en https://misnonprofit.org, la URL del webhook es https://misnonprofit.org/charitable-listener/gocardless
  4. Añade un “Secreto” que sea difícil de adivinar para cualquiera, y guarda una copia del mismo.
  5. Deja “Certificado de cliente de webhook” desmarcado.
  6. Haz clic en “Crear endpoint de webhook”.
La ventana Crear punto de conexión webhook en GoCardless mostrando los campos Nombre, URL y Secreto

Para finalizar, pega el mismo secreto en el campo “Secreto del Webhook” en la configuración de Charitable GoCardless y haz clic en “Guardar Cambios”.

Importante: El secreto en GoCardless y el secreto en Charitable tienen que coincidir exactamente. Si no lo hacen, Charitable ignora los mensajes que envía GoCardless y tus donaciones se quedarán como Pendientes.

Aceptar donaciones recurrentes con GoCardless

GoCardless funciona junto con la extensión Donaciones Recurrentes. La domiciliación bancaria se adapta bien a las donaciones regulares, ya que el donante la autoriza una vez y los pagos se cobran por él después.

Los donantes pueden donar semanalmente, mensualmente, trimestralmente, dos veces al año o una vez al año. No necesitas configurar nada adicional en el lado de GoCardless para que esto funcione.

Importante: Las renovaciones dependen de tu endpoint de webhook. Si planeas aceptar donaciones recurrentes, añade el webhook antes de salir en vivo.

Aprende cómo configurar donaciones recurrentes »

Prueba de GoCardless en modo de prueba

Siempre recomendamos probar una nueva pasarela antes de aceptar donaciones reales. GoCardless mantiene una cuenta sandbox separada para pruebas, así que crearás un segundo token de acceso y un segundo endpoint de webhook allí.

  1. Para configurar la sandbox, ve a manage-sandbox.gocardless.com y crea o inicia sesión en tu cuenta sandbox. El panel de la sandbox se ve igual que el tuyo en vivo.
  2. Crea un token de acceso de la misma manera que lo hiciste antes, luego pégalo en el campo “Token de Acceso Sandbox” en Charitable y haz clic en “Guardar Cambios”.
  3. Crea también un endpoint de webhook en la sandbox, apuntando a la misma URL que usaste para tu cuenta en vivo, con el mismo secreto.
  4. Ve a Charitable » Configuración » Pasarelas de pago, activa "Activar modo de prueba" y haz clic en "Guardar cambios". Las donaciones ahora usan tus credenciales de sandbox, no se mueve dinero real y tu formulario de donaciones muestra un banner de "Modo de prueba".
  5. Haz una donación en tu propio sitio web y elige GoCardless como método de pago. Puedes usar los datos bancarios de prueba que GoCardless publica para el sandbox.
  6. Después de finalizar el pago, volverás a tu sitio web. La donación aparece como Pendiente en Charitable » Donaciones, porque los pagos bancarios tardan unos días en procesarse.
  7. Abre esa donación y busca el campo "ID de transacción de la pasarela". Hacer clic en él te lleva al pago dentro de GoCardless, donde puedes ver su estado.
  8. Vuelve a comprobar en unos días. Cuando la donación aparezca como Pagada en Charitable, tu punto de conexión de webhook estará funcionando.

Importante: Desactiva "Activar modo de prueba" antes de empezar a aceptar donaciones reales, o los pagos de tus donantes reales irán a parar al sandbox.

Establecer GoCardless como pasarela predeterminada

Si la mayoría de tus donantes pagarán por Domiciliación Bancaria, puedes tener GoCardless ya seleccionado para ellos en el formulario de donación.

Para hacerlo, ve a Charitable » Configuración » Pasarelas de pago y haz clic en el enlace "Establecer como predeterminado" junto a GoCardless.

Nota: GoCardless no acepta pagos con tarjeta. Si algunos de tus donantes quieren pagar con tarjeta, mantén habilitada una pasarela de tarjetas como Stripe o Square junto a ella.

¡Eso es todo! Tu pasarela GoCardless está lista para recaudar donaciones.

GoCardless está disponible en el plugin Charitable Pro a partir del plan Basic.

¿Todavía no usas Charitable Pro?

Puedes obtener hasta un 50% de descuento al registrarte o actualizar a Charitable Pro. Queremos asegurarnos de que puedas probar las funciones avanzadas de recaudación de fondos como Donaciones Recurrentes, Recuperación de Donaciones y más a un costo significativamente reducido.

Únete a más de un millón de usuarios satisfechos de Charitable Pro hoy mismo. Cada compra viene con una garantía de devolución de dinero de 14 días, asegurando que estés respaldado en cada paso del camino.

Si tienes alguna pregunta o necesitas ayuda, nuestro equipo de soporte está listo para ayudarte a sacar el máximo provecho de estas nuevas funciones.

Preguntas frecuentes sobre GoCardless

¿Necesito mi propia cuenta de GoCardless para usar este complemento?

Sí. El complemento se conecta a una cuenta que creas directamente con GoCardless. Si aún no tienes una, regístrate en gocardless.com antes de empezar.

¿Tengo que conectarme a través de una cuenta de socio?

No. Charitable se conecta a tu propia cuenta de GoCardless con tu propio token de acceso. Algunas plataformas de donaciones te piden que te conectes a través de su cuenta de socio, lo que les da un amplio acceso a tus donantes y transacciones. No tienes que hacer eso aquí.

¿Por qué mi donación aparece como Pendiente?

La domiciliación bancaria y las transferencias bancarias no son instantáneas, por lo que una nueva donación de GoCardless está Pendiente durante unos días. Tu punto de conexión de webhook la actualiza a Pagada una vez que GoCardless ha cobrado el dinero.

¿Pueden los donantes pagar con tarjeta de crédito a través de GoCardless?

No. GoCardless solo gestiona la domiciliación bancaria y los pagos bancarios locales. Mantén habilitada una pasarela de tarjetas como Stripe, Square o PayPal para que los donantes que prefieren tarjeta sigan teniendo una opción.

¿Dónde introducen los donantes los datos de su cuenta bancaria?

En una página de pago alojada por GoCardless, a la que se envía a los donantes después de enviar tu formulario de donación. Charitable nunca almacena sus datos bancarios en tu sitio web.

¿Realmente necesito añadir un secreto de webhook?

Es opcional, pero lo recomendamos encarecidamente. El secreto está en cómo Charitable comprueba que un mensaje realmente provino de GoCardless y no de otra persona.

¿Puedo usar la misma URL de webhook para mis cuentas en producción y en entorno de pruebas?

Sí. Ambos puntos de conexión apuntan a la misma dirección en tu sitio web. Charitable determina qué cuenta usar a partir de tu configuración de Modo de prueba.

¿Cuánto cobra GoCardless?

Las comisiones suelen rondar el 1% por pago, frente al 2,5% al 3% aproximado en los pagos con tarjeta, aunque el precio exacto depende de tu país y de la cantidad que recaudes. Consulta gocardless.com/pricing para ver las tarifas actuales.

También puedes vincular GoCardless con nuestra extensión de Alivio de Comisiones, que invita a los donantes a añadir un poco más para cubrir la comisión de procesamiento.

Mis donaciones no pasan de Pendiente a Pagada. ¿Qué debo comprobar?

Comprueba primero el punto de conexión webhook. La URL en GoCardless tiene que ser tu dirección de inicio seguida de /charitable-listener/gocardless, y el secreto allí tiene que coincidir exactamente con el "Secreto de Webhook" en tu configuración de Charitable. Si estás probando, confirma que también creaste un punto de conexión webhook en la cuenta sandbox.

¿De qué países puedo recibir donaciones?

Más de 30, en los esquemas de Domiciliación Bancaria listados en la parte superior de esta guía. Eso incluye el Reino Unido, la Eurozona, los Estados Unidos, Canadá, Australia, Nueva Zelanda, Suecia y Dinamarca.

Más documentación

Enlaces Útiles

🤝 Obtenga ayuda cuando la necesite

Conecta con Atención al Cliente →

📑 Encuentre la guía que necesita

Explore el Centro de documentación →

⬇️ Descarga estrategias probadas, ideas de campañas y herramientas expertas

Obtén el Kit de Recaudación de Fondos →

🔗 Deja que tu Asistente de IA haga el trabajo de recaudación de fondos por ti.

Conecta Charitable a tu asistente de IA →

💸 Obtén recursos gratuitos de recaudación de fondos
Ve al Centro de Recaudación de Fondos de Charitable →

¿Tienes preguntas sobre Charitable?
Preguntas frecuentes de Charitable →

¿Necesita ayuda para entender la terminología y la jerga de las organizaciones sin ánimo de lucro?
Consulte nuestro Glosario de organizaciones sin ánimo de lucro→

¿Todavía tienes preguntas? ¡Estamos aquí para ayudarte!

Última modificación:

Novedades en Benéfico

Ver las últimas actualizaciones
🔔 Suscríbete para recibir nuestras últimas actualizaciones
📧 Suscribirse a correos electrónicos

Suscripción por correo electrónico

Únete a nuestro boletín

No te enviaremos spam. Solo enviamos un correo electrónico cuando creemos que realmente te ayudará. ¡Date de baja en cualquier momento!

embajadores Nuevo

🖨️ Presentamos Folletos y Carteles: ¡Recauda fondos fuera de la pantalla!

Gran parte de la recaudación de fondos entre particulares ocurre fuera de la pantalla: en la meta de una carrera de 5 km, en un tablón de anuncios escolar, en la cocina de una oficina. Charitable Ambassadors 3.4.7 añade 2 imprimibles: un folleto de recaudación de fondos que lleva la propia historia y código QR de cada recaudador, y un cartel de reclutamiento que inscribe a nuevos recaudadores. Ambos se abren como una página web normal y se imprimen directamente desde el navegador. Por qué esto es importante:

  • 🏁 Un folleto para cada recaudador: Cada uno lleva la foto, la historia y el objetivo del recaudador, con un código QR que abre su página en lugar de la de tu campaña principal.
  • 📌 Un cartel que recluta: Muestra "Reclutando ahora" encima del nombre de tu campaña con un gran código QR que abre tu formulario de inscripción, para que alguien pueda empezar a recaudar fondos sin esperar un enlace tuyo.
  • 🪄 No se necesita herramienta de diseño: Ambos imprimibles se muestran como una página web normal y se imprimen desde el navegador, sin necesidad de plugin PDF ni diseñador.
  • 📄 2 diseños de folleto: "Repartir" lleva la historia completa para dar a amigos y familiares, y "Colgar" lleva un breve gancho con 5 pestañas para arrancar para un tablón de anuncios.
  • 🛡️ Desactivado hasta que lo actives: Los folletos permanecen desactivados después de la actualización hasta que los habilites en Charitable » Ambassadors » Other » Fliers, y solo el propietario o un administrador puede abrir uno.

Consulta nuestro anuncio aquí.

Mejora Pagos

💸 Presentamos las tarifas escalonadas para el alivio de comisiones: ¡Ajusta la petición a la donación!

El alivio de comisiones hace una pregunta corta a tus donantes al finalizar la compra: ¿te gustaría cubrir la comisión de procesamiento de esta donación? Hasta ahora, esa pregunta utilizaba una única tarifa para cada donación en una pasarela, por lo que una donación de 10 $ y una de 500 $ recibían la misma pregunta de porcentaje. El alivio de comisiones 1.3.0 te permite establecer tantas bandas de donación como desees, cada una con su propia tarifa. Por qué esto es importante:

  • 🪙 Más suave con las donaciones pequeñas: Una comisión de transacción fija supone una parte mucho mayor de una donación de 10 $ que de una de 500 $, por lo que las bandas te permiten pedir menos en la parte inferior.
  • 🎚️ Tantas bandas como necesites: Cada banda tiene su propio porcentaje y su propio importe fijo, y la banda superior continúa sin límite superior.
  • 🛑 Un techo opcional: Un campo de comisión máxima evita que se pida a ningún donante más de una cantidad que tú elijas, por muy grande que sea la donación.
  • 🔌 Configurar por pasarela de pago: Stripe puede funcionar con cuatro bandas, mientras que Windcave y Payfast se mantienen con una tarifa única, ya que las bandas pertenecen a una pasarela y no a todo tu sitio.
  • 🛡️ Nada cambia hasta que tú lo digas: Tus tarifas actuales se mantienen exactamente como están hasta que actives Usar tarifas escalonadas en Charitable » Settings » Advanced » Fee Relief.

Consulta nuestro anuncio aquí.

Donaciones Mejora

📊 ¡Tu panel de control Pro ahora puede comparar, exportar y calificar!

La mayoría de los paneles de control de recaudación de fondos solo te dicen cuánto has recaudado. Charitable Pro 1.8.19 reconstruye el panel de control y la Descripción general de informes en torno a las preguntas más difíciles: si algo está roto, si este período superó al anterior y qué cambio único marcaría la mayor diferencia hoy. Por qué esto es importante:

  • 📈 Cada cifra tiene una tendencia: Elige un período y las fichas y el gráfico se mueven juntos, con cada total mostrado frente al período anterior.
  • 🗓️ Gráficos que se mantienen legibles: Los rangos cortos agrupan las donaciones día a día, mientras que los rangos más largos agrupan por semana o mes, por lo que un año completo se lee como una curva en lugar de una línea plana.
  • 🔀 Compara cualquier 2 períodos: No solo los consecutivos, para que puedas preguntar cómo fue este diciembre en comparación con el diciembre pasado. Eso importa porque la recaudación de fondos es estacional.
  • 📤 Exporta el resumen completo: Envía la descripción general completa como CSV o PDF, lista para un paquete de junta directiva o un informe de financiador.
  • 🎯 Califica tu configuración gratis: Haz que tu configuración de recaudación de fondos sea calificada, para que el único cambio que valga la pena hacer a continuación sea el que puedas ver.

Consulta nuestro anuncio aquí.

Función Nuevo

🎟️ Presentamos Eventos Benéficos: ¡Vende entradas dentro de tus campañas!

La mayoría de las organizaciones sin ánimo de lucro venden entradas para eventos en una herramienta y recaudan donaciones en otra, lo que genera dos conjuntos de informes y una conciliación manual al final del año. Eventos Benéficos une ambas cosas, vendiendo entradas a través de los mismos formularios de donación y pasarelas de pago que ya utilizas en Charitable. Por qué esto es importante:

  • 🎟️ Cada entrada es una donación: Las ventas de entradas se procesan a través de la pasarela que ya utilizas y cuentan para el objetivo de la campaña, con todo gestionado en Charitable » Eventos.
  • 📱 Registro con código QR desde cualquier teléfono: Cada asistente recibe su propio código QR en el recibo, y los voluntarios escanean en la puerta a través de un enlace de registro que no necesita cuenta de WordPress.
  • 🧾 Recibos listos para la declaración de impuestos: Asigna a cada tipo de entrada un valor justo de mercado, y Charitable incluirá el importe correcto deducible de impuestos en cada recibo de donante.
  • 📋 Detalles del asistente al finalizar la compra: Pregunta a cada invitado por su elección de comida, talla de camiseta o necesidades de acceso, con un registro de asistente independiente creado para cada entrada.
  • 🗓️ Bloques y calendarios incluidos: Tres bloques de editor, además de la compatibilidad con Sugar Calendar y The Events Calendar, muestran tus eventos donde los colaboradores ya los buscan.

Consulta nuestro anuncio aquí.

ia Nuevo

🚀 ¡Libera el poder de la IA en Charitable!

Tu asistente de IA ahora puede crear, editar y administrar tus campañas de recaudación de fondos de Charitable directamente, solo con pedírselo. Con Charitable Pro añadiendo soporte de escritura para la API de Habilidades de WordPress, herramientas como ChatGPT, Claude y Cursor pueden manejar acciones administrativas completas de forma segura a través de MCP. Por qué esto es importante:

  • 🤖 Creación de campañas en lenguaje natural: Pídele a tu asistente un objetivo como “Configura una recaudación de fondos para el refugio con un objetivo de 5.000 $”, y creará un borrador de campaña real completo con niveles de donación sugeridos.
  • 🎨 Ajustes instantáneos del formulario de donación: Añade campos personalizados, cambia los colores de los botones o reordena elementos sin tener que entrar en la configuración del formulario.
  • 📝 Registro de donaciones sin conexión: Informa a tu asistente sobre donaciones en efectivo o cheque, y cruzará los correos electrónicos de los donantes y registrará las transacciones en tu historial.
  • 🛡️ Seguridad y control por defecto: El acceso de escritura permanece estrictamente desactivado hasta que se active en Charitable » Herramientas » AI MCP, manteniendo el informe de solo lectura seguro por defecto.
  • 📜 Registro de auditoría completo: Cada cambio realizado por un asistente de IA se rastrea en Charitable » Herramientas » Registros, por lo que siempre sabrás quién (o qué) actualizó tu sitio.

Consulta nuestro anuncio aquí.