Crear una suscripción auto-renovable en Android
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
Las suscripciones de renovación automática permiten acceder a contenido, servicios o funciones premium de tu app de forma continua. Esta guía te ayudará a crear y configurar suscripciones en Google Play Console.
Las suscripciones se renuevan automáticamente al final de cada período 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
Sección titulada “Crear una suscripción”-
Ve a Suscripciones
En Google Play Console, selecciona tu app y elige Monetizar > Suscripciones del menú izquierdo.
Haz clic en Crear suscripción para comenzar.

-
Introduce la información básica
Indica un nombre de suscripción y un ID de producto. El ID de producto es obligatorio para la configuración en tu app y no se puede cambiar después.

-
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.

-
Configurar detalles del plan base
Introduce:
- ID del plan base: Identificador único para este plan
- Periodo 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

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

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

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

-
Guardar configuración
Guarda tu configuración de precios.

-
Activar suscripción
Haz clic en Activar botón para activar tu producto de suscripción y ponerlo a la venta.

Consideraciones importantes
Sección titulada “Consideraciones importantes”Limitación del plan base
Sección titulada “Limitación del plan base”El plugin native-purchases requiere exactamente un plan base por suscripción para garantizar la coherencia con el manejo de suscripciones en iOS. No se admiten múltiples planes base.
Periodo de gracia
Sección titulada “Período de gracia”El período de gracia permite a Google Play reintentar pagos fallidos manteniendo el acceso del usuario a la suscripción. Los períodos de gracia habituales son:
- 3 días para suscripciones mensuales
- 7 días para suscripciones de mayor duración
Estado de la suscripción
Sección titulada “Estado de la suscripción”Tras la creación, tu suscripción estará en estado “Borrador” hasta que se active. Puedes probar suscripciones en borrador en modo sandbox.
Uso en tu app
Sección titulada “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 infoconst { 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 stateconst { 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
Sección titulada “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
Sección titulada “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 nombre de paquete correcto
- Espera 2-3 horas tras la activación para que los cambios se propaguen
Errores del plan base:
- Asegúrate de tener exactamente un plan base
- Verify all required fields are filled
- Comprueba 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
- Comprueba que las tasas de conversión de divisas sean aceptables
Continuar desde Create Android Auto-Renewable Subscription
Sección titulada «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.»