Configuración de Pruebas de Sandbox de iOS

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

Para realizar pruebas de compras en la aplicación en iOS es necesario una configuración adecuada en App Store Connect y en 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 “De Aplicaciones Pagadas” con información bancaria y fiscal completada
Proyecto de Xcode: Configurado con identificador de paquete y capacidades adecuados

Proceso de configuración

Acuerdo de Aplicaciones Pagadas

En App Store Connect, navega a Acuerdos, Impuestos y Bancos y completa:
- Signa el Acuerdo de Aplicaciones Pagadas
- Agrega tu información bancaria
- Completa los formularios de impuestos
Espera a que Apple apruebe tu información (esto puede tardar entre 24-48 horas).
Crear Usuario de Prueba de Sandbox

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

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

ImportanteUtilice 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
Configurar dispositivo de prueba (iOS 12+)

A partir de iOS 12, ya no necesita cerrar sesión en su cuenta de iTunes para probar compras.

En su dispositivo iOS:
1. Abrir Configuración
2. Tocar Tienda de Aplicaciones
3. Desplázate hasta la parte inferior
4. Toca Cuenta de Entorno de Pruebas
5. Inicia sesión con tu cuenta de prueba de entorno de pruebas
Esto es mucho más conveniente que el antiguo método de desloguearse de tu cuenta de iTunes!
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. Seleccione su proyecto en Xcode
2. Vaya a Firma y Capacidad
3. Haga clic + Capacidad
4. Agregar Compra en la Aplicación
Crear productos de compras en la aplicación

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

Los productos deben estar en al menos el estado 'Listo para enviar' para realizar pruebas de sandbox.
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 pruebas 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 el entorno de pruebas
Cancelación inmediata: Las suscripciones canceladas expiran inmediatamente

Gestión de cuenta de entorno de pruebas

Crea múltiples cuentas de prueba para diferentes escenarios
Utiliza cuentas de prueba solo en dispositivos de prueba
No utilices tu 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ías observar:

Banner de sandbox durante la compra: “[Entorno: Sandbox]”
Los productos se cargan con éxito
Las compras se completan sin cargos reales
Las facturas se validan correctamente
Las suscripciones se renuevan automáticamente (a una velocidad acelerada)

Solución de problemas

Los productos no se cargan:

Verifique que el identificador de paquete coincida con App Store Connect
Verificar que los acuerdos estén firmados y aprobados
Asegurarse 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 a la Tienda de iTunes”:

Verificar que la cuenta de sandbox esté configurada correctamente
Verificar 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:

Verificar el consola de Xcode para mensajes de error
Verificar que la capacidad de compras en la aplicación esté habilitada
Asegurarse 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 recibos:

Utiliza el punto de conexión de validación de recibos de sandbox en la prueba
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 de compras nativas maneja esto automáticamente

Duración de suscripción incorrecta:

Recuerda que las suscripciones se aceleran en el sandbox
Utiliza la tabla de conversión anterior para las duraciones esperadas
Las suscripciones se renuevan automáticamente un máximo de 6 veces en el sandbox

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

Esto es normal para nuevas cuentas de sandbox
Continúe con la compra para activar la cuenta
Solo ocurre en el primer uso

Prácticas recomendadas

Crear múltiples cuentas de prueba para diferentes escenarios de prueba
Probar todas las duraciones de suscripción para verificar el comportamiento
Probar la cancelación y la renovación de los flujos
Verificar la validación de la factura funciona correctamente
Prueba la restauración de compras funcionalidad
Verificar la actualización/bajada de la suscripción comportamiento
Prueba 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 la cancelación	Inmediato	Fin del período
Punto de conexió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 la documentación oficial de Apple StoreKit sobre la prueba de entorno de sandbox.

Siga adelante desde Configuración de prueba de entorno de sandbox de iOS

Si está utilizando Configurar la Prueba de Entorno de iOS a fin de planificar la aprobación y distribución de la tienda, conecte con Usando @capgo/compras-nativas para la capacidad nativa en Usando @capgo/compras-nativas, @capgo/capacitor-revisión-de-aplicaciones-en-vivo para el detalle de implementación en @capgo/capacitor-revisión-de-aplicaciones-en-vivo, Usando @capgo/capacitor-revisión-de-aplicaciones-en-vivo para la capacidad nativa en Usando @capgo/capacitor-revisión-de-aplicaciones-en-vivo, @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.