Directrices de Revisión de la Tienda de Aplicaciones de iOS para IAP

Proceso de revisión de la App Store de iOS

Título de la sección “Antes de Presentar”

Para obtener aprobación en la Tienda de Aplicaciones de Apple es necesario prestar mucha atención a las directrices de Apple, especialmente al implementar compras en la aplicación y suscripciones. Esta guía cubre todo lo que necesitas saber para aprobar la revisión en tu primera presentación.

Antes de que Apple revise su flujo de compra, asegúrese de que el registro de la aplicación esté completo:

• Agregue una URL de política de privacidad en Apple App Store Connect
• Agregue una URL de soporte que conduce a información de contacto real para los usuarios
• Complete el preguntario de clasificación por edad para que la aplicación sea publicable
• Agregue Detalles de contacto para la revisión de la aplicación y notas de revisión claras
• Si es necesario el inicio de sesión, proporcione una cuenta de demostración que no expira durante la revisión Nota

Apple considera el sitio de soporte como más que un enlace de reemplazo. Debe contener detalles de contacto reales para que los usuarios puedan comunicarse con usted sobre problemas de la aplicación, comentarios y solicitudes de características.

Metadatos de la lista de la Tienda de Apple con enlaces de política y soporte

Sección titulada “Preparar Pantallas Reales”

• Para iPhone,
• Para iPhone 1290 x 2796 (6.7-inch) es el tamaño por defecto más fácil
• Si tu aplicación se ejecuta en iPad, sube también capturas de pantalla de iPad
• Los tamaños de iPad grandes aceptados actualmente incluyen 2064 x 2752 (13-inch) y 2048 x 2732 (12.9-inch)
• Nunca estiras capturas de pantalla de iPhone para fingir el soporte de iPad

Realiza un recorrido seco de la experiencia del revisor en TestFlight

Ejecuta el camino exacto que Apple seguirá en un dispositivo real:

• Instala la última versión desde TestFlight
• Inicia sesión con la cuenta de revisión que planeas proporcionar
• Llega a la pantalla de pago sin gestos ocultos ni menús de depuración
• Flujos de compra, restauración y gestión de suscripciones protegidas
• Verificar que la aplicación sigue comportándose correctamente si se deniegan los permisos

Requisitos de compras en la aplicación

Transparencia de Precios (Crítico)

Apple requiere una transparencia de precios cristalina antes de cualquier compra:

Elementos obligatorios:

• Muestra el precio exacto antes del botón de compra
• Muestra la frecuencia de facturación (por ejemplo, “$9.99/mes”)
• Establece claramente qué obtienen los usuarios por su dinero
• Indica cuándo se producirán los cargos

Rechazo Común:

“El precio de la suscripción debe ser claro y transparente.”

:::caution Consistencia de Precios Todos los precios deben coincidir en:

• Lista de metadatos de la tienda de aplicaciones
• Pantallas de compras en la aplicación
• Pantallas de gestión de suscripciones

Even una diferencia de $1 entre la lista de la tienda ($4.99) y la aplicación ($5.99) desencadenará un rechazo automático. :::

Presentación del Plan de Suscripción

Discusiones Requeridas:

• Todos los niveles de suscripción disponibles se muestran juntos
• Comparación clara de características por nivel
• No auto-defaulting a los niveles premium a través de trucos de interfaz de usuario
• Instrucciones de cancelación fáciles de encontrar

Ejemplo de interfaz de usuario conforme:

import { NativePurchases } from '@capgo/native-purchases';

function SubscriptionScreen() {
  return (
    <div>
      <h2>Choose Your Plan</h2>

      {/* Show all tiers equally */}
      <PlanCard
        title="Basic"
        price="$4.99/month"
        features={['Feature A', 'Feature B']}
      />
      <PlanCard
        title="Premium"
        price="$9.99/month"
        features={['All Basic', 'Feature C', 'Feature D']}
        highlighted={false} // Don't force premium
      />

      {/* Clear cancellation info */}
      <Text>
        Cancel anytime in Settings > Subscriptions.
        No refunds for partial periods.
      </Text>
    </div>
  );
}

Restaurar compras

Implementación requerida:

Cada aplicación con IAP debe proporcionar una forma para que los usuarios restauren compras anteriores sin contactar con el soporte.

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

async function restorePurchases() {
  try {
    await NativePurchases.restorePurchases();

    const { purchases } = await NativePurchases.getPurchases({
      productType: PURCHASE_TYPE.SUBS,
    });

    const activeSub = purchases.find(
      (purchase) => purchase.isActive && purchase.expirationDate,
    );

    if (activeSub) {
      unlockPremiumFeatures();
      showMessage('Purchases restored successfully!');
      return;
    }

    const { purchases: iaps } = await NativePurchases.getPurchases({
      productType: PURCHASE_TYPE.INAPP,
    });
    const hasIap = iaps.some((purchase) => purchase.productIdentifier === 'premium_unlock');

    showMessage(
      hasIap ? 'Premium purchase restored!' : 'No previous purchases found.',
    );
  } catch (error) {
    showError('Failed to restore purchases. Please try again.');
  }
}

