Crear suscripción autorrenovable en iOS
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 proporcionan acceso recurrente a contenido, servicios o funciones premium en tu app de iOS. Esta guía te explica cómo crear suscripciones en App Store Connect.
Las suscripciones de renovación automática se renuevan al final de cada período de facturación hasta que el usuario las cancele. Son perfectas para:
- Contenido y funciones premium
- Experiencias sin anuncios
- Almacenamiento en la nube y sincronización
- Servicios de streaming
- Herramientas y utilidades profesionales
Requisitos
Sección titulada “Prerrequisitos”Antes de crear suscripciones, debes:
- Crear un grupo de suscripciones para organizar tus suscripciones
- Tener una membresía activa en el Apple Developer Program
- Completar la información bancaria y fiscal en App Store Connect
Crear una suscripción
Sección titulada “Creación de una suscripción”-
Ve a Suscripciones
En App Store Connect, selecciona tu app y ve a Monetizar > Suscripciones.
Selecciona tu grupo de suscripciones o crea uno nuevo si es necesario.

-
Crear nueva suscripción
Haz clic en + icono junto a tu grupo de suscripciones para añadir una nueva suscripción.
-
Introduce la información básica
Nombre de referencia: Nombre descriptivo para uso interno (no lo ven los clientes)
- Ejemplos: “Premium Monthly”, “Ultimate Annual”, “Basic Plan”
ID del producto: Identificador único para esta suscripción (no se puede cambiar después)
- Formato:
com.yourcompany.yourapp.premium_monthly - Usa nombres descriptivos en minúsculas con guiones bajos
- Requerido para configurar el plugin native-purchases

-
Configurar duración
Selecciona la duración de la suscripción entre las opciones disponibles:
- 1 semana
- 1 mes
- 2 meses
- 3 meses
- 6 meses
- 1 año
La duración determina cada cuánto se factura a los usuarios.
-
Configurar precios
Haz clic Añadir precio de suscripción para configurar los precios:
Territorio base: Selecciona tu mercado principal (normalmente tu país)
Precio: Establece el precio de la suscripción
- Apple convierte automáticamente a otras divisas
- Elige entre los niveles de precios de Apple
- Ten en cuenta el valor percibido y los precios del mercado

-
Family Sharing (opcional)
Decide si habilitar Family Sharing, que permite que hasta 6 miembros de la familia accedan a la suscripción.
Actívalo si:
- El contenido es apto para uso familiar
- Quieres aumentar tu propuesta de valor
- Tu modelo de negocio lo permite
No lo actives si:
- La suscripción es solo para uso individual
- El contenido está personalizado para el usuario
- Quieres maximizar los ingresos por usuario
-
Añadir localizaciones
Añade la información de suscripción en todos los idiomas que admita tu app:
Nombre para mostrar: Nombre para el cliente (ej. “Premium Mensual”)
Descripción: Breve descripción de lo que incluye la suscripción
- Sé conciso y enfócate en los beneficios
- Menciona las funciones clave
- Resalta la propuesta de valor

