Guía de Suscripciones In-App con RevenueCat en Flutter

Monetizar una aplicación móvil mediante modelos de suscripción (SaaS móvil) es una de las vías más rentables para generar ingresos recurrentes (MRR). Sin embargo, programar desde cero la lógica de StoreKit 2 (iOS) y Google Play Billing (Android) gestionando renovaciones, periodos de prueba, cancelaciones y reembolsos puede llevar meses de desarrollo. RevenueCat es el estándar indiscutible de la industria para resolver este problema en cuestión de horas.

1. Por qué RevenueCat frente al Desarrollo Manual

Las APIs de facturación de Apple y Google cambian constantemente y gestionan eventos complejos: periodos de gracia tras fallo de tarjeta, promociones de retención, cambios de plan (upgrade/downgrade) y sincronización entre dispositivos. RevenueCat normaliza todas estas respuestas en una única API limpia y ofrece un panel de analíticas financieras en tiempo real (MRR, Churn, LTV, ARPU).

2. Conceptos Clave en RevenueCat

• Entitlements (Derechos de Acceso): El nivel de acceso o función premium que desbloquea el usuario (ej: premium_access).
• Offerings (Ofertas): El conjunto de planes que se muestran en el paywall actual (ej: Mensual, Anual con 30% de descuento).
• Packages (Paquetes): Cada opción de compra individual asociada al producto en App Store Connect y Google Play Console.

3. Implementación de Código en Flutter

Instalación del paquete oficial y flujo de compra con control de errores:

import 'package:purchases_flutter/purchases_flutter.dart';

class SubscriptionService {
  static Future init(String userId) async {
    await Purchases.setLogLevel(LogLevel.debug);
    
    PurchasesConfiguration configuration = PurchasesConfiguration('appl_tu_api_key_aqui')
      ..appUserID = userId;
      
    await Purchases.configure(configuration);
  }

  static Future purchasePremium(Package package) async {
    try {
      final customerInfo = await Purchases.purchasePackage(package);
      if (customerInfo.entitlements.all['premium_access']?.isActive ?? false) {
        return true; // Acceso premium concedido
      }
    } on PlatformException catch (e) {
      final errorCode = PurchasesErrorHelper.getErrorCode(e);
      if (errorCode != PurchasesErrorCode.purchaseCancelledError) {
        print('Error en la compra: ${e.message}');
      }
    }
    return false;
  }

  static Future checkPremiumStatus() async {
    final customerInfo = await Purchases.getCustomerInfo();
    return customerInfo.entitlements.all['premium_access']?.isActive ?? false;
  }
}

4. Sincronización con Backend mediante Webhooks

Para que tu servidor (Firebase o Supabase) conozca en todo momento el estado de la suscripción sin depender del cliente móvil, se configuran Webhooks seguros en RevenueCat. Cuando un usuario cancela su suscripción o renueva su cuota, RevenueCat envía un evento HTTP POST a tu backend para actualizar el campo is_premium en la base de datos automáticamente.

5. Buenas Prácticas en Paywalls de Alta Conversión

• Prueba gratuita destacada: Ofrecer 3 o 7 días de prueba gratuita multiplica la tasa de inicio de suscripciones hasta un 40%.
• Plan anual preseleccionado: Resaltar el plan anual con la etiqueta de «Mejor Valor» o «Ahorra un 40%» para incentivar el flujo de caja inmediato.
• Botón visible de Restaurar Compras: Obligatorio por normativa de Apple para evitar que tu app sea rechazada durante la revisión.

6. Preguntas Frecuentes sobre RevenueCat