// Add a visible "Restore Purchases" button
<Button onClick={restorePurchases}>
  Restore Purchases
</Button>

Motivos de rechazo comunes

1. La aplicación se cae o tiene funcionalidad rota

¿Por qué falla?:

• La aplicación se cae al iniciar
• El flujo de compra no se completa
• Las características mostradas en las capturas de pantalla no funcionan

Prevención:

• Prueba en dispositivos reales (no solo simuladores)
• Prueba todos los flujos de suscripción de principio a fin
• Verifica que la validación de recibos funcione
• Revisa el manejo de errores de red

2. Incongruencias de Metadatos

Por qué Falla:

• Capturas de pantalla muestran características no presentes en la versión actual
• La descripción menciona funcionalidades que no existen
• El precio en los metadatos difiere del precio en la aplicación

Prevención:

// Document exactly what's in each tier
const SUBSCRIPTION_FEATURES = {
  basic: ['Ad-free', 'Cloud sync', 'Basic themes'],
  premium: ['Ad-free', 'Cloud sync', 'All themes', 'Priority support']
};

// Use these in both your app AND App Store description

3. Explicaciones Faltantes de Permisos

Por qué Falla:

• Solicitando cámara/ubicación/salud sin explicación
• Solicitudes de permiso enterradas en varias pantallas
• Descripciones de permiso vagas o generales

Prevención:

Actualice su Info.plist con explicaciones claras:

<key>NSCameraUsageDescription</key>
<string>Camera access is needed to scan product barcodes for quick subscription upgrades.</string>

<key>NSLocationWhenInUseUsageDescription</key>
<string>Location helps us show relevant local content in your Premium subscription.</string>

4. Publicidad engañosa

¿Por qué falla?

• Reclamos como “#1 aplicación en el mundo” sin pruebas
• Características “Ilimitadas” con límites ocultos
• Tácticas de urgencia falsas (“Solo quedan 2 plazas!”)

Prevención:

• Sé específico y factual en las descripciones
• Evita superlativos sin evidencia
• No presiones a los usuarios con falsa escasez

5. Proceso de Cancelación Oculto

¿Por qué Falla:

• No mención de cómo cancelar
• Botón de cancelación oculto o obstruido
• Proceso de cancelación de varios pasos sin el flujo nativo de Apple

Prevención:

// Always inform users about cancellation
function SubscriptionInfo() {
  return (
    <div>
      <h3>How to Cancel</h3>
      <ol>
        <li>Open iPhone Settings</li>
        <li>Tap your name at the top</li>
        <li>Tap Subscriptions</li>
        <li>Select this app and tap Cancel</li>
      </ol>

      <p>Or manage directly in the App Store app.</p>

      <Button onClick={openSubscriptionManagement}>
        Manage Subscription in Settings
      </Button>
    </div>
  );
}

async function openSubscriptionManagement() {
  // Direct link to iOS subscription management
  await NativePurchases.showManageSubscriptions();
}

Privacidad y Uso de Datos (Sección 5.1.1)

Apple ha reforzado significativamente los requisitos de privacidad en 2025.

Declaraciones Requeridas

Para Cada Permiso:

1. ¿Por qué lo necesita (uso específico de caso)
2. ¿Cuándo se utilizará?
3. ¿Cómo se almacenan y comparten los datos?
4. ¿Es obligatorio o opcional?

Ejemplo: Flujo de permisos adecuado

async function requestCameraPermission() {
  // Show explanation BEFORE requesting
  await showDialog({
    title: 'Camera Access',
    message: 'We need camera access to let you scan barcodes for quick product lookup. Your photos are never uploaded or stored.',
    buttons: ['Not Now', 'Allow']
  });

  // Then request permission
  const result = await Camera.requestPermissions();
  return result.camera === 'granted';
}

Etiquetas de nutrición de privacidad

Asegúrate de que las etiquetas de privacidad de App Store reflejen con precisión:

• Recopilación de historial de compras
• Direcciones de correo electrónico (para facturas)
• IDs de dispositivo (para prevención de fraude)
• Datos de uso (para análisis)

Los etiquetados de privacidad inexactos son una razón común de rechazo en 2025. Audita cuidadosamente la recopilación de datos.

Lista de Verificación Pre-Envío

