Crear una suscripción auto-renovable en Android

Las suscripciones renovables automáticamente dan acceso continuo a contenido, servicios o funciones premium en tu app. Esta guía te ayudará a crear y configurar suscripciones en Google Play Console.

Resumen

Las suscripciones se renuevan automáticamente al final de cada periodo de facturación hasta que el usuario las cancele. Son ideales para:

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

Crear una suscripción

1. Ve a Suscripciones

   En Google Play Console, selecciona tu app y elige Monetizar > Suscripciones en el menú de la izquierda.

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

   

2. Introduce la información básica

   Proporciona un nombre y un ID de producto. El ID de producto es necesario para la configuración de 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 solo admite un plan base para mantener la compatibilidad con iOS.

   Haz clic Añadir plan base para continuar.

   

4. Configurar detalles del plan base

   Introduce:

   • ID del plan base: Identificador único para este plan
   • Periodo de facturación: Frecuencia de cobro a los usuarios (semanal, mensual, anual, etc.)
   • Periodo de gracia: Ventana de tiempo en la que Google mantiene la suscripción mientras reintenta el pago antes de cancelarla

   

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 lo convierte automáticamente 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 Activar botón para activar tu producto de suscripción y ponerlo a la venta.

   

Consideraciones importantes

Limitación del plan base

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

Periodo de gracia

El periodo de gracia permite que Google Play reintente los pagos fallidos manteniendo el acceso del usuario a la suscripción. Los periodos de gracia comunes son:

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

Estado de la suscripción

Tras la creación, tu suscripción estará en estado “Draft” hasta que se active. Puedes probar las suscripciones en draft en modo sandbox.

Uso en tu app

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

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

// Load subscription info
const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['com.example.premium.monthly'],
  productType: PURCHASE_TYPE.SUBS,
});

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

// Purchase (planIdentifier = Base Plan ID from Google Play Console)
const transaction = await NativePurchases.purchaseProduct({
  productIdentifier: 'com.example.premium.monthly',
  planIdentifier: 'monthly-plan', // REQUIRED on Android, ignored on iOS
  productType: PURCHASE_TYPE.SUBS,
});

console.log('Transaction ID', transaction.transactionId);

// Later, check purchase state
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('Subscription active locally');
  // For expiration/cancellation, validate purchaseToken through your backend
}

Próximos pasos

• Crea una oferta de introducción para atraer nuevos suscriptores
• Configura las pruebas en sandbox para probar tus suscripciones
• Configura la validación de recibos en el backend para mayor seguridad

Solución de problemas

La suscripción no aparece en la app:

• Verifica que el ID del producto coincida exactamente
• Asegúrate de que la suscripción esté activada
• Comprueba que tu app tenga el package name correcto
• Espera 2-3 horas tras la activación para que los cambios se propaguen

Errores en el base plan:

• Asegúrate de tener exactamente un base plan
• Verify all required fields are filled
• Comprueba que el periodo 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 al mínimo permitido
• Verifica que los tipos de cambio sean aceptables

Continuar desde Create Android Auto-Renewable Subscription

Si estás usando Crear una suscripción auto-renovable en Android para planificar la aprobación y distribución en la tienda, conéctalo con Uso de @capgo/native-purchases para la capacidad nativa al usar @capgo/native-purchases, @capgo/capacitor-in-app-review para el detalle de implementación en @capgo/capacitor-in-app-review, Usando @capgo/capacitor-in-app-review para la capacidad nativa en «Usando @capgo/capacitor-in-app-review», @capgo/capacitor-native-market para el detalle de implementación en @capgo/capacitor-native-market, y Usando @capgo/capacitor-native-market para la capacidad nativa en «Usando @capgo/capacitor-native-market.»