Crear una suscripción automática renovable de iOS

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.

Resumen

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 de pago
• Experiencias sin publicidad
• Almacenamiento en la nube y sincronización
• Servicios de transmisión
• Herramientas y utilidades profesionales

Requisitos previos

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. Complete información bancaria y tributaria en App Store Connect

Crear una suscripción

1. Navegar a Suscripciones

   En App Store Connect, seleccione su aplicación y vaya a Monetizar > Suscripciones.

   Seleccione su grupo de suscripciones o cree uno nuevo si es necesario.

   

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: “Suscripción mensual Premium”, “Suscripción anual Ultimate”, “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
   • Requerido para configurar el plugin de compras nativas

   

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. Configuración de Precios

   Hacer clic Agregar Precio de Suscripción para configurar los precios:

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

   Precio: Establecer 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 de mercado

   

6. Compartir familia (Opcional)

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

   Cuidado

   Una vez que se habilita Compartir familia, no se puede desactivar para este producto.

   Habilitar si:

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

   No habilite 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ónNombre para la interfaz de usuario (por ejemplo, "Premium Mensual")

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

   • Considere mantenerlo conciso y enfocado en los beneficios
   • Mencione las características clave
   • Destaque la propuesta de valor

   

8. Imagen promocional de la App Store (opcional)

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

   • Se muestra en la página de suscripciones de la App Store
   • Debería coincidir con el diseño de tu aplicación
   • Incluir el nombre de la suscripción para claridad

   Nota

   Si bien las imágenes son opcionales para la presentación inicial, son necesarias para la promoción en la Tienda de Aplicaciones. Puedes agregarlas más tarde.

9. Guardar y Enviar

   Hacer clic Guardar para crear la suscripción.

   Para la Primera Suscripción:

   • Deben presentarse con una nueva versión de la aplicación
   • Incluir en la próxima presentación de la Tienda de Aplicaciones
   • No se pueden enviar de forma independiente

   Para Suscripciones Subsecuentes:

   • Pueden 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

Estado de la Suscripción

Su suscripción tendrá uno de estos estados:

Estado	Descripción	¿Puede Probar?
Falta de Metadatos	Configuración incompleta	Sí (entorno de pruebas)
Listo para Presentar	Completo pero no presentado	Sí (entorno de pruebas)
En espera de revisión	Enviado a Apple	Sí (entorno de pruebas)
En revisión	En revisión por parte de Apple	Sí (entorno de pruebas)
Aprobado	Disponible para su compra	Sí
Rechazado	Necesita cambios	Sí (modo sandbox)

Consejo

Puedes probar las suscripciones en modo sandbox incluso si muestran “Datos de metadatos faltantes” o “Listo para enviar”!

Usando en tu aplicación

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();
}

Con planes de facturación 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. Utiliza 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 pago y acceso autorizado, consulte planes de facturación mensuales de compromiso de iOS.

Prácticas recomendadas

Estrategia de precios

• planes mensuales: Barrera de entrada más baja, construye hábito
• planes anuales: Mayor 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

IDs de producto

• 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 todos los IDs de producto para tu equipo

Compartir familia

• Habilitar para aplicaciones orientadas a la familia (juegos, educativos, entretenimiento)
• Considerar el impacto en la recaudación de ingresos
• Prueba el comportamiento de compartir exhaustivamente
• Comunica la capacidad de compartir en la promoción

Localización

• Traduce todos los nombres y descripciones de suscripción
• Considera las diferencias de precios regionales
• Prueba la visualización en todos los idiomas admitidos
• Utiliza un lenguaje de marketing apropiado culturalmente

Imágenes promocionales

• Mantén un estilo visual consistente
• Incluye el nombre de la suscripción y el beneficio clave
• Actualización para promociones estacionales
• Coincidir con el lenguaje de diseño de la aplicación

Patrones de suscripción comunes

Nivel único (de pago)

Free App + Premium Subscription
- Basic: Free (limited features)
- Premium Monthly: $4.99
- Premium Annual: $39.99 (save 33%)

Nivel múltiple (bueno, mejor, mejor)

- Basic Monthly: $4.99
- Premium Monthly: $9.99
- Ultimate Monthly: $19.99

- Basic Annual: $49.99
- Premium Annual: $99.99
- Ultimate Annual: $199.99

Híbrido consumible + suscripción

- Credit packs (consumable)
- Monthly subscription (unlimited credits)
- Annual subscription (unlimited + bonus features)

Resolución de problemas

La suscripción no se está cargando 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:

• Completar todos los campos obligatorios (nombre, descripción, precio)
• Agregar al menos una localización
• Verificar que la información bancaria/taxonomía esté aprobada
• Verifique la primera suscripción (requiere versión de la aplicación)

Deshabilitado el botón de compartir familia:

• Ya está habilitado (no se puede deshabilitar)
• Verifique en detalles de la suscripción
• Contacte 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 con Apple para preguntas de precios

Error de producto inválido: ""

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

Pasos siguientes

• Crea una oferta introductoria para atraer nuevos suscriptores
• Ofrece planes de facturación mensual de mercancías para ofertas de suscripción anual respaldadas
• Configura pruebas de entorno de ensayo para probar tus suscripciones
• Establece ofertas promocionales para recuperar y retener a los suscriptores
• Implementa el seguimiento de análisis de suscripciones

Recursos Adicionales

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