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.

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.

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.

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”.

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.

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.

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.

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”.

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.

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.

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

• Instalación de extensiones de Charitable
• Configuración de pasarelas de pago
• Configurar Donaciones Recurrentes
• Integración GoCardless para Charitable