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

Copie una solicitud de configuración con los pasos de instalación y la guía de markdown completa para este plugin.

Para obtener aprobación de tu aplicación en la Tienda de Mac App Store, es necesario prestar atención cuidadosa 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.

Proceso de Revisión de la Tienda de Aplicaciones de iOS

Antes de Presentar

Finalizar la Configuración de App Store Connect

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

Agregue un URL de Política de Privacidad en App Store Connect Agregue un
URL de Soporte que conduce a información de contacto real para los usuarios Agregue un
Complete el cuestionario de calificación por edad para que la aplicación sea publicable edad de calificación Complete el cuestionario de calificación por edad para que la aplicación sea publicable
Agregar Agregar detalles de contacto de revisión de la aplicación y notas claras del revisor Si se requiere inicio de sesión, proporcione una cuenta de demostración que no expira durante la revisión
Nota Nota

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

Preparar Pantallas de Captura Real

Utilice pantallas de captura del build real actual en revisión
Para iPhone, 1290 x 2796 (6.7 pulgadas) es el tamaño por defecto más fácil
Si su aplicación se ejecuta en iPad, también suba pantallas de captura de iPad
Las tamaños de iPad grandes aceptados incluyen 2064 x 2752 (13 pulgadas) y 2048 x 2732 (12.9 pulgadas)
Nunca estire pantallas de captura de iPhone para fingir soporte de iPad

Realice una prueba de recorrido 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
Accede a la paywall sin gestos ocultos ni menús de depuración
Flujos de compra, restauración y gestión de suscripciones
Verifica 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 imprescindibles:

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

Rechazo común:

"El precio de la suscripción debe ser claro y explícito."

:::advertencia Consistencia de precios Todos los precios deben coincidir en:

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

Even un desacuerdo 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

Declaraciones obligatorias:

Todos los niveles de suscripción disponibles mostrados juntos
Comparación clara de características por nivel
No se redirige automáticamente a los niveles premium mediante trucos de interfaz de usuario
Instrucciones de cancelación fáciles de encontrar

Consejos de diseño de interfaz de usuario

Paywall con restaurar compras y enlaces legales

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
Verifica el manejo de errores de red

2. Incongruencias de metadatos

Por qué falla:

Las capturas de pantalla muestran características que no están 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

Lista de verificación de metadatos

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 de permisos faltantes

Por qué falla:

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

Prevención:

Actualice su Info.plist con explicaciones claras:

Copiar permisos demasiado vagos para revisión

Copiar permisos con explicaciones más 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:

Afirman cosas como “la aplicación número 1 en el mundo” sin pruebas
“Características ilimitadas” que tienen límites ocultos
Tácticas de urgencia falsas (“Solo quedan 2 plazas!”)

Ejemplos de Directrices de Descripción

Directrices de Descripción Adicionales

Prevención:

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

5. Proceso de cancelación oculto

Por qué falla:

No se menciona cómo cancelar
Botón de cancelación oculto o dificultado de acceso
Proceso de cancelación en varias etapas 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:

Por qué lo necesita (uso de caso específico)
Cuándo se utilizará
Cómo se almacena o comparte la información
Si es opcional o requerido

Ejemplo: Flujo de Permiso Correcto

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úrese de que las etiquetas de privacidad de la Tienda de Aplicaciones reflejen con precisión:

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

Las etiquetas de privacidad inexactas son una causa común de rechazo en 2025. Audite cuidadosamente la recopilación de datos.

Lista de Verificación Pre-Envío

Prueba todos los flujos de compra

