Cobros trimestrales y precio recurrente

El dueño de Pabilo puede fijar un importe total por período desde Admin → Usuarios → Ajustes. Para Pro de USD 30: tres meses cuestan USD 90; un total personalizado de USD 80 aplica un descuento de USD 10 por trimestre.

PUT /v1/admin/users/USER_ID/custom-data
Authorization: Bearer OWNER_ACCESS_TOKEN
Content-Type: application/json

{"billing_months":3,"custom_billing_price":80}

billing_months acepta 1, 3, 6 o 12. custom_billing_price es el total del período; null restaura el precio de lista, 0 define un precio gratuito y un campo ausente conserva el ajuste. No envíes custom_plan_price y custom_billing_price juntos. custom_plan_price se conserva como precio base por compatibilidad; no redondees su equivalente mensual antes de calcular el total.

La frecuencia nueva no extiende el período que ya está vigente. Para corregir tiempo ya pagado se ajusta la fecha de corte, sin registrar un segundo pago. No se permite cambiar la duración de una próxima renovación que ya esté autorizada.

El modal de enlace permite un descuento solo para ese cobro o recurrente. En contabilidad, las deudas y cortesías no suman ingresos; un pendiente pasa a ingreso al recibirse, en la fecha de cobro. Los pagos antiguos se conservan aunque el usuario no vuelva a renovar. La proyección futura es una estimación que excluye cuentas vencidas, inactivas, deshabilitadas y de prueba.

Renovación pública y precio calculado

El enlace /renovation/USER_ID funciona sin iniciar sesión. La consulta pública devuelve únicamente la información necesaria para renovar; no devuelve el perfil completo, saldo ni configuración del dueño.

GET /v1/plans/renovation/user/USER_ID/quote

{"plan_name":"Mensual","billing_months":3,"amount_usd":"37.05","amount_bs":"1482.00","exchange_rate":40,"can_renew":true,"status":"pending","message":"Puedes renovar tu plan"}

amount_usd y amount_bs son strings con dos decimales calculados en el backend. Incluyen el precio personalizado y el período de facturación (1, 3, 6 o 12 meses); no los multipliques de nuevo. Al pagar, el backend recalcula el importe con la tasa vigente y valida el pago real. Consulta nuevamente antes de transferir.

status=free indica que no requiere renovación; status=paid, que ya está cubierta. Ambos devuelven can_renew=false. El pago de planes gratuitos se rechaza antes de consultar el banco.

POST /v1/plans/renovation/user/USER_ID/pay
Content-Type: application/json

{"bank_reference":"REFERENCIA_REAL","movement_type":"GENERIC"}

Usa los campos requeridos del banco del sistema para el tipo de verificación. La ruta pública no requiere Authorization. El importe esperado se decide en el servidor, nunca a partir del monto enviado por el navegador.