1. Compre cada nivel de suscripción

   • Prueba las pruebas gratuitas
   • Verifica que las ofertas de inicio se apliquen correctamente
   • Prueba la restauración de compras
   • Verifica la Compartición Familiar (si habilitado)
   • Prueba en múltiples dispositivos
   • __CAPGO_KEEP_0__

2. Verificar Consistencia de Precios

   • Revisar que los metadatos de la Tienda de Aplicaciones coincidan con los precios en la aplicación
   • Verificar que todos los monedas estén correctos
   • Confirmar que las duraciones de las pruebas gratuitas coincidan con las descripciones
   • Revisar los términos de las ofertas iniciales sean precisos

3. Revisar Todo el Contenido

   • Eliminar texto de reemplazo
   • Verificar que las afirmaciones sean verificables
   • Revisar gramática y ortografía
   • Asegurarse de que las descripciones coincidan con la versión actual
   • Eliminar menciones de competidores

4. Probar Permisos

   • Solicite solo permisos necesarios
   • Mostrar explicaciones claras antes de solicitar permisos
   • Pruebe los flujos de denegación (la aplicación debería seguir funcionando)
   • Verifique que las descripciones de Info.plist sean claras

5. Preparar Cuenta de Prueba

   • Crear una cuenta de revisión que permanezca válida durante la revisión
   • Documentar las credenciales de inicio de sesión en la información de revisión de la aplicación
   • Verifique que el revisor pueda llegar a la pantalla de pago y completar el flujo de compra
   • Incluir cuentas adicionales o interruptores de aplicación específicos en el campo de Notas si es necesario

6. Verificar Metadatos

   • Las capturas de pantalla coinciden con la interfaz de usuario actual
   • La URL de soporte incluye información de contacto real
   • La URL de la política de privacidad está rellenada
   • La clasificación de edad coincide con el contenido en la compilación
   • La vista previa del aplicativo (si la hay) muestra la versión actual
   • La descripción describe con precisión las características
   • La política de privacidad está accesible desde la aplicación y desde la lista de la tienda

7. Escribe Notas de Revisión Detalladas

   Contact:
   Name: Jane Developer
   Email: review@yourapp.com
   Phone: +1 555-0100
   
   Test Account:
   Email: reviewer@test.com
   Password: TestPass123!
   This account does not expire during review.
   
   Testing Instructions:
   1. Log in with test account above
   2. Tap "Upgrade to Premium" button
   3. Select "Monthly Premium" subscription
   4. Complete purchase (no charge in sandbox)
   5. Verify premium features unlock
   
   Note: Subscription pricing is clearly shown before purchase.
   Cancellation instructions are in Settings > Account.

Cronología de Revisión

Revisión estándar: 24-48 horas Periodos de pico: 3-5 días (lanzamientos de vacaciones de la Tienda de Aplicaciones) Fin de semana: No se procesan reseñas Revisión acelerada: Disponible para correcciones de errores críticos (solicitar a través de App Store Connect)

Estados comunes que verá en App Store Connect:

• Waiting for Review
• In Review
• Pending Developer Release
• Rejected

Consejo

Envíe sus solicitudes a principios de semana para evitar retrasos de fines de semana. Las solicitudes de lunes suelen ser revisadas el miércoles.

Enfoque de presentación de 2026

Áreas de Enfoque Actual

1. Claridad de Suscripción

• Se requieren comparaciones de planes de lado a lado
• No se deben utilizar patrones oscuros que oculten opciones más económicas
• Deben estar claros los caminos de descenso y ascenso

2. Precisión de Metadatos

• Las capturas de pantalla deben coincidir con la versión que se está revisando
• Se requieren capturas de pantalla de iPad si se habilita el soporte para iPad
• La URL de soporte y la política de privacidad deben estar ya disponibles antes de la presentación

3. Calidad de Detalles de Privacidad y Revisión

• Las declaraciones de privacidad deben coincidir con lo que realmente recopilan sus SDKs
• La información de contacto y notas de la revisión de la aplicación deben estar completas en la primera presentación
• Las credenciales de la demo deben mantenerse válidas durante toda la ventana de revisión

4. Preparación de la presentación

• Apple actualiza regularmente los requisitos mínimos de SDK, así que confirme la fecha límite actual antes de subir una versión de lanzamiento
• TestFlight es el lugar más seguro para verificar el camino exacto del revisor antes de presentar

Prácticas recomendadas para el plugin de compras nativas

Implementar un manejo adecuado de errores

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

