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 y cómo esto afecta al acceso de tus socios.
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
Fast lane
- Configuración / Configuraciones de conclusión de contrato / Oferta de contrato
- 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 Configuración / Configuraciones de conclusión de contrato / Oferta de contrato. 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.