Documentación de Charitable

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

Cómo conectar tu cuenta de prueba de Square en Charitable

Probar tu pasarela de pago de Square antes de lanzar garantiza que las donaciones funcionen sin problemas cuando lo hagas. Esta guía te muestra cómo conectar tu cuenta de sandbox (de prueba) de Square con Charitable.

Requisitos previos

Antes de empezar, asegúrate de tener:

  • Una cuenta de Square
  • Complemento Charitable instalado y activado
  • Acceso de administrador de WordPress

En esta guía

Respuestas rápidas

Hice clic en “Conectar a Square (Sandbox)” y apareció una pantalla blanca en blanco. ¿Qué pasó?

Este es un requisito de Square, no un error de Charitable. Antes de hacer clic en Conectar, abre tu Panel de control de Sandbox de Square en otra pestaña del mismo navegador y déjala abierta. Luego, vuelve a Charitable y haz clic en Conectar de nuevo. Los pasos completos están en el Paso 1 a continuación.

¿Mi correo electrónico de WordPress y mi correo electrónico de Square deben coincidir?

No. Tu correo electrónico de administrador de WordPress, tu correo electrónico de cuenta de Square en vivo y tu correo electrónico de cuenta de prueba de Sandbox de Square pueden ser todos diferentes. Eso es normal y esperado. Charitable se conecta a Square a través de un flujo de autorización seguro (OAuth), no comparando direcciones de correo electrónico.

¿Qué es el sandbox de Square?

El sandbox de Square es un entorno de prueba que replica Square en vivo sin procesar dinero real. Puedes probar el flujo completo de donaciones, el manejo de errores y los correos electrónicos de confirmación utilizando los números de tarjeta de prueba de Square. Las transacciones de sandbox nunca llegan a una cuenta bancaria real.

Paso 1: Crea tu cuenta de sandbox de Square

Regístrate en Square si aún no lo has hecho, luego inicia sesión en tu Consola de desarrollador de Square.

Nota: La Consola de desarrollador es para administrar aplicaciones y acceso a la API. El Panel de control de Square es para operaciones comerciales generales. Son dos lugares diferentes.

Deberías ver una página como esta:

Pestaña de aplicación de Square

Desde la navegación de la izquierda, abre la página de Cuentas de prueba de Sandbox. Verás una cuenta de prueba predeterminada junto con un enlace al Panel de control de Square.

Pestaña de prueba sandbox con enlace al panel de control de Square

Haz clic en el enlace Panel de control de Square. Se abrirá una nueva pestaña con tu panel de control de Sandbox de Square. Verás un indicador de Sandbox en la parte superior, lo que confirma que este no es tu panel de control en vivo.

Panel de control sandbox de Square

Importante: Mantén esta pestaña del panel de control de Sandbox abierta y activa durante todo el proceso de conexión. Este es un requisito de Square (no de Charitable) y es necesario para que la conexión funcione correctamente. Si cierras la pestaña, verás una pantalla blanca en blanco cuando intentes conectarte.

Paso 2: Conecta Charitable a Square

Con la pestaña del panel de control de Sandbox todavía abierta, cambia a tu administrador de WordPress. Desde el menú de la izquierda, ve a Charitable > Ajustes > Pasarelas de pago.

Haz clic en Habilitar pasarela junto a Square si aún no lo has hecho:

Habilitar pasarela Square de Charitable

En la misma página, activa el Modo de prueba; esto es lo que le dice a Charitable que se conecte al sandbox en lugar de a Square en vivo. Haz clic en Guardar cambios.

Activar modo de prueba

Ahora haz clic en Ajustes de la pasarela para abrir la configuración de Square. Busca la sección Estado de la conexión y haz clic en Conectar a cuenta de Square (Sandbox).

Estado de la conexión de Square sandbox

Square te pedirá que autorices la conexión. Haz clic en Permitir, luego regresa a Charitable y haz clic en Guardar cambios para finalizar.

Recordatorio: La pestaña del panel de control de Square sandbox debe permanecer abierta en otra pestaña del navegador mientras te conectas. Mantenla abierta para cualquier prueba futura de Square, no solo para la configuración inicial.

Paso 3: Prueba tu conexión

Realiza una donación de prueba en una de tus campañas utilizando uno de los números de tarjeta de prueba de Square (por ejemplo, 4111 1111 1111 1111 para un cargo exitoso de Visa). Luego verifica:

  • La donación aparece en Charitable > Donaciones
  • La transacción aparece en tu Panel de control de Square Sandbox en Transacciones
  • Se envía el correo electrónico del recibo del donante y tiene el aspecto correcto

Si los tres coinciden, tu conexión está funcionando.

Paso 4: Cambia a pagos en vivo

Una vez que estés seguro de que la conexión sandbox funciona, cambia Charitable al modo en vivo:

  1. Ve a Charitable > Ajustes > Pasarelas de pago y haz clic en Ajustes de la pasarela junto a Square.
  2. Desactiva Modo de prueba y haz clic en Guardar cambios.
  3. En la sección Estado de la conexión, haz clic en Conectar a cuenta de Square (sin la etiqueta sandbox esta vez) y autoriza tu cuenta real de Square.

Tus donaciones en vivo ahora serán procesadas por tu cuenta real de Square.


Más preguntas

¿Cómo desactivo el Modo de prueba en Charitable?

Ve a Charitable > Ajustes > Pasarelas de pago, haz clic en Ajustes de la pasarela junto a Square, desactiva Modo de prueba y haz clic en Guardar cambios.

Quiero probar con la moneda de otro país. ¿Cómo?

En el Panel de desarrollador de Square, ve a Cuentas de prueba sandbox y haz clic en Nueva cuenta de prueba sandbox. Elige el país cuya moneda deseas probar, luego conecta Charitable a esa cuenta usando los mismos pasos anteriores.

¿Dónde puedo encontrar más consejos y asesoramiento para organizaciones sin fines de lucro de Charitable?

Compartimos regularmente guías prácticas, estrategias probadas y consejos de expertos para ayudarte a recaudar más fondos y construir relaciones más sólidas con los donantes:

¿Necesitas ayuda con otras funciones de Charitable? Consulta nuestras otras guías de documentación o contacta con soporte.

¿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í.