async function handlePurchase(productId: string) {
  try {
    const transaction = await NativePurchases.purchaseProduct({
      productIdentifier: productId,
      productType: PURCHASE_TYPE.SUBS,
    });

    // Success
    await validateReceiptOnServer(transaction.receipt);
    showSuccess('Subscription activated!');
    unlockFeatures();

  } catch (error: any) {
    // Handle specific error cases
    if (error.code === 'USER_CANCELLED') {
      // User cancelled - don't show error
      console.log('Purchase cancelled by user');
    } else if (error.code === 'PAYMENT_PENDING') {
      showInfo('Payment is pending. Please check back later.');
    } else if (error.code === 'PRODUCT_ALREADY_PURCHASED') {
      // Restore instead
      await NativePurchases.restorePurchases();
    } else {
      // Show user-friendly error
      showError('Unable to complete purchase. Please try again.');
    }
  }
}

Mostrar estados de carga

function PurchaseButton({ productId }: { productId: string }) {
  const [loading, setLoading] = useState(false);

  const handlePurchase = async () => {
    setLoading(true);
    try {
      await NativePurchases.purchaseProduct({ productIdentifier: productId });
    } finally {
      setLoading(false);
    }
  };

  return (
    <button onClick={handlePurchase} disabled={loading}>
      {loading ? 'Processing...' : 'Subscribe Now'}
    </button>
  );
}

Muestra los términos claramente

function SubscriptionTerms() {
  return (
    <div className="terms">
      <p>
        Subscription automatically renews unless cancelled at least 24 hours
        before the end of the current period.
      </p>
      <p>
        Your account will be charged for renewal within 24 hours prior to
        the end of the current period.
      </p>
      <p>
        Subscriptions may be managed by the user and auto-renewal may be
        turned off in Account Settings after purchase.
      </p>
      <p>
        <a href="/terms">Terms of Service</a> |
        <a href="/privacy/">Privacy Policy</a>
      </p>
    </div>
  );
}

Si tu aplicación es rechazada

Pasos para resolver

1. Lee la rechaza con cuidado

   • Nota la guía específica citada (por ejemplo, 3.1.1, 5.1.1)
   • Entiende exactamente qué marcó Apple

2. Repara el problema exhaustivamente

   • No se limiten a parchar - solucionen la causa raíz
   • Prueben la solución exhaustivamente
   • Documenten los cambios realizados

3. Responder en el Centro de Resolución

   Thank you for your feedback. I have addressed the issue:
   
   Issue: Subscription pricing not clear upfront
   
   Fix: Added explicit pricing display on subscription selection
   screen showing "$9.99/month" before purchase button. Also added
   cancellation instructions on the same screen.
   
   The changes are in this submission and can be tested using the
   provided test account.

4. Reenviar con prontitud

   • Las reenviaciones suelen ser revisadas más rápido
   • Normalmente dentro de 24 horas

Proceso de Apelación

Si creen que la rechazo es incorrecto:

1. Haga clic en ‘Apelación’ en App Store Connect
2. Proporcione evidencia clara:
   • Pantallas de captura que muestran la conformidad
   • Referencias a pautas específicas
   • Explicación de cómo cumple con los requisitos
3. Sea profesional y factual
4. Incluya cuenta de prueba si la funcionalidad es difícil de encontrar

Recursos adicionales

• Directrices de revisión de la tienda de aplicaciones de Apple
• Directrices de compras en la aplicación
• Prácticas de Suscripciones
• Ayuda de App Store Connect
• Specificaciones de Pantallas de Captura
• Información de Versión de Plataforma

Apoyo

Si aún tienes problemas:

• Revisa el Documentación de Compras Nativas
• Verifica problemas de depuración comunes
• Contacta con el Apoyo del Desarrollador de Apple para aclaraciones de directrices

Necesita Ayuda Expertas?

¿Tiene dificultades con la revisión de la aplicación o necesita asistencia personalizada? Reserve una llamada de consultación con nuestro equipo para obtener soporte dedicado con:

• Revisión y optimización de la implementación de IAP
• Preparación y estrategia de revisión de la tienda App Store
• Revisión del checklist de presentación
• Resolución de rechazos y recursos de apelación
• Pruebas y validación completas

Nuestros expertos han ayudado con éxito a cientos de aplicaciones a superar la revisión!

__CAPGO_KEEP_0__

Si estás utilizando Directrices de revisión de la Tienda de Aplicaciones de iOS para IAP para planificar la aprobación y distribución de la tienda, conecta con Usando @capgo/native-purchases para la capacidad nativa en Usando @capgo/native-purchases, @capgo/capacitor-revisión-de-la-venta-en-la-aplicación para el detalle de implementación en @capgo/capacitor-revisión-de-la-venta-en-la-aplicación, Usando @capgo/capacitor-revisión-de-la-venta-en-la-aplicación para la capacidad nativa en Usando @capgo/capacitor-revisión-de-la-venta-en-la-aplicación, @capgo/capacitor-mercado-nativo para el detalle de implementación en @capgo/capacitor-mercado-nativo, y Usando @capgo/capacitor-native-market para la capacidad nativa en Usando @capgo/capacitor-native-market.