Configuración de Pruebas de Arena de iOS

Para probar las compras en la aplicación en iOS es necesario una configuración adecuada en App Store Connect y en tus dispositivos de prueba. Esta guía cubre todo lo que necesitas para empezar con pruebas de sandbox.

Requisitos previos

• Programa de Desarrolladores de AppleMiembro activo con renovación anual
• AcuerdosAcuerdo firmado “De Aplicaciones Pagadas” con información bancaria y fiscal completada
• Proyecto de XcodeConfigurado con identificador de paquete y capacidades adecuados

Nota

La aprobación del establecimiento de la banca y los impuestos puede tardar horas o días. Complete esto con anticipación de la prueba.

Proceso de configuración

1. firmar el Acuerdo de Aplicaciones Pagadas

   En App Store Connect, navegue a Acuerdos, Impuestos y Banca y complete:

   • firmar el Acuerdo de Aplicaciones Pagadas
   • Agregar información bancaria
   • Completar formularios de impuestos

   Esperar a que Apple apruebe su información (esto puede tardar 24-48 horas).

2. Crear Usuario de Prueba de Arena

   En App Store Connect, vaya a Usuarios y Acceso > Prueba de Arena.

   Haga clic en el + botón para crear un nuevo probador de arena.

   Importante: Utilice una dirección de correo electrónico que NO esté asociada con una cuenta de Apple. Puede utilizar alias de correo electrónico:

   • Gmail: youremail+test@gmail.com
   • iCloud: youremail+test@icloud.com

   

3. Configurar Dispositivo de Prueba (iOS 12+)

   Desde iOS 12, ya no necesita cerrar sesión en su cuenta de iTunes para realizar compras de prueba.

   En su dispositivo iOS:

   1. Abrir Configuración
   2. Tocar Tienda de aplicaciones
   3. Desplazarse hacia abajo hasta el final
   4. Tocar Cuenta de prueba de sandbox
   5. Iniciar sesión con su cuenta de prueba de sandbox

   Consejo

   Esto es mucho más conveniente que el antiguo método de desconectar su cuenta de iTunes!

4. Configura el proyecto de Xcode

   Asegúrate de que tu proyecto de Xcode tenga:

   Identificador de paquete

   • Debe coincidir con el identificador en tu Centro de Desarrolladores
   • Debe coincidir con el identificador en App Store Connect

   Capacidad de compras en la aplicación

   1. Selecciona tu proyecto en Xcode
   2. Vaya a Configuración de firmas y capacidades
   3. Haga clic en Agregar capacidad
   4. Agregar capacidad In-App Purchase

5. Crear Productos de Compras en la Aplicación

   En App Store Connect, navega a tu aplicación y crea tus productos de compras en la aplicación (suscripciones, consumibles, etc.).

   Los productos deben estar en al menos el estado “Listo para enviar” para pruebas de sandbox.

6. Prueba tu Implementación

   Construye y ejecuta tu aplicación en un dispositivo de prueba. Cuando intentes una compra, debes ver:

   [Entorno: Sandbox]

   Esta confirmación indica que estás en el entorno de sandbox y no serás cobrado dinero real.

Notas Importantes

Características del Entorno de Sandbox

• No cargos reales: Todas las compras son gratuitas en modo sandbox
• Suscripciones aceleradas: Las duraciones de las suscripciones se acortan para pruebas más rápidas
  • 1 semana de suscripción = 3 minutos
  • 1 mes de suscripción = 5 minutos
  • 2 meses de suscripción = 10 minutos
  • 3 meses de suscripción = 15 minutos
  • 6 meses de suscripción = 30 minutos
  • 1 año de suscripción = 1 hora
• Límite de renovación automática: Las suscripciones se renuevan automáticamente hasta 6 veces en modo sandbox
• Cancelación inmediata: Las suscripciones canceladas expiran inmediatamente

Gestión de cuenta de Sandbox

• Crear múltiples cuentas de prueba para diferentes escenarios
• Usar cuentas de prueba solo en dispositivos de prueba
• No usar ID de Apple personal para la prueba de Sandbox
• Las cuentas de prueba pueden comprar cualquier producto sin importar la región

Uso de la prueba de Sandbox

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

const { isBillingSupported } = await NativePurchases.isBillingSupported();
if (!isBillingSupported) {
  throw new Error('StoreKit not supported on this device');
}

