Un usuario abrió el miniprograma un martes y su suscripción había desaparecido. Nuestro backend decía que se había renovado tres días antes, que el cobro se había liquidado y que el callback firmado seguía esperando en la cola. No había pasado nada de eso. La autorización de adeudo automático del anfitrión había caducado en silencio, el cargo nunca llegó al riel de pagos y el único aviso de impago que podíamos enviar lo había desactivado un cambio de normativa del que nadie nos avisó. La marca de «activa» en nuestro servidor era un cuento que nos habíamos contado nosotros.

Mira, aquí está la cuestión: dentro de un miniprograma, renovar no es una fecha en tu base de datos. Es una negociación entre tu servidor, la autorización de cobro del anfitrión, sus reglas de mensajería y un sistema de cuentas que no es tuyo. Si lo tratas como un booleano en almacenamiento local, seguirás enviando el bug de arriba versión tras versión.

Quién tiene el estado de verdad

El anfitrión tiene el mandato. Tu servidor tiene el libro de derechos. El cliente no tiene nada en lo que puedas confiar, porque el cliente es justo donde un usuario borra datos, cambia de móvil o entra por otra super app. Cuando aceptas ese reparto, casi todos los incidentes de renovación dejan de ser misteriosos.

FaseQuién tiene el estadoQué cambian las reglas del anfitriónEl accidente típico
Autorización de adeudoEl riel de pagos del anfitriónLos mandatos caducan, los permisos cambian, reautorizar es un flujo del anfitriónMarcas «renovada» en local y el dinero nunca se movió
Intento de cobroTu servidor, como tarea idempotenteLos tiempos de callback y las ventanas de reintento difierenUn webhook reiterado sin clave de idempotencia cobra dos veces
Periodo de graciaTu libro de derechosEl anfitrión puede cortar el acceso antes de que acabe tu graciaUsuario bloqueado mientras la interfaz dice activa
Aviso de falloEl canal de mensajes del anfitriónIDs de plantilla, horarios silenciosos, bajasEl aviso nunca llega y la baja parece un bug aleatorio
Sincronización de derechosTu servidor, conciliado entre anfitrionesLa misma persona, distinto ID de cuenta en cada super appPaga en uno y se queda fuera en el otro
ReembolsoAnfitrión más tu libroVentanas de reembolso, reglas de periodo parcialAcceso revocado pero el libro sigue diciendo pagado

Fíjate en cuántas veces la última columna viene a decir «nos creímos nuestros propios datos». Ese es el patrón. Un estado de renovación que solo vive en el frontend es una caché sin fuente de verdad, y las cachés se quedan viejas de la forma más cara: el usuario ve un muro de pago que ya había pagado por quitarse de encima.

Lo que nadie mete en la presentación

No vamos a fingir que el anfitrión es un tubo neutro. Hay una comisión, y lo que pesa más, hay reglas que se mueven. Una plantilla de mensaje en la que apoyabas el cobro fallido puede retirarse; un mandato que funcionó dieciocho meses puede empezar a exigir que el usuario vuelva a vincular su tarjeta; una revisión de categoría puede cambiar cómo se permite facturar en tu sector. Construyes sobre el contrato de otro, y ese contrato tiene una cláusula de enmienda en la que no votas.

Y está el coste de hacerlo bien. Tareas de conciliación, claves de idempotencia en cada cargo, un libro que guarde los límites del periodo en vez de un único campo is_active, y una política de reintentos que sepa distinguir entre «tarjeta rechazada, prueba mañana» y «autorización perdida, pide al usuario que la renueve». Es ingeniería de verdad, y para un equipo pequeño es más trabajo que la función que necesitaba la suscripción. Nos ha tentado saltárnoslo. Todas las veces, el atajo volvió en forma de tickets de soporte.

Los derechos entre plataformas son el otro lío honesto. Si el mismo producto corre en dos anfitriones, tienes dos sistemas de cuentas, dos rieles de pago y dos juegos de callbacks, y una persona que espera que su suscripción la acompañe. Mapear esas identidades sin guardar más datos personales de los necesarios es, por sí solo, un pequeño proyecto de privacidad. Además, los reembolsos no respetan tu arquitectura: el anfitrión puede revertir un cargo en una línea temporal que tu libro no modeló, así que «pagado» y «con derecho» tienen que ser campos separados que puedan no coincidir unos días sin romper nada.

La regulación añade la última vuelta. La información sobre renovación automática, las rutas de cancelación y las normas de opción negativa varían por mercado, y el checkout del anfitrión no te vuelve conforme por arte de magia. Preferimos tener ese texto y ese flujo bajo nuestro control antes que dar por hecho que la plataforma lo cubrió.

Conciliar, no pintar

Empieza por asumir que cada callback del anfitrión es una pista, no un veredicto. Mantén tu propio libro de derechos con inicio y fin de periodo, anfitrión de origen y el cargo que lo generó; concílialo con el anfitrión en un calendario, no solo cuando llega un webhook. Haz idempotente cada cargo. Dale al periodo de gracia un dueño real en el código en vez de un número mágico en la interfaz, y asegúrate de que un fallo de renovación tenga una vía de aviso que no dependa de una plantilla que no controlas.

La prueba práctica es aburrida y merece la pena: revoca un mandato en una cuenta de prueba, corta el callback a mitad de camino y comprueba si el usuario sigue recibiendo aquello por lo que pagó. Si la respuesta depende de lo que el cliente pintó por última vez, todavía no tienes renovaciones: tienes un estado de carga con una etiqueta que dice «suscripción».

Fuentes