Saltar al contenido

Crear Suscripción Auto-Renovable de iOS

GitHub

Las suscripciones renovables automáticamente proporcionan acceso recurrente a contenido, servicios o características premium en tu aplicación 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 cancelen. Son ideales para:

  • Contenido y características 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 del programa de desarrolladores de Apple
  3. Completar la información bancaria y fiscal 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.

    Navegue a las suscripciones

  2. Crear nueva suscripción

    Haga clic en el + ícono junto a 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 Ultimate”, “Plan Básico”

    ID de 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 de compras nativas

    Ingrese detalles de la suscripción

  4. Configurar Duración

    Seleccione la duración de la suscripción de 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

    Haz clic Agregar precio de suscripción para configurar los 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
    • Elegir de las escalas de precios de Apple
    • Considerar el valor percibido y las tasas del mercado

    Configurar precios

  6. Compartir familia (opcional)

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

    Habilitar si:

    • El contenido es apropiado para uso familiar
    • Quieres aumentar la 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 la Suscripción: Nombre de la suscripción para el usuario (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 Promocional de la Tienda de Aplicaciones (Opcional)

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

    • Muestra en la página de suscripción de la Tienda de Aplicaciones
    • Debe coincidir con el diseño de tu aplicación
    • Incluir el nombre de la suscripción para mayor claridad
  9. Guardar y Enviar

    Hacer clic Guardar Crear la suscripción.

    Para la Primera Suscripción:

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

    Para suscripciones posteriores:

    • Se puede presentar directamente desde la página de Suscripciones
    • No requiere una nueva versión de la aplicación
    • Disponible después de que se apruebe la primera suscripción

Tu suscripción tendrá uno de estos estados:

EstadoDescripciónPuedes Probar?
Datos 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ónEstá siendo revisado por AppleSí (entorno de pruebas)
AprobadoDisponible para la compra
RechazadoRequiere cambiosSí (entorno de pruebas)

Una vez creado, 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 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. 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 la fluidez completa de la pared de pago y la autorización, consulte Planes de facturación mensuales de compromiso de iOS.

Prácticas recomendadas

Estrategia de precios

Sección titulada “Estrategia de precios”

Planes mensuales
  • Planes mensuales: Barrera de entrada más baja, fomenta la costumbre
  • Planes anuales: Mejor valor, mayor LTV, menor rotación
  • Niveles múltiples: Básico, Premium, Ultimate para diferentes segmentos de usuarios
  • Análisis competitivo: Investiga el precio de aplicaciones similares
  • Utiliza nombres consistentes: company.app.tier_duration
  • Incluye el nivel y la duración en el ID: premium_monthly, ultimate_annual
  • Evita cambiar los IDs de producto (son permanentes)
  • Registrar todos los IDs de producto para su equipo
  • Habilitar para aplicaciones orientadas a la familia (juegos, educativos, entretenimiento)
  • Considerar el impacto en los ingresos
  • Probar el comportamiento de la 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
  • Utilice un lenguaje de marketing apropiado para la cultura
  • Mantenga un estilo visual consistente
  • Incluya el nombre de la suscripción y el beneficio clave
  • Actualice 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)

La suscripción no se carga 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
  • Espera 2-3 horas después de crear el producto

No se puede enviar la suscripción:

  • Completa todos los campos obligatorios (nombre, descripción, precio)
  • Agrega al menos una localización
  • Verifica que la información bancaria/tax haya sido aprobada
  • Verifica 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)
  • Verifica en los detalles de la suscripción
  • Contacta con el soporte de Apple si se queda atascado

Nivel de precio no disponible:

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

Error de producto inválido:

  • Deben ser en formato de dominio inverso
  • No debe contener espacios ni caracteres especiales
  • Revisa por errores de ortografía
  • Verifica 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 Auto-Renovable para planificar la aprobación y distribución de la tienda, conecte con Usando @capgo/compras-nativas para la capacidad nativa en Usando @capgo/compras-nativas, @capgo/capacitor-in-app-review for the implementation detail in @capgo/capacitor-in-app-review, Using @capgo/capacitor-in-app-review for the native capability in Using @capgo/capacitor-in-app-review, @capgo/capacitor-native-market for the implementation detail in @capgo/capacitor-native-market, and Using @capgo/capacitor-native-market for the native capability in Using @capgo/capacitor-native-market.