Crear Suscripción Renovable Automática en Android

Las suscripciones renovables automáticas proporcionan acceso a contenido, servicios o funciones premium en tu aplicación de manera continua. Esta guía te ayudará a crear y configurar suscripciones en Google Play Console.

Descripción General

Las suscripciones se renuevan automáticamente al final de cada período de facturación hasta que el usuario cancela. Son ideales para:

• Acceso a contenido premium
• Experiencias sin anuncios
• Almacenamiento en la nube
• Servicios continuos

Crear una Suscripción

1. Navegar a Suscripciones

   En Google Play Console, selecciona tu app y elige Monetizar > Suscripciones del menú izquierdo.

   Haz clic en el botón Crear suscripción para comenzar.

   

2. Ingresar Información Básica

   Proporciona un nombre de suscripción e ID de producto. El ID de producto es necesario para la configuración en tu app y no se puede cambiar después.

   

3. Crear Plan Base

   Google Play requiere exactamente un plan base por suscripción. El plugin native-purchases soporta solo un plan base para mantener compatibilidad con iOS.

   Haz clic en Agregar plan base para continuar.

   

4. Configurar Detalles del Plan Base

   Ingresa:

   • ID del plan base: Identificador único para este plan
   • Período de facturación: Con qué frecuencia se cobra a los usuarios (semanal, mensual, anual, etc.)
   • Período de gracia: Ventana de tiempo durante la cual Google mantiene la suscripción mientras reintenta el pago antes de la cancelación

   

5. Configurar Precios

   Accede a la sección de precios y selecciona todos los países/regiones donde quieras ofrecer la suscripción.

   

6. Configurar Precio

   Establece tu precio base en tu moneda principal. Google Play convierte automáticamente esto a monedas locales.

   

7. Revisar Precios Regionales

   Revisa los precios convertidos automáticamente para cada país. Puedes ajustar precios individuales si es necesario.

   

8. Guardar Configuración

   Guarda tu configuración de precios.

   

9. Activar Suscripción

   Haz clic en el botón Activar para hacer que tu producto de suscripción esté disponible para compra.

   

Consideraciones Importantes

Limitación del Plan Base

El plugin native-purchases requiere exactamente un plan base por suscripción para asegurar consistencia con el manejo de suscripciones de iOS. No se soportan múltiples planes base.

Período de Gracia

El período de gracia permite a Google Play reintentar pagos fallidos mientras mantiene el acceso a la suscripción del usuario. Los períodos de gracia comunes son:

• 3 días para suscripciones mensuales
• 7 días para suscripciones más largas

Estado de Suscripción

Después de la creación, tu suscripción estará en estado “Borrador” hasta que sea activada. Puedes probar suscripciones en borrador en modo sandbox.

Usar en tu App

Una vez creada, referencia la suscripción en tu app usando el ID de producto:

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

// Cargar información de suscripción
const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['com.example.premium.monthly'],
  productType: PURCHASE_TYPE.SUBS,
});

const product = products[0];
console.log(`${product.title} — ${product.priceString}`);

// Comprar (planIdentifier = ID del Plan Base de Google Play Console)
const transaction = await NativePurchases.purchaseProduct({
  productIdentifier: 'com.example.premium.monthly',
  planIdentifier: 'monthly-plan', // REQUERIDO en Android, ignorado en iOS
  productType: PURCHASE_TYPE.SUBS,
});

console.log('ID de Transacción', transaction.transactionId);

// Más tarde, verificar estado de compra
const { purchases } = await NativePurchases.getPurchases({
  productType: PURCHASE_TYPE.SUBS,
});

const subscription = purchases.find(
  (purchase) => purchase.productIdentifier === 'com.example.premium.monthly',
);

if (subscription && subscription.purchaseState === 'PURCHASED' && subscription.isAcknowledged) {
  console.log('Suscripción activa localmente');
  // Para expiración/cancelación, valida purchaseToken a través de tu backend
}

Próximos Pasos

• Crear una oferta introductoria para atraer nuevos suscriptores
• Configurar pruebas en sandbox para probar tus suscripciones
• Configurar validación de recibos en el backend para seguridad

Solución de Problemas

La suscripción no aparece en la app:

• Verifica que el ID de producto coincida exactamente
• Asegúrate de que la suscripción esté activada
• Verifica que tu app tenga el nombre de paquete correcto
• Espera 2-3 horas después de la activación para que los cambios se propaguen

Errores del plan base:

• Asegúrate de tener exactamente un plan base
• Verifica que todos los campos requeridos estén completados
• Verifica que el período de facturación sea válido

Problemas de precios:

• Confirma que al menos un país esté seleccionado
• Verifica que el precio base sea mayor que el mínimo permitido
• Verifica que las tasas de conversión de moneda sean aceptables