Configuración de Pruebas de Sandbox de iOS

La prueba de compras en la aplicación en iOS requiere 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 la prueba de sandbox.

Requisitos previos

• Programa de Desarrolladores de AppleMiembro activo con renovación anual
• Acuerdos: Suscripción firmada “Acuerdo de Aplicaciones Pagadas” con información bancaria y fiscal completada
• Proyecto de Xcode: Configurado con identificador de paquete y capacidades adecuados

Nota

La aprobación del setup de información bancaria y fiscal puede tardar horas o días. Complete esto con anticipación de la prueba.

Proceso de configuración

1. Firma de Acuerdo de Aplicaciones Pagadas

   Navegar a In App Store Connect Acuerdos, Impuestos, y Banca y completar:

   • 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 entre 24-48 horas).

2. Crear Usuario de Prueba de Sandbox

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

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

   Importante: Utilice una dirección de correo electrónico que NO esté asociada con una cuenta de Apple ID. Puede 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 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
   4. Toca Cuenta de Arena
   5. Inicia sesión con tu cuenta de prueba de arena

   Consejo

   Esto es mucho más conveniente que el antiguo método de salir de tu 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 Compra en Aplicación

   1. Seleccione su proyecto en Xcode
   2. Ir a Firma y Capabilities
   3. Haga clic Capacidad adicional
   4. Agregar Compra en la aplicación

5. Crear productos de compra en la aplicación

   En App Store Connect, navegue a su aplicación y cree sus productos de compra en la aplicación (suscripciones, consumibles, etc.).

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

6. Pruebe su implementación

   Construya y ejecute su aplicación en un dispositivo de prueba. Cuando intenta una compra, debería ver:

   [Entorno: Sandbox]

   Esta confirmación indica que se encuentra en el entorno de pruebas y no se le cobrará dinero real.

Notas importantes

Características del entorno de pruebas

• Sin cargos realesTodos los compras son gratuitas en modo de pruebas
• Suscripciones aceleradasLas duraciones de las suscripciones se aceleran 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 el entorno de pruebas
• Cancelación inmediata: Las suscripciones canceladas expiran inmediatamente

Gestión de cuenta de entorno de pruebas

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

Pruebas 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ía observar:

1. Banderas de sandbox durante la compra: “[Entorno: Sandbox]”
2. Los productos cargan con éxito
3. Compras completas sin cargos reales
4. Recibos validan correctamente
5. Suscripciones se renuevan automáticamente (a una velocidad acelerada)

Solución de problemas

Productos no se cargan:

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

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

• Verifica que la cuenta de sandbox esté configurada correctamente
• Revisa 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

Compras fallando en silencio:

• Revisa 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:

• Use endpoint de validación de recibo de sandbox en pruebas
• Endpoint de producción: https://buy.itunes.apple.com/verifyReceipt
• Endpoint de sandbox: https://sandbox.itunes.apple.com/verifyReceipt
• El plugin native-purchases 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 las duraciones esperadas
• Las suscripciones se renuevan automáticamente hasta un máximo de 6 veces en sandbox

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

• Esto es normal para cuentas de sandbox nuevas
• Proceda con la compra para activar la cuenta
• Solo 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. Probar flujos de cancelación y renovación Verificar que la validación de recepción
4. funcione correctamente Probar la funcionalidad de restaurar compras
5. funciona correctamente Probar la funcionalidad de restaurar compras
6. Verificar actualización/descualificación de la suscripción comportamiento
7. Probar con condiciones de red deficientes

Producción vs. Entorno de pruebas

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

Continúa desde Configuración de Prueba de Sandbox de iOS

Si está utilizando Configuración de Prueba de Sandbox de iOS para planificar la aprobación y distribución de tiendas, conéctelo con Usando @capgo/compras-nativas para la capacidad nativa en Usando @capgo/compras-nativas, @capgo/capacitor-revisión-en-aplicación para el detalle de implementación en @capgo/capacitor-revisión-en-aplicación, Usando @capgo/capacitor-revisión-en-aplicación para la capacidad nativa en Usando @capgo/capacitor-revisión-en-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.