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:
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.
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.
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:
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.
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).
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:
- Ve a Charitable > Ajustes > Pasarelas de pago y haz clic en Ajustes de la pasarela junto a Square.
- Desactiva Modo de prueba y haz clic en Guardar cambios.
- 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:
- Únete a nuestro boletín – Recibe consejos regulares y guías exclusivas en tu bandeja de entrada
- Suscríbete a nuestro canal de YouTube – Mira tutoriales paso a paso e historias de éxito
- Síguenos en LinkedIn – Conecta con nuestra comunidad y obtén información diaria sobre organizaciones sin fines de lucro
- Síguenos en TikTok – Vídeos interesantes y divertidos para ayudarte a hacer crecer tu causa
¿Necesitas ayuda con otras funciones de Charitable? Consulta nuestras otras guías de documentación o contacta con soporte.
