Qué resuelve
Suscripción permite seleccionar o cambiar el plan del tenant y comenzar o cancelar la renovación automática cuando el proveedor lo soporta.
Datos que carga la pantalla
El backend devuelve planes con precio mensual/anual, proveedor configurado, orden de gateways y estado actual de billing.
El plan actual puede mostrar proveedor, importe, estado y próxima fecha de cobro.
Modalidades
| Modalidad | Comportamiento |
|---|---|
| Mensual con débito automático | Renovación mensual automática cuando Mercado Pago recurring está disponible |
| Mensual manual | Pago manual cada mes |
| Anual | Pago único anual con descuento indicado por el producto |
Si el comercio ya tiene Mercado Pago recurrente activo, la pantalla puede seleccionar mensual recurrente automáticamente.
Selección de gateway
La plataforma decide el gateway según configuración y modalidad. Para recurrente, Mercado Pago debe soportar recurring; si no, puede recurrir a Payway cuando esté configurado. Los pagos manuales usan el orden configurado por plataforma.
Si no hay gateways configurados, el botón queda inutilizable y se informa que el administrador debe configurar medios.
Cambio de plan
Cuando el plan seleccionado es diferente al actual, la pantalla consulta un upgrade quote. El prorrateo considera días restantes y diferencia entre planes.
Durante un cambio de plan se fuerza modalidad mensual manual para el cobro del prorrateo; no se recrea inmediatamente un preapproval recurrente.
Si el prorrateo es cero, el cambio puede aplicarse sin un cobro adicional.
Payway
Cuando el gateway seleccionado es Payway, la pantalla abre un formulario de tarjeta y tokeniza directamente contra el endpoint configurado de Payway antes de enviar el token a Structura.
Campos:
- número;
- nombre;
- mes/año de vencimiento;
- CVV;
- DNI del titular.
En sandbox la pantalla puede mostrar datos de prueba. No uses esos datos en producción.
Mercado Pago recurrente
Cuando existe una suscripción recurrente activa, la pantalla muestra plan actual, importe, próxima fecha y acción Cancelar suscripción.
Cancelar requiere confirmación y llama al endpoint específico de cancelación. No debe confundirse con cambiar de plan.
Estados de la pantalla
- loading;
- select;
- card;
- processing;
- done.
Un redirect de Mercado Pago con mp_sub=ok significa que Structura está confirmando la suscripción; no debe interpretarse como autorización definitiva por sí solo.
Diagnóstico
No hay medios: revisar configuración de billing de plataforma.
No puedo recurrente: verificar recurring de Mercado Pago y configuración del gateway.
Upgrade cobra mal: revisar quote, días restantes y plan objetivo antes de repetir.
Tarjeta rechazada: no repetir indiscriminadamente; revisar tokenización, datos y respuesta de Payway.
Suscripción cancelada: verificar nuevamente estado del billing antes de contratar otra.