Compre cada nivel de suscripción
- Prueba las pruebas gratuitas
- Prueba todas las pruebas gratuitas
- Verificar si las ofertas iniciales se aplican correctamente
- Probar la restauración de compras
- Verificar la Compartición Familiar (si está habilitada)
- Probar en múltiples dispositivos
Verificar la Consistencia de Precios
- Comprobar que los metadatos de la Tienda de Aplicaciones coinciden con los precios en la aplicación
- Verificar que todos los monedas sean correctos
- Confirmar que las duraciones de las pruebas gratuitas coinciden con las descripciones
- Comprobar que los términos de las ofertas iniciales son precisos
Revisar Todas las Copias
- Eliminar texto de reemplazo
- Verificar que las afirmaciones sean probables
- Verificar gramática y ortografía
- Asegurarse de que las descripciones coincidan con la versión actual
- Eliminar menciones a competidores
Probar permisos
- Solicitar solo los permisos necesarios
- Mostrar explicaciones claras antes de solicitar permisos
- Probar flujos de denegación (la aplicación debería seguir funcionando)
- Verificar que las descripciones de Info.plist sean claras
Preparar cuenta de prueba
- Crear una cuenta de revisión que permanezca válida durante la revisión
- Documentar credenciales de inicio de sesión en la información de revisión de la aplicación
- Verificar que el revisor pueda llegar a la pantalla de pago y completar el flujo de compra
- Incluya cuentas adicionales o interruptores de aplicación específicos en el campo Notas si es necesario
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á rellena
- La clasificación de edad coincide con el contenido en la compilación
- El video de vista previa de la aplicación (si existe) muestra la versión actual
- La descripción describe con precisión las características
- La política de privacidad está accesible en la aplicación y desde la lista de la tienda

Escribir 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

Timeline de Revisión de la Tienda de Aplicaciones

Revisión estándar: 24-48 horas Períodos de pico: 3-5 días (lanzamientos de vacaciones de la Tienda de Aplicaciones) Fines 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

Enfoque de la Solicitud de 2026

Áreas de Enfoque Actuales

1. Claridad de la Suscripción

Comparaciones de planes lado a lado requeridas
No utilizar patrones oscuros que ocultan opciones más económicas
Rutas claras de bajada/actualización

2. Precisión de los Metadatos

Las capturas de pantalla deben coincidir con la construcción que se está revisando
Las capturas de pantalla de iPad son necesarias si se habilita el soporte de iPad
La URL de soporte y la política de privacidad deben estar ya en línea 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 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 SDK, así que confirme el plazo actual antes de subir un paquete de lanzamiento
TestFlight es el lugar más seguro para verificar el camino exacto del revisor antes de presentar

Mejores prácticas para el plugin de compras nativas

Implementar un manejo de errores adecuado

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

Mostrar Términos de Manera Clara

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 Fue Rechazada

Pasos para Resolver

Lee la rechazo con cuidado
- Nota la guía específica citada (por ejemplo, 3.1.1, 5.1.1)
- Entiende exactamente qué marcó Apple
Repara el problema exhaustivamente
- No solo parche - arregla la causa raíz
- Prueba la solución exhaustivamente
- Documenta lo que cambió

Responde 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.

Reenvíe con prontitud
- Las reenvíos suelen ser revisados más rápido
- Normalmente dentro de 24 horas

Proceso de Apelación

Si cree que la rechazo es incorrecto:

Proceso de Aclaración de la Tienda de Aplicaciones

Haga clic en “Apelar” en App Store Connect
Proporcione evidencia clara:
- Capturas de pantalla que muestran cumplimiento
- Referencias a pautas específicas
- Explicación de cómo cumple con los requisitos
Sea profesional y factual
Incluya cuenta de prueba si la funcionalidad es difícil de encontrar

Ejemplo de Solicitud de Documentos

Recursos Adicionales

Soporte

Si aún tienes problemas:

Revisa Documentación de compras nativas
Verificar Problemas de depuración comunes
Contactar con el soporte de desarrolladores de Apple para aclaraciones de directrices

¿Necesita ayuda experta?

¿Tiene dificultades con la revisión de la aplicación o necesita asistencia personalizada? Reserve una llamada de consultoría 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
Pruebas y validación completas

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