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.
| Fase | Quién tiene el estado | Qué cambian las reglas del anfitrión | El accidente típico |
|---|---|---|---|
| Autorización de adeudo | El riel de pagos del anfitrión | Los mandatos caducan, los permisos cambian, reautorizar es un flujo del anfitrión | Marcas «renovada» en local y el dinero nunca se movió |
| Intento de cobro | Tu servidor, como tarea idempotente | Los tiempos de callback y las ventanas de reintento difieren | Un webhook reiterado sin clave de idempotencia cobra dos veces |
| Periodo de gracia | Tu libro de derechos | El anfitrión puede cortar el acceso antes de que acabe tu gracia | Usuario bloqueado mientras la interfaz dice activa |
| Aviso de fallo | El canal de mensajes del anfitrión | IDs de plantilla, horarios silenciosos, bajas | El aviso nunca llega y la baja parece un bug aleatorio |
| Sincronización de derechos | Tu servidor, conciliado entre anfitriones | La misma persona, distinto ID de cuenta en cada super app | Paga en uno y se queda fuera en el otro |
| Reembolso | Anfitrión más tu libro | Ventanas de reembolso, reglas de periodo parcial | Acceso 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
- Google Play — Facturación — cómo un riel de pagos propio del anfitrión gestiona suscripciones, renovaciones y periodos de gracia.
- Apple — Documentación de StoreKit — el modelo de referencia para suscripciones autorrenovables y estado en servidor.
- Stripe — Documentación de Billing — patrones de idempotencia, reintentos y conciliación que conviene copiar aunque no uses Stripe.
- FTC — Guías para empresas — por qué la información de renovación automática y la cancelación son cuestión de cumplimiento, no solo de UX.
- WeChat — Documentación abierta — donde viven realmente la autorización de cobro y las reglas de mensajes de plantilla.