En este artículo aprenderás a definir por oferta de contrato qué costes se deben cobrar directamente al firmar a través de la Open API, qué ocurre cuando falla un pago, cómo esto afecta al acceso de tus socios y cómo los socios pueden elegir su propia fecha de inicio en las páginas del estudio.
Contenido
- ¿Qué es el pago inicial?
- Configuración en la oferta de contrato
- ¿Qué conceptos forman parte del pago inicial?
- Hacer el pago obligatorio para inscripciones vía Open API
- ¿Qué ocurre cuando falla un pago?
- ¿Cómo funciona el proceso de pago?
- Caso especial: cambio de membresía
- Restricción de acceso por pago inicial pendiente
- Fecha de inicio elegida por el socio en las páginas del estudio
Guía rápida
Si no encuentras un área en la barra lateral izquierda, haz clic ahí en la última entrada, Más. Usa Personalizar la navegación para elegir qué áreas aparecen directamente en la barra lateral.
- Ajustes / Alta de membresías / Ofertas
- Abrir la oferta de contrato deseada
- Acceder a la sección Opciones de oferta
- Seleccionar los tipos de concepto que forman el pago inicial
- Opcional: activar Pago inicial obligatorio para inscripciones vía Open API
- Opcional: activar Cancelar la creación del contrato si falla el cobro del pago inicial
- Guardar
¿Qué es el pago inicial?
Cuando un contrato se firma a través de la Open API, tu partner de API puede cobrar los gastos de inscripción directamente durante el proceso de alta. Tú controlas por oferta de contrato qué tipos de concepto cuentan como pago inicial, si ese pago es obligatorio y qué ocurre si el cobro falla. Estas configuraciones también afectan directamente al acceso de los socios registrados con pagos pendientes.
Configuración en la oferta de contrato
Todos los ajustes relativos al pago inicial se encuentran en la sección Opciones de oferta de la oferta de contrato correspondiente, en Ajustes / Alta de membresías / Ofertas. Abre la oferta que quieras configurar. Los tres nuevos campos aparecen al final de la sección. Las ofertas de contrato existentes se migran automáticamente con los valores predeterminados que se describen a continuación. Tu operativa actual no se ve afectada por este cambio.
¿Qué conceptos forman parte del pago inicial?
En el campo Pago inicial incluye (si es exigible en la firma) seleccionas mediante selección múltiple qué tipos de concepto forman el pago inicial. Las opciones disponibles son: cuota, paquete de inicio , módulos adicionales y tarifa plana. Por defecto, las cuatro opciones están activadas.
Importante: solo se incluyen los conceptos que sean exigibles en el momento de la firma del contrato. Los pagos futuros no forman parte del pago inicial. Esta definición no solo aplica a las inscripciones vía Open API, sino que también sirve como base para la restricción de acceso en el resto de canales de firma de contratos.
Hacer el pago obligatorio para inscripciones vía Open API
La opción Pago inicial obligatorio para inscripciones vía Open API está inactiva por defecto. Cuando la activas, tu partner de API debe incluir un token de pago válido en el momento de la firma del contrato. El sistema comprueba automáticamente si el importe autorizado coincide exactamente con la suma de todos los conceptos exigibles. Si los importes no coinciden, la inscripción se interrumpe y no se crea ningún contrato.
Si la opción está inactiva, no se puede incluir ningún token de pago en la inscripción. En ese caso, no es posible realizar un pago inicial a través de este canal.
Puedes activar esta opción de forma progresiva: define primero los conceptos y activa la obligatoriedad cuando estés operativamente preparado. Ambos pasos son independientes entre sí.
¿Qué ocurre cuando falla un pago?
La opción Cancelar la creación del contrato si falla el cobro del pago inicial está inactiva por defecto. Se aplica cuando el cobro real del pago falla tras completarse la inscripción.
- Opción activa: El sistema revierte la creación del contrato. El contrato se elimina. El registro del cliente se conserva. El acceso queda restringido hasta que se complete una nueva inscripción correctamente.
- Opción inactiva (valor predeterminado): El contrato permanece activo. El importe pendiente queda registrado en la cuenta del socio y puede cobrarse mediante los procesos habituales, por ejemplo a través de un proceso de pagos o una reclamación.
¿Cómo funciona el proceso de pago?
Para entender en qué momento puede producirse un error, aquí tienes un resumen del proceso: cuando un socio se inscribe a través de la Open API, autoriza el pago de antemano a través de la interfaz de pago de tu partner. Esta autorización reserva el importe pero aún no lo cobra. El cobro efectivo se produce una vez que el contrato y los cargos correspondientes han sido registrados en el sistema. Un error puede ocurrir en este paso, por ejemplo si la tarjeta ha sido bloqueada o la autorización ha caducado mientras tanto. Si el token de pago no se utiliza dentro de su período de validez, la autorización se cancela automáticamente y el importe queda liberado.
Para los partners de API: el endpoint preview devuelve el indicador mandatoryOnSigning para cada concepto exigible, así como la suma total de todos los conceptos obligatorios en el campo dueOnSigningAmount. El token de pago solo debe solicitarse y enviarse en base a ese importe exacto.
Caso especial: cambio de membresía
En los cambios de membresía a través de la Open API, se aplican en principio los mismos ajustes que en una inscripción inicial. Existe una excepción: si en la oferta de contrato está activada la opción para omitir los costes iniciales al inicio de la membresía, todos los conceptos se tratan como no exigibles en el momento del cambio. En ese caso, el endpoint preview devuelve mandatoryOnSigning: false para todos los conceptos y el importe total exigible es cero. El endpoint de cambio no acepta ningún token de pago en este escenario.
Restricción de acceso por pago inicial pendiente
Si en la configuración de restricción de acceso de tu gimnasio está activada la opción de restringir el acceso por pagos iniciales no saldados, se aplican los siguientes escenarios:
- El pago fue autorizado pero el cobro falla más tarde, sin reversión: El contrato permanece activo. El acceso del socio queda restringido hasta que se salde el importe pendiente.
- El pago no era obligatorio en la inscripción: El acceso del socio queda restringido hasta que el pago inicial se abone de forma retroactiva.
- El pago falla y la reversión está activa: No existe ningún contrato. El registro del cliente se conserva, pero sin una membresía activa el acceso no es posible.
- Inscripciones a través de otros canales, como la herramienta de ventas, la plataforma de socios o las páginas de membresías: estos contratos también están sujetos a la restricción de acceso si el pago inicial está definido en la oferta de contrato y no ha sido saldado. El acceso solo se concede cuando todos los conceptos definidos han quedado liquidados en la cuenta del socio.
Fecha de inicio elegida por el socio en las páginas del estudio
Disponible a partir del 7 de octubre de 2026.
En las páginas de tu estudio puedes permitir que los nuevos socios elijan ellos mismos la fecha de inicio de su contrato durante el alta en línea. No es un ajuste de la Open API: lo activas por separado para cada página, así que tú decides en qué páginas se ofrece la selección de fecha.
- Abre Ajustes / Páginas web de Magicline / Páginas de pago y selecciona la página.
- Edita la sección Página de tarifas. Se abre el cuadro de diálogo Editar la configuración.
- Activa Permitir a los miembros seleccionar la fecha de inicio de su afiliación y guarda.
La imagen muestra la interfaz en inglés: sección Página de tarifas de una página del estudio con el estado de la opción para que los socios elijan la fecha de inicio.
La imagen muestra la interfaz en inglés: cuadro de diálogo Editar la configuración con la casilla para permitir a los socios seleccionar la fecha de inicio.
Durante el alta en esta página, los socios verán un paso adicional en el que eligen la fecha de inicio:
- El campo de fecha aparece rellenado con la fecha de inicio más temprana posible de la oferta de contrato. En las ofertas que empiezan con la firma del contrato, es el día de hoy.
- Los socios pueden elegir una fecha posterior, hasta 365 días después de la fecha de inicio más temprana posible. No se aceptan fechas anteriores.
- Si en la oferta de contrato la opción Inicio del contrato está configurada como Fecha fija, la selección de fecha no se muestra y se aplica la fecha fija. Los socios no pueden cambiarla.
Para saber cómo se relacionan la fecha de inicio del contrato y el inicio de uso, consulta el artículo Uso precontractual, periodos de bonificación y fecha de inicio elegida por el socio.
Aviso: Este artículo se ha creado con ayuda de inteligencia artificial y traducido automáticamente sin revisión editorial. Disculpa los posibles errores.