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 renovables automáticamente ofrecen acceso recurrente a contenido, servicios o funciones premium en tu app de iOS. Esta guía te enseña a crear suscripciones en App Store Connect.
Las suscripciones renovables automáticamente se renuevan al final de cada periodo de facturación hasta que el usuario las cancele. Son ideales para:
- Contenido y funciones premium
- Experiencias sin anuncios
- Almacenamiento y sincronización en la nube
- Servicios de streaming
- Herramientas y utilidades profesionales
Requisitos
Sección titulada “Prerrequisitos”Antes de crear las suscripciones, debes:
- Crea un grupo de suscripciones para organizar tus suscripciones
- Ten una membresía activa de Apple Developer Program
- Completa la información fiscal y bancaria en App Store Connect
Crear una suscripción
Sección titulada “Creating a Subscription”-
Ve a Subscriptions
En App Store Connect, selecciona tu app y ve a Monetización > 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.
-
Introduce la información básica
Nombre de referencia: Nombre descriptivo para uso interno (no se muestra al cliente)
- 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 realiza la conversión a otras divisas automáticamente
- Elige entre los niveles de precios de Apple
- Ten en cuenta el valor percibido y las tasas del mercado

-
Family Sharing (Opcional)
Decide si habilitar Family Sharing, que permite hasta 6 miembros de la familia acceder a la suscripción.
Actívalo si:
- El contenido es apto para uso familiar
- Quieres mejorar 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 la suscripción en todos los idiomas que admita tu app:
Nombre de la suscripción: 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 beneficios
- Menciona las funciones clave
- Resalta la propuesta de valor

-
Imagen promocional de App Store (Opcional)
Sube una imagen promocional para esta suscripción (312x390 píxeles):
- Se muestra 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 desde la página de Suscripciones
- No requieren una nueva versión de la app
- Disponible tras aprobar la primera suscripción
Estado de la suscripción
Sección titulada “Subscription Status”Tu suscripción tendrá uno de estos estados:
| Estado | Descripción | ¿Se puede probar? |
|---|---|---|
| Falta metadatos | 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}`); 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 de permanencia 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 “Mejores prácticas”Estrategia de precios
Sección titulada “Estrategia de precios”- Planes mensuales: Menor barrera de entrada, crea hábito
- Planes anuales: Mejor valor, mayor LTV y menor churn
- Múltiples niveles: Basic, Premium y Ultimate para distintos segmentos
- Análisis competitivo: Investiga los precios de apps similares
IDs de producto
Sección titulada “Product IDs”- Usa una nomenclatura consistente:
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: “Family Sharing”- Actívalo en apps familiares (juegos, educación, ocio)
- Evalúa el impacto en los ingresos
- Testea a fondo el comportamiento de uso compartido
- Comunica la opción de compartir en tu marketing
Localización
Sección: “Localization”- Traduce nombres y descripciones de suscripciones
- Ten en cuenta las diferencias de precios regionales
- Testea la visualización en todos los idiomas soportados
- 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: “Híbrido de Consumibles + Suscripciones”- 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 carga en la app:
- Verifica que el ID del producto sea exacto (distingue mayúsculas)
- Verifica que la suscripción esté en el grupo de suscripción
- Asegúrate de 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
- Verifica que la info bancaria/fiscal esté aprobada
- 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 si hay errores tipográficos
- Verifica que sean únicos en todos los productos
Próximos pasos
Sección titulada “Próximos pasos”- Crea una oferta de introducción para atraer nuevos suscriptores
- Planes de facturación con compromiso mensual para ofertas de suscripción anual soportadas
- Configura las pruebas en sandbox para probar tus suscripciones
- Configura ofertas promocionales para retención y win-back
- 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.»