Crear Suscripción Auto-Renovable de iOS

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:

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: acceso recurrente a contenido, servicios o características premium en tu aplicación de iOS.

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

Crear una Suscripción

1. Ir 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 ReferenciaNombre 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: Establezca el precio de la suscripción

   • Apple convierte automáticamente a otras monedas
   • Elija de las escalas de precios de Apple
   • Considerar el valor percibido y las tasas del mercado

   

6. Compartir de la Familia (Opcional)

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

   Advertencia

   Una vez que se habilita Compartir de la Familia, no se puede desactivar para este producto.

   Habilitar si:

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

   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ón: Nombre que se muestra al cliente (por ejemplo, "Premium Mensual")

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

   • Manténgalo conciso y enfocado en 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 suscripción 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

   Mientras que las imágenes son opcionales para la presentación inicial, son requeridas para el display promocional en la App Store. Puedes agregarlas más tarde.

9. Guardar y enviar

   Haga clic Guardar para crear la suscripción.

   Para la primera suscripción:

   • Deben ser enviados con una nueva versión de la aplicación
   • Inclúyalo en su próxima presentación de la Tienda de Aplicaciones
   • No se puede enviar de manera independiente

   Para suscripciones posteriores:

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

Estatus de Suscripción

Su suscripción tendrá uno de estos estatus:

Estatus	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í (entorno de pruebas)

Consejo

Puedes probar las suscripciones en modo de pruebas incluso si muestran “Falta de metadatos” o “Listo para enviar”!

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

Mensual con planes de compromiso de 12 meses

Si tu suscripción de App Store Connect está configurada con un plan de facturación mensual y 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 de 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 pared de pago y la autorización de derechos, consulte planes de facturación mensuales de iOS.

Prácticas recomendadas

Estrategia de precios

• planes mensuales: Barrera de entrada más baja, fomenta la costumbre
• planes anuales: Mayor valor, mayor LTV, menor rotación
• múltiples niveles: Básico, Premium, Ultimate para diferentes segmentos de usuarios
• análisis competitivo: Investiga los precios similares de las aplicaciones

IDs de producto

• Utiliza nombres consistentes: company.app.tier_duration
• Incluye la tarifa y la duración en el ID: premium_monthly, ultimate_annual
• Evita cambiar los IDs de producto (son permanentes)
• Documenta todos los IDs de producto para tu equipo

Compartir de la familia

• Habilita para aplicaciones orientadas a la familia (juegos, educativos, entretenimiento)
• Considera el impacto en la recaudación de ingresos
• Prueba el comportamiento de compartir exhaustivamente
• Comunicar la capacidad de compartir en marketing

Localización

• 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

Imágenes promocionales

• Mantener un estilo visual consistente
• Incluir el nombre de la suscripción y el beneficio clave
• Actualizar 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 de consumo + suscripción

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

Resolución de problemas

La suscripción no se carga en la aplicación:

• Verifique que el ID del producto coincida exactamente (sensible a mayúsculas y minúsculas)
• Verifique que la suscripción esté en el grupo de suscripciones
• Asegúrese de que el identificador de la cesta 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)
• Agregue al menos una localización
• Verifique que la información bancaria/taxonomía esté aprobada
• Verifique si la primera suscripción (requiere versión de la aplicación)

Deshabilitado: compartir familia

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

Nivel de tarifa 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 por errores de ortografía
• Verificar la unicidad en todos los productos

Pasos siguientes

• Crear una oferta introductoria para atraer nuevos suscriptores
• Ofertas de merchandising de planes de facturación mensual para ofertas de suscripción anual apoyadas
• Configurar pruebas de sandbox para probar suscripciones
• Configurar ofertas promocionales para recuperar y retener a los suscriptores
• Implementar el seguimiento de análisis de suscripciones

Recursos adicionales

Para obtener más detalles, consulte el documento oficial de Apple sobre suscripciones renovables automáticas.

Sigue adelante desde Crear suscripción renovable automática de iOS

Si está utilizando Crear suscripción renovable automática de iOS para planificar la aprobación y distribución en la tienda, conecte Usando @capgo/compras-nativas para la capacidad nativa en Usando @capgo/compras-nativas, @capgo/capacitor-revisión-en-la-aplicación para el detalle de implementación en @capgo/capacitor-revisión-en-la-aplicación Usando @capgo/capacitor-revisión en la aplicación para la capacidad nativa en Usando @capgo/capacitor-revisión en la 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