Saltar al contenido

Crear iOS Auto-Renovable Suscripción

GitHub

Las suscripciones renovables automáticamente proporcionan acceso recurrente a contenido, servicios o características premium en tu aplicación de iOS. Esta guía te guía a través de la creación de suscripciones en App Store Connect.

Las suscripciones renovables automáticamente se renuevan al final de cada período de facturación hasta que los usuarios las cancelen. Son ideales para:

  • Contenido y características premium
  • Experiencias sin publicidad
  • Almacenamiento en la nube y sincronización
  • Servicios de transmisión
  • 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 del programa Apple Developer
  3. Completar la información bancaria y de impuestos en App Store Connect
  1. Navegar a Suscripciones

    En App Store Connect, selecciona tu aplicación y ve a Monetizar > Suscripciones.

    Selecciona tu grupo de suscripciones o crea uno nuevo si es necesario.

    Navegar a suscripciones

  2. Crear Nueva Suscripción

    Haga clic en + el icono al lado de su grupo de suscripciones para agregar una nueva suscripción.

  3. Ingrese Información Básica

    Nombre de Referencia: Nombre descriptivo para su uso interno (no se muestra a los clientes)

    • Ejemplos: “Mensual Premium”, “Anual Último”, “Plan Básico”

    ID del Producto: Identificador único para esta suscripción (no se puede cambiar más tarde)

    • Formato: com.yourcompany.yourapp.premium_monthly
    • : Utilice nombres descriptivos en minúsculas con guiones bajos
    • Requerido para configurar el plugin native-purchases

    Ingrese detalles de la suscripción

  4. Configurar Duración

    Seleccione la duración de la suscripción desde las opciones disponibles:

    • 1 semana
    • 1 mes
    • 2 meses
    • 3 meses
    • 6 meses
    • 1 año

    La duración determina con qué frecuencia se facturan a los usuarios.

  5. Configurar Precios

    Click Agregar Precio de Suscripción para configurar precios:

    Territorio Base: Selecciona tu mercado principal (usualmente tu país)

    Precio: Establece el precio de la suscripción

    • Apple convierte automáticamente a otras monedas
    • Elige entre los niveles de precios de Apple
    • Considera el valor percibido y las tasas de mercado

    Configurar precios

  6. Compartir Familia (Opcional)

    Decide si habilitar Compartir Familia, que permite a hasta 6 miembros de la familia acceder a la suscripción.

    Habilitar si:

    • El contenido es apropiado para uso familiar
    • Quieres aumentar la ventaja de propuesta de valor
    • Tu modelo de negocio lo apoya

    No habilitar si:

    • La suscripción es solo para uso individual
    • El contenido está personalizado para el usuario
    • Quieres maximizar la rentabilidad por usuario
  7. Agregar Localizaciones

    Agregar información de visualización de suscripción en todos los idiomas que soporta tu aplicación:

    Nombre de visualización de suscripción: Nombre para la cara del cliente (por ejemplo, “Premium Mensual”)

    Descripción: Breve descripción de qué incluye la suscripción

    • Manténlo conciso y enfocado en beneficios
    • Menciona características clave
    • Destaca la propuesta de valor

    Agregar localizaciones

  8. Imagen de promoción de la Tienda de Aplicaciones (Opcional)

    Sube una imagen de promoción para esta suscripción (312x390 píxeles):

    • Se muestra en la página de suscripción de la Tienda de Aplicaciones
    • Coincidir con el diseño de tu aplicación
    • Incluir el nombre de la suscripción para mayor claridad
  9. Guardar y Presentar

    Hacer clic Guardar para crear la suscripción.

    Para la Primera Suscripción:

    • Debes presentarla con una nueva versión de la aplicación
    • Incluir en tu próxima presentación de la Tienda de Mac App
    • No se puede enviar de forma independiente

    Para suscripciones posteriores:

    • Puede enviarse directamente desde la página de suscripciones
    • No requieren una nueva versión de la aplicación
    • Disponible después de que se apruebe la primera suscripción

Su suscripción tendrá uno de estos estados:

