Configurar Pruebas de Entorno de Sandbox de iOS

Para realizar pruebas de compras en la aplicación en iOS es necesario configurar correctamente App Store Connect y los dispositivos de prueba. Esta guía cubre todo lo que necesita para empezar con pruebas de sandbox.

Requisitos previos

• Programa de Desarrolladores de Apple: Miembro activo con renovación anual
• Acuerdos: Acuerdo firmado “Paid Applications Agreement” con información bancaria y fiscal completada
• Proyecto de Xcode: Configurado con identificador de paquete y capacidades adecuados

Nota

La aprobación de la configuración de banca y tributaria puede tardar horas o días. Complete esto con anticipación de la prueba.

Proceso de Configuración

1. Firma del Acuerdo de Aplicaciones Pagadas

   En App Store Connect, navega a Acuerdos, Tributación y Banca y completa:

   • Firma el Acuerdo de Aplicaciones Pagadas
   • Agrega tu información bancaria
   • Complete formularios de impuestos

   Espera a que Apple apruebe tu información (esto puede tardar entre 24-48 horas).

2. Crear Usuario de Prueba de Sandbox

   En App Store Connect, ve a Usuarios y Acceso > Prueba de Sandbox.

   Haz clic en el + botón para crear un nuevo probador de sandbox.

   Importante: Utiliza una dirección de correo electrónico que NO esté asociada con una ID de Apple. Puedes utilizar alias de correo electrónico:

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

   

3. Configurar Dispositivo de Prueba (iOS 12+)

   A partir de iOS 12, ya no es necesario cerrar sesión en tu cuenta de iTunes para realizar compras de prueba.

   En tu dispositivo iOS:

   1. Abrir Configuración
   2. Tocar Tienda de Aplicaciones
   3. Desplazarse hacia abajo hasta la parte inferior
   4. Tocar Cuenta de Prueba de Arena
   5. Iniciar sesión con tu cuenta de prueba de arena

   Consejo

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

4. Configurar 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. Ir a Firma y Capabilities
   3. Haz clic + Capacidad
   4. Agregar Compra en la Aplicación

5. Crear Productos de Compra en la Aplicación

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

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

6. Prueba Tu Implementación

   Construye y ejecuta tu aplicación en un dispositivo de prueba. Cuando intentes una compra, deberías 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 Pruebas

• Sin cargos reales: Todas las compras son gratuitas en modo de pruebas
• 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

Administración de cuentas de sandbox

• Crear múltiples cuentas de prueba para diferentes escenarios
• Utilice cuentas de prueba solo en dispositivos de prueba
• No utilice una 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

Al configurarse correctamente, deberías 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. Renovaciones de suscripciones se renuevan automáticamente (a una tasa acelerada)

Resolución de problemas

Productos no se cargan:

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

“No se puede conectar al Tienda de iTunes”:

• Verifique que la cuenta de sandbox esté configurada correctamente
• Verifique que el dispositivo esté conectado a Internet
• Intenta cerrar sesión y volver a iniciar sesión en la cuenta de sandbox
• Reinicia la aplicación

Errores de compra en silencio:

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

Errores de validación de recibo:

• Utiliza 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 la suscripción incorrecta:

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

“Este ID 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
• Solo ocurre en el primer uso

Prácticas recomendadas

1. Cree múltiples cuentas de prueba para diferentes escenarios de prueba
2. Prueba todas las duraciones de suscripción para verificar el comportamiento
3. Prueba flujos de cancelación y renovación Prueba la validación de recepción
4. para asegurarse de que funcione correctamente Prueba la restauración de compras
5. funcionalidad Verifica el comportamiento de la actualización/subida de la suscripción
6. Verifica el comportamiento Prueba con condiciones de red deficientes
7. Producción vs. Entorno de pruebas

__CAPGO_KEEP_0__

Característica	Entorno de pruebas	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 del período
Punto de recepción de la factura	URL de entorno de pruebas	URL de producción
Solo para cuentas de prueba	Sí	No

Recursos adicionales

Para obtener más detalles, consulte el documento oficial de Apple StoreKit sobre la prueba de sandbox.