// Fetch products (automatically uses sandbox when available)
const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['premium_monthly'],
  productType: PURCHASE_TYPE.SUBS,
});

// Make test purchase
const transaction = await NativePurchases.purchaseProduct({
  productIdentifier: 'premium_monthly',
  productType: PURCHASE_TYPE.SUBS,
});

console.log('Test purchase successful!', transaction.transactionId);

Verificación

Cuando esté correctamente configurado, debería observar:

1. Banner de entorno de pruebas durante la compra: “[Entorno: Entorno de pruebas]”
2. Los productos cargan con éxito
3. Las compras completan sin cargos reales
4. Las facturas se validan correctamente
5. Las suscripciones se renuevan automáticamente (a una velocidad acelerada)

Resolución de problemas

Productos no se cargan:

• Verificar que el identificador de paquete coincida con App Store Connect
• Compruebe que los acuerdos estén firmados y aprobados
• Asegúrese de que los productos tengan al menos el estado “Listo para enviar”
• Esperar 2-3 horas después de crear productos

“No se puede conectar a la Tienda de iTunes”:

• Verificar que la cuenta de sandbox esté configurada correctamente
• Compruebe que el dispositivo esté conectado a Internet
• Intentar cerrar sesión y volver a iniciar sesión en la cuenta de sandbox
• Reiniciar la aplicación

Compras fallando en silencio:

• Verifique la consola de Xcode para mensajes de error
• Verifique que la capacidad de compras en la aplicación esté habilitada
• Asegúrese de que el correo electrónico de la cuenta de prueba no sea un ID de Apple real
• Intenta crear una nueva cuenta de prueba de sandbox

Errores de validación de recibo:

• Utilice el punto de conexión de validación de recibo de sandbox en pruebas
• Punto de conexión de producción: https://buy.itunes.apple.com/verifyReceipt
• Punto de conexión de sandbox: https://sandbox.itunes.apple.com/verifyReceipt
• El plugin nativo de compras maneja esto automáticamente

Duración de suscripción incorrecta:

• Recuerde que las suscripciones se aceleran en sandbox
• Utilice la tabla de conversión anterior para duraciones esperadas
• Las suscripciones se renuevan automáticamente hasta un máximo de 6 veces en el entorno de pruebas

“Esta cuenta de Apple aún no se ha utilizado en la Tienda de iTunes”:

• Esto es normal para cuentas de pruebas nuevas
• Continúe con la compra para activar la cuenta
• Sólo ocurre en el primer uso

Prácticas recomendadas

1. Crear múltiples cuentas de prueba para diferentes escenarios de prueba
2. Probar todas las duraciones de suscripción para verificar el comportamiento
3. Test cancelación y renovación flujo
4. Verificar la validación de la recepción funciona correctamente
5. Test de restauración de compras funcionalidad
6. Comprobar la actualización/subida de la suscripción comportamiento
7. Test con condiciones de red pobres

Producción vs. Entorno de pruebas

Característica	Sandbox	Producción
Cargas reales	No	Sí
Duración de la suscripción	Acelerado	Normal
Límite de renovación automática	6 veces	Ilimitado
Efecto de cancelación	Inmediato	Fin de período
Punto de recepción	URL de sandbox	URL de producción
Sólo para cuentas de prueba	Sí	No

Recursos adicionales

Para obtener más detalles, consulte la documentación oficial de Apple StoreKit en pruebas de sandbox.

Sigue adelante desde Configuración de pruebas de sandbox de iOS

Si estás utilizando Configuración de pruebas de sandbox de iOS para planificar la aprobación y distribución de la tienda, conecta con Usando @capgo/compras-nativas para la capacidad nativa en Usando @capgo/compras-nativas, @capgo/capacitor-revisión-de-aplicación para el detalle de implementación en @capgo/capacitor-revisión-de-aplicación, Usando @capgo/capacitor-revisión-de-aplicación para la capacidad nativa en Usando @capgo/capacitor-revisión-de-aplicación, @capgo/capacitor-mercado nativo para el detalle de implementación en @capgo/capacitor-mercado nativo, y Utilizando @capgo/capacitor-mercado nativo para la capacidad nativa en Utilizando @capgo/capacitor-mercado nativo.