EstadoDescripciónPuede Probar?
Datos de Metadatos FaltantesConfiguración incompletaSí (entorno de pruebas)
Listo para enviarCompleto pero no enviadoSí (entorno de pruebas)
Esperando revisiónEnviado a AppleSí (entorno de pruebas)
En revisiónEn revisión por parte de AppleSí (entorno de pruebas)
AprobadoDisponible para la compra
RechazadoCon cambios necesariosSí (entorno de pruebas)

Una vez creada, referencia la suscripción en tu aplicación utilizando el ID del producto:

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}`);
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 su suscripción a 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. Utilice esos términos para mostrar el cargo mensual, el precio total del compromiso y el período de compromiso completo 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 la paywall y la concesión de derechos, consulte Planes de facturación mensuales de compromiso de iOS.

  • Planes mensuales: Barrera de entrada más baja, construye hábito
  • Planes anuales: Mejor valor, mayor LTV, menor rotación
  • Niveles múltiples: Básico, Premium, Ultimate para diferentes segmentos de usuarios
  • Análisis competitivo: Investigar el precio de aplicaciones similares
  • Usar nombres consistentes: company.app.tier_duration
  • Incluir nivel y duración en el ID: premium_monthly, ultimate_annual
  • Evitar cambiar IDs de producto (son permanentes)
  • Documentar todas las IDs de producto para tu equipo
  • Habilitar para aplicaciones orientadas a la familia (juegos, educativos, entretenimiento)
  • Considerar el impacto en la recaudación de ingresos
  • Probar el comportamiento de compartición exhaustivamente
  • Comunicar la capacidad de compartir en la publicidad
  • Traducir todos los nombres y descripciones de suscripción
  • Considerar las diferencias de precios regionales
  • Probar la visualización en todos los idiomas soportados
  • Usar un lenguaje de marketing apropiado culturalmente
  • Mantener un estilo visual consistente
  • Incluir el nombre de la suscripción y el beneficio principal
  • Actualizar para promociones estacionales
  • Coincidir con el lenguaje de diseño de la aplicación
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)

No se está cargando la suscripción en la aplicación:

  • Verificar que el ID del producto coincida exactamente (sensible a mayúsculas y minúsculas)
  • Comprobar que la suscripción esté en el grupo de suscripciones
  • Asegurarse de que el identificador de paquete coincida con App Store Connect
  • Esperar 2-3 horas después de crear el producto

No se puede enviar la suscripción:

  • Complete todos los campos obligatorios (nombre, descripción, precio)
  • Agregar al menos una localización
  • Verificar que la información bancaria/tax sea aprobada
  • Verificar si la primera suscripción (requiere versión de la aplicación)

El botón de Family Sharing está deshabilitado:

  • Ya está habilitado (no se puede deshabilitar)
  • Verificar en detalles de la suscripción
  • Contactar con el soporte de Apple si se queda atascado

Nivel de precio no disponible:

  • Puede estar restringido en algunas regiones
  • Elige un nivel alternativo
  • Contacte a Apple para preguntas de precios

Error de producto inválido:

  • Deben ser en formato de dominio inverso
  • No puede contener espacios ni caracteres especiales
  • Verifique ortografía
  • Verifique la unicidad en todos los productos

Para obtener más detalles, consulte la documentación oficial de Apple sobre suscripciones renovables automáticas.

Sigue adelante desde Crear suscripción iOS renovable automáticamente

Sección titulada “Sigue adelante desde Crear suscripción iOS renovable automáticamente”

Si estás utilizando Crear suscripción iOS renovable automáticamente para planificar la aprobación y distribución de la tienda, conecte con Usando @capgo/native-purchases para la capacidad nativa en Usando @capgo/native-purchases, @capgo/capacitor-revisión-en-aplicación para el detalle de implementación en @capgo/capacitor-revisión-en-aplicación, Usando @capgo/capacitor-revisión-en-aplicación para la capacidad nativa en Usando @capgo/capacitor-revisión-en-aplicación, @capgo/capacitor-mercado-nativo para el detalle de implementación en @capgo/capacitor-mercado-nativo, y Usando @capgo/capacitor-mercado-nativo para la capacidad nativa en Usando @capgo/capacitor-mercado-nativo.