Pagos
Esta página explica cómo se crean los pagos en Agon, cómo conectar tu propia cuenta de Stripe para pagos en línea con tarjeta, y dónde ver los totales de pagos.
Pagos no es una página propia en el menú lateral. Los ajustes relacionados con los pagos están en Configuración → Facturación, y los totales de pagos en Informes → Ingresos.
Cómo funcionan los pagos en Agon
Agon no procesa los pagos por sí mismo y no tiene una pantalla para registrar manualmente un pago
ni un botón de reembolso. Un Payment se crea automáticamente de dos formas:
- Pago con Stripe — una vez conectada tu propia cuenta de Stripe (ver más abajo), un cliente puede pagar en línea una membresía, o una tarjeta regalo comprada para sí mismo, desde la aplicación móvil. El dinero fluye directamente entre el cliente y tu propia cuenta bancaria; Agon nunca retiene fondos.
- Una tarifa por cancelación tardía o inasistencia — cuando realmente se cobra (ver
Configuración — política de cancelación y
Membresías — tarifas específicas), Agon la registra como un
Paymentcon proveedorsystem.
Asignar manualmente una membresía a un cliente (ver Membresías) no crea un pago — solo asigna la membresía. Si un cliente te paga en efectivo o por transferencia, actualmente no hay forma de registrar ese pago en Agon: simplemente asignas la membresía, igual que harías con una prueba gratuita.
Las ventas de productos de tienda se registran por separado (ver POS / Venta al por menor)
como su propio tipo de registro, no como filas de Payment — aparecen en el informe de Ventas de
Productos, no en Ingresos.
Conectar Stripe
Agon ofrece dos formas de conectar tu propia cuenta de Stripe. Para la mayoría de gestores, Connect with Stripe es la opción más sencilla, ya que nunca tienes que buscar ni pegar una clave API tú mismo. Si ya tienes tus propias claves API de Stripe, o prefieres no usar el flujo OAuth, puedes introducirlas manualmente — ambos caminos están totalmente soportados.
Opción A: Connect with Stripe (recomendada)
- Ve a Configuración → Facturación.
- Haz clic en Connect with Stripe.
- Tu navegador abre la página de autorización alojada por Stripe. Inicia sesión en tu cuenta de Stripe existente, o crea una, y autoriza a Agon.
- Stripe te redirige a una breve página de confirmación alojada por Agon. Cierra esa pestaña y vuelve a Agon.
- El estado Conexión con Stripe en Configuración → Facturación pasa a Conectado — automáticamente cuando vuelves a la ventana de Agon, o tras hacer clic en Actualizar estado.
Esto conecta directamente tu propia cuenta de Stripe — Agon nunca retiene tus fondos, y no hay ninguna cuenta de plataforma compartida entre tú y Stripe.
Opción B: introduce tus claves API de Stripe manualmente
Usa este camino si ya tienes tus claves API de Stripe a mano, o prefieres no usar el flujo OAuth anterior.
- Ve a Configuración → Facturación y abre Opciones avanzadas.
- Introduce tu Clave secreta y tu Clave pública, desde tu propio panel de Stripe (Developers → API keys).
- Haz clic en Guardar.
El estado Conexión con Stripe pasa a Conectado una vez guardadas claves válidas.
Configurar el webhook
El campo Secreto del webhook siempre está visible en Configuración → Facturación — nunca está oculto en Opciones avanzadas — porque Agon lo necesita para saber de forma fiable cuándo un pago se completa, una suscripción se renueva, un pago falla o se cancela.
- Si te conectaste con la Opción B (claves manuales), Agon registra el webhook automáticamente por ti. No hay nada más que hacer.
- Si te conectaste con la Opción A (Connect with Stripe), las restricciones propias de Stripe normalmente impiden que Agon registre el webhook automáticamente — es una limitación de la plataforma de Stripe, no algo que Agon no haya conseguido implementar. Agon te muestra la URL exacta del webhook a registrar, y tendrás que crear el webhook tú mismo, una sola vez, en tu propio panel de Stripe — consulta Configuración del webhook de Stripe para los pasos exactos.
Si tu estudio tiene un tipo de membresía recurrente (suscripción) activo pero ningún secreto de webhook guardado, Agon muestra un aviso en Configuración → Facturación, ya que la facturación recurrente no tiene otra forma de detectar renovaciones, fallos o cancelaciones.
Cambiar o eliminar tus claves de Stripe
No existe una acción separada "Desconectar Stripe". Para dejar de aceptar pagos con Stripe, revoca o regenera la clave desde tu propio panel de Stripe — los pagos de los clientes fallarán hasta que guardes una nueva clave funcional en Configuración → Facturación, o sustituye las que ya no quieras usar.
Emitir un reembolso
Agon no tiene un botón de reembolso propio:
- Pago con Stripe — procesa el reembolso desde tu panel de Stripe. Agon recibe el resultado en el siguiente webhook, que actualiza el estado del pago aquí.
- Efectivo o transferencia — devuelve el dinero tú mismo; no hay nada que actualizar en Agon en ningún caso, ya que ese pago nunca se registró aquí.
Estados de pago
| Estado | EN | IT | FR | DE | ES | PT | NL |
|---|---|---|---|---|---|---|---|
| Completed | Completed | Completato | Complété | Abgeschlossen | Completado | Concluído | Voltooid |
| Refunded | Refunded | Rimborsato | Remboursé | Erstattet | Reembolsado | Reembolsado | Terugbetaald |
| Failed | Failed | Fallito | Échoué | Fehlgeschlagen | Fallido | Falhou | Mislukt |
Ver los totales de pagos
Ve a Informes → Ingresos para el ingreso total, el número de pagos y el importe medio del
pago en un rango de fechas. Actualmente no existe una pantalla que liste el historial de pagos de
un cliente concreto. Las membresías asignadas manualmente y pagadas en efectivo tampoco aparecen
en Ingresos, ya que nunca crean un registro Payment (ver arriba).
¿Y si algo sale mal?
Un pago con Stripe aparece como Pendiente Espera unos minutos — los webhooks de Stripe pueden retrasarse. Si sigue pendiente después de 10 minutos, revisa tu panel de Stripe y comprueba que el Secreto del webhook en Configuración → Facturación coincide con el que se muestra en Stripe.
La conexión con Stripe aparece como No conectado Ve a Configuración → Facturación y haz clic de nuevo en Connect with Stripe, o, si usas el camino manual, vuelve a introducir tu Clave secreta y tu Clave pública en Opciones avanzadas.
Mis cifras de Ingresos parecen más bajas de lo que realmente he cobrado
Comprueba si algunas membresías se asignaron manualmente en lugar de pagarse mediante el checkout
de Stripe — esas nunca crean un registro Payment, así que no cuentan en Ingresos.