-
Imagen promocional de la App Store (opcional)
Sube una imagen promocional para esta suscripción (312x390 píxeles):
- Aparece en la página de suscripciones de App Store
- Debe coincidir con el diseño de tu app
- Incluye el nombre de la suscripción para aclarar
-
Guardar y enviar
Haz clic Guardar para crear la suscripción.
Para la primera suscripción:
- Debe enviarse con una nueva versión de la app
- Inclúyelo en tu próximo envío a la App Store
- No se puede enviar por separado
Para suscripciones posteriores:
- Se pueden enviar directamente desde la página de Suscripciones
- No requieren una nueva versión de la app
- Disponibles tras la aprobación de la primera suscripción
Estado de la suscripción
Sección titulada “Estado de la suscripción”Tu suscripción tendrá uno de estos estados:
| Estado | Descripción | ¿Se puede probar? |
|---|---|---|
| Metadatos faltantes | Configuración incompleta | Sí (sandbox) |
| Listo para enviar | Completado pero no enviado | Sí (sandbox) |
| Esperando revisión | Enviado a Apple | Sí (sandbox) |
| En revisión | En revisión por Apple | Sí (sandbox) |
| Aprobado | Disponible para compra | Sí |
| Rechazado | Requiere cambios | Sí (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';
// Fetch subscription products direct from StoreKitconst { products } = await NativePurchases.getProducts({ productIdentifiers: [ 'com.yourcompany.yourapp.premium_monthly', 'com.yourcompany.yourapp.premium_annual', ], productType: PURCHASE_TYPE.SUBS,});
products.forEach((product) => { console.log(`${product.title}: ${product.priceString}`); console.log(`Duration: ${product.subscriptionPeriod?.unitString ?? 'unknown'}`); console.log(`Description: ${product.description}`);});
// Purchase a subscription (StoreKit 2 automatically handles intro pricing and offers)try { const transaction = await NativePurchases.purchaseProduct({ productIdentifier: 'com.yourcompany.yourapp.premium_monthly', productType: PURCHASE_TYPE.SUBS, });
console.log('Transaction ID:', transaction.transactionId);
// StoreKit receipts are included on iOS for server-side validation await sendReceiptToBackend(transaction.receipt);} catch (error) { console.error('Purchase failed:', error);}
// Check subscription status using the store's dataconst { purchases } = await NativePurchases.getPurchases({ productType: PURCHASE_TYPE.SUBS,});
const premium = purchases.find( (purchase) => purchase.productIdentifier === 'com.yourcompany.yourapp.premium_monthly',);
if (premium?.isActive) { console.log('Expires:', premium.expirationDate); console.log('Will renew:', premium.willCancel === false); console.log('Store state:', premium.subscriptionState); unlockPremiumFeatures();} else { showPaywall();}Planes mensuales con compromiso de 12 meses
Sección titulada “Planes mensuales con compromiso de 12 meses”Si tu suscripción de App Store Connect está configurada con un plan de facturación mensual y un compromiso de 12 meses, StoreKit puede devolver términos de precios adicionales para ese producto. Usa esos términos para mostrar el cargo mensual, el precio total del compromiso y el periodo completo del compromiso antes de la compra.
const yearlyProduct = products.find( (product) => product.identifier === 'com.yourcompany.yourapp.premium_annual',);
const monthlyCommitment = yearlyProduct?.pricingTerms?.find( (term) => term.billingPlanType === 'monthly',);
if (yearlyProduct && monthlyCommitment) { console.log('Monthly charge:', monthlyCommitment.billingDisplayPrice); console.log('Total commitment:', monthlyCommitment.commitmentInfo?.priceString);
await NativePurchases.purchaseProduct({ productIdentifier: yearlyProduct.identifier, productType: PURCHASE_TYPE.SUBS, billingPlanType: 'monthly', });}Para el flujo completo de paywall y entitlements, consulta Planes de facturación mensual con compromiso en iOS.
Buenas prácticas
Sección titulada “Buenas prácticas”Estrategia de precios
Sección titulada “Estrategia de precios”- Planes mensuales: Menor barrera de entrada, fomenta el hábito
- Planes anuales: Mejor valor, mayor LTV, menor churn
- Varios niveles: Básico, Premium, Ultimate para distintos segmentos de usuarios
- Análisis competitivo: Investiga los precios de apps similares
IDs de producto
Sección titulada “Product IDs”- Usa una nomenclatura coherente:
company.app.tier_duration - Incluye el nivel y la duración en el ID:
premium_monthly,ultimate_annual - Evita cambiar los product IDs (son permanentes)
- Documenta todos los product IDs para tu equipo
Compartir en familia
Sección titulada “Family Sharing”- Actívalo en apps familiares (juegos, educación, ocio)
- Evalúa el impacto en los ingresos
- Prueba a fondo cómo funciona el uso compartido
- Comunica la opción de compartir en tu marketing
Localización
Sección titulada “Localización”- Traduce todos los nombres y descripciones de suscripciones
- Considera las diferencias de precios regionales
- Prueba la visualización en todos los idiomas compatibles
- Usa un lenguaje de marketing culturalmente adecuado
Imágenes promocionales
Sección titulada “Imágenes promocionales”- Mantén un estilo visual coherente
- Incluye el nombre y beneficio clave de la suscripción
- Actualiza para promociones estacionales
- Sigue el lenguaje de diseño de la app
Patrones de suscripción comunes
Sección titulada “Patrones de suscripción comunes”Nivel único (freemium)
Sección titulada “Nivel único (Freemium)”Free App + Premium Subscription- Basic: Free (limited features)- Premium Monthly: $4.99- Premium Annual: $39.99 (save 33%)Multinivel (bueno, mejor, excelente)
Sección titulada “Multinivel (Básico, Pro, Premium)”- Basic Monthly: $4.99- Premium Monthly: $9.99- Ultimate Monthly: $19.99
- Basic Annual: $49.99- Premium Annual: $99.99- Ultimate Annual: $199.99Híbrido consumible + suscripción
Sección titulada “Híbrido de consumible + suscripción”- Credit packs (consumable)- Monthly subscription (unlimited credits)- Annual subscription (unlimited + bonus features)Solución de problemas
Sección titulada “Solución de problemas”La suscripción no se carga en la app:
- Verify product ID matches exactly (case-sensitive)
- Comprueba que la suscripción está en un grupo de suscripciones
- Asegura que el bundle identifier coincida con App Store Connect
- Espera 2-3 horas tras crear el producto
No se puede enviar la suscripción:
- Completa todos los campos obligatorios (nombre, descripción, precio)
- Añade al menos una localización
- Verify banking/tax info is approved
- Verifica la primera suscripción (requiere versión de la app)
Interruptor de Family Sharing desactivado:
- Ya está activado (no se puede desactivar)
- Compruébalo en los detalles de la suscripción
- Contacta con el Soporte de Apple si tienes problemas
Nivel de precio no disponible:
- Puede estar restringido en algunos territorios
- Elige un nivel alternativo
- Contacta con Apple para dudas sobre precios
Error “Invalid Product ID”:
- Debe estar en formato de dominio inverso
- No puede contener espacios ni caracteres especiales
- Revisa errores tipográficos
- Verifica la unicidad en todos los productos
Próximos pasos
Sección titulada “Próximos pasos”- Crea una oferta de introducción para atraer nuevos suscriptores
- Vende planes de facturación de compromiso mensual para ofertas de suscripción anual compatibles
- Configura las pruebas en sandbox para probar tus suscripciones
- Configura ofertas promocionales para reactivación y retención
- Implementa el seguimiento de analíticas de suscripción
Recursos adicionales
Sección titulada “Recursos adicionales”Para más detalles, consulta la documentación oficial de Apple sobre suscripciones renovables automáticamente.
Continúa desde Crear suscripción autorrenovable en iOS
Sección titulada “Continuar desde Create iOS Auto-Renewable Subscription”Si estás usando Crear suscripción autorrenovable en iOS 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.»