¿Le gustaría que Charitable reciba actualizaciones en tiempo real cuando se complete o se reembolse un pago a través de Square? Con los webhooks de Square habilitados, sus formularios pueden mantenerse sincronizados con Square para que los estados de pago estén siempre actualizados.
Esta guía le mostrará cómo conectar fácilmente los webhooks de Square con Charitable, asegurando que su sitio web se mantenga sincronizado con sus actividades de Square.
Antes de empezar, asegúrese de instalar Charitable en su sitio de WordPress. Después de eso, conecte su sitio a su cuenta de Square.
Entendiendo los Webhooks
Los webhooks son una forma para que Square notifique a Charitable cuando ocurre un evento en su cuenta, como una actualización o un reembolso de un pago. Una vez habilitado, Charitable escucha estos eventos para que su sitio pueda reflejar los cambios en el estado del pago automáticamente.
Con los webhooks de Square configurados, no necesita comprobar ni actualizar manualmente las entradas de sus formularios después de procesar una transacción. Ya sea que un pago se complete, se reembolse o se devuelva parcialmente, su panel de Charitable se mantendrá actualizado según la información más reciente de Square.
Habilitar Webhooks en Charitable
Estos son los pasos que seguiremos en esta guía:
Paso 1: Habilitar Pagos con Square
Para empezar, abra su área de administración de WordPress y vaya a la pestaña Charitable » Configuración » Pasarelas de pago .
Aquí verá una lista de pasarelas de pago disponibles que puede habilitar/deshabilitar con un solo clic. En caso de que los pagos con Square aún no se hayan habilitado, haga clic en el botón ‘Habilitar Pasarela’ aquí.
Una vez habilitado, aparecerá un botón verde de ‘Ajustes de Pasarela’. Haga clic en él para pasar al siguiente paso.
Paso 2: Conectar con Square
En la página de Ajustes de Pasarela de Square, verá una sección de Estado de Conexión con un botón que dice “Conectar a Cuenta de Square”. Selecciónelo y se abrirá la página de inicio de sesión de Square.
Introduzca sus credenciales e inicie sesión en su cuenta de Square. Verá una página que le pide que conceda permiso a Charitable.
Seleccione “Permitir” y Charitable se sincronizará con Square.
Cuando se conecte, será redirigido de vuelta a la página de Ajustes de Pasarela de Square en Charitable.
Charitable obtendrá automáticamente las ubicaciones de su negocio, y podrá seleccionarlas de un menú desplegable aquí. Esto le da la capacidad de cambiar de ubicación cuando lo necesite.
Paso 3: Habilitar Webhooks en Square
Hemos hecho que habilitar webhooks con Square sea lo más fácil posible. Es solo copiar y pegar. Simplemente siga los pasos a continuación.
Primero, en la misma página de Ajustes de Pasarela de Square, verá una sección de Habilitar Webhooks.
Aquí, hay una URL de webhook disponible. Deberá agregarla en su Consola de desarrollador de Square (developer.squareup.com). Haga clic en el icono del portapapeles para copiarla rápidamente.
Vaya a su Consola de desarrollador de Square en developer.squareup.com (este es el sitio del desarrollador, no el panel de su cuenta de Square normal) e inicie sesión con la misma cuenta de Square que conectó anteriormente. Abra la aplicación que usa con Charitable, o cree una haciendo clic en el “+” en la página de Aplicaciones y dándole un nombre como “charitable-listener”. Cada aplicación puede ejecutarse en modo Sandbox o Producción: si el Modo de prueba de Charitable está activado, use Sandbox; si el Modo de prueba está desactivado, use Producción. Con el modo correcto seleccionado, abra la pestaña Webhooks » Suscripciones.
Aquí verá todos los webhooks que ha configurado.
Elige el botón ‘Añadir suscripción’ para crear un nuevo webhook.
Ahora, puedes añadir un nombre para tu webhook para que puedas reconocerlo fácilmente en el futuro.
Debajo de eso, pega la URL que copiaste.
Ahora hay un paso más aquí. Verás una lista de Eventos debajo de esto.
Necesitarás seleccionar 5 eventos específicos aquí:
- factura.pago_realizado
- oauth.autorizacion.revocada
- pago.creado
- pago.actualizado
- reembolso.actualizado
Si usa donaciones recurrentes, también seleccione subscription.created y subscription.updated. Puede encontrar la lista completa de eventos requeridos dentro de su panel de control de Charitable. Debajo de la URL del webhook que copió, verá la lista de suscripciones de webhook requeridas.
Una vez que haya elegido estos eventos en su Consola de desarrollador de Square, presione el botón 'Guardar' en la parte superior para guardar su nuevo webhook.
¡Eso es todo! Has conectado tu cuenta de Charitable a los webhooks de Square.
Ahora puede ir a la pestaña Webhooks » Suscripciones, y verá el webhook que acaba de configurar.
Después de guardar la suscripción, copie su Clave de firma de la Consola de desarrollador de Square y péguela en el campo Clave de firma en la sección Habilitar Webhooks en Charitable. Charitable utiliza esta clave para verificar que los webhooks entrantes provienen genuinamente de Square. Luego, asegúrese de 'Guardar Cambios' también dentro de la página de Configuración de la Pasarela Square en su panel de administración de WordPress.
Recomendamos hacer una o dos donaciones de prueba para asegurarte de que tu conexión funciona correctamente.
Ahora, cuando un donante hace una contribución usando pagos de Square, aparecerá en el recibo de donación así:
Ver Donaciones de Square dentro de Charitable
Cuando se realiza una donación, Charitable registrará los detalles de la transacción.
Puedes acceder a esto en Charitable » Donaciones.
Aquí puedes ver todas las donaciones realizadas a través de todas las pasarelas de pago que hayas habilitado en tu sitio.
Charitable muestra los detalles de la donación, como el nombre, la dirección de correo electrónico, el importe donado, la pasarela de pago, la campaña y el estado.
Esto te da una vista general de todas las donaciones recibidas.
Cualquier transacción realizada a través de la pasarela de pago Square también aparecerá en tu panel de control de Square en la pestaña Pagos y facturas » Transacciones, así:
A continuación, te mostraremos cómo emitir reembolsos de Square.
Reembolsar Donaciones Hechas con Square
Charitable te facilita la emisión de reembolsos en cualquier donación realizada a través de Square. Ve a Charitable » Donaciones y edita el registro de donación que necesitas reembolsar.
En la barra de tareas derecha, en la sección Acciones de Donación, elige el estado ‘Reembolsado’ en el menú desplegable.
Verás que aparece una casilla de verificación para ‘Reembolsar en Square automáticamente’. Marca esta casilla y haz clic en el botón ‘Actualizar Estado’.
Eso es todo. Verás la actividad de reembolso aparecer en el registro de actividad de la misma página.
El reembolso será emitido por Square. Puedes visitar tu panel de control de Square y ver que se ha realizado el pago del reembolso.
Ahora sabes cómo configurar webhooks de Square con Charitable.
Preguntas frecuentes
Estas son las respuestas a algunas de las preguntas más frecuentes que recibimos sobre la configuración de webhooks de Square en Charitable.
¿Cómo habilito los pagos de Square en Charitable?
En tu panel de control de Charitable, ve a Ajustes » Pasarelas de pago y habilita la pasarela de pago de Square. Luego, sigue nuestra guía de configuración de Square para completar la conexión.
¿Necesito configurar webhooks tanto para el modo de prueba como para el modo en vivo?
Sí, Square proporciona credenciales separadas para los entornos Sandbox (Prueba) y Producción (En vivo). Asegúrate de usar el token de acceso correcto según si el modo de prueba está habilitado en los ajustes de tu Charitable.
¿Puedo habilitar varias pasarelas de pago junto con Square?
Sí, Charitable permite habilitar varias pasarelas de pago. También puedes habilitar pasarelas específicas para diferentes campañas.
A continuación, ¿te gustaría saber más sobre la creación de campañas en Charitable? Consulta nuestro tutorial sobre cómo crear tu primera campaña con Charitable.
