Saltar al contenido

Crear suscripción autorrenovable en iOS

GitHub

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

Antes de crear suscripciones, debes:

  1. Crear un grupo de suscripciones para organizar tus suscripciones
  2. Tener una membresía activa en el Apple Developer Program
  3. Completar la información bancaria y fiscal en App Store Connect
  1. 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.

    Ve a suscripciones

  2. Crear nueva suscripción

    Haz clic en + icono junto a tu grupo de suscripciones para añadir una nueva suscripción.

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

    Introduce los detalles de la suscripción

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

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

    Configurar precios

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

    Añade localizaciones

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

Tu suscripción tendrá uno de estos estados:

EstadoDescripción¿Se puede probar?
Metadatos faltantesConfiguración incompletaSí (sandbox)
Listo para enviarCompletado pero no enviadoSí (sandbox)
Esperando revisiónEnviado a AppleSí (sandbox)
En revisiónEn revisión por AppleSí (sandbox)
AprobadoDisponible para compraSí
RechazadoRequiere cambiosSí (sandbox)

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 StoreKit
const { 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 data
const { 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();
}

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.

  • 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
  • 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
  • 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
  • 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
  • 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
Free App + Premium Subscription
- Basic: Free (limited features)
- Premium Monthly: $4.99
- Premium Annual: $39.99 (save 33%)
- Basic Monthly: $4.99
- Premium Monthly: $9.99
- Ultimate Monthly: $19.99
- Basic Annual: $49.99
- Premium Annual: $99.99
- Ultimate Annual: $199.99
- Credit packs (consumable)
- Monthly subscription (unlimited credits)
- Annual subscription (unlimited + bonus features)

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

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