Configura i Test di Sandbox iOS

Per eseguire test delle acquisti in-app su iOS è necessaria una configurazione corretta in App Store Connect e sui dispositivi di test. Questa guida copre tutto ciò di cui hai bisogno per iniziare con i test di sandbox.

Requisiti preliminari

• Programma sviluppatore Apple: Iscrizione attiva con rinnovo annuale
• Accordi: Firmato “Accordo per le applicazioni a pagamento” con informazioni bancarie e fiscali completate
• Progetto Xcode: Configurato con identificatore di bundle e capacità corretti

Nota

L'approvazione della configurazione bancaria e fiscale può richiedere ore o giorni. Completa questo in anticipo rispetto al testing.

Procedura di configurazione

1. Sottoscrivi l'accordo per le applicazioni a pagamento

   In App Store Connect, naviga a Accordi, imposte e banche e completa:

   • Sottoscrivi l'accordo per le applicazioni a pagamento
   • Aggiungi le tue informazioni bancarie
   • Completa i moduli delle imposte

   Aspetta che Apple approvi le tue informazioni (questo può richiedere 24-48 ore).

2. Creare un utente di test del sandbox

   In App Store Connect, vai a Utenti e accessi > Testatori del sandbox.

   Clicca sul + crea un nuovo tester di sabbia.

   Importante: Utilizza un indirizzo e-mail che non è già associato a un ID Apple. Puoi utilizzare alias di posta elettronica:

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

   

3. Configura dispositivo di prova (iOS 12+)

   A partire da iOS 12, non è più necessario disconnettersi dall'account iTunes per testare gli acquisti.

   Sul tuo dispositivo iOS:

   1. Apre Impostazioni
   2. Tocca App Store
   3. Scorri fino in fondo
   4. Tocca Account di Sandbox
   5. Accedi con il tuo account di test di sandbox

   Suggerimento

   Questa è molto più comoda rispetto al vecchio metodo di disconnessione del tuo account iTunes!

4. Configura il Progetto Xcode

   Assicurati che il tuo progetto Xcode abbia:

   Identificatore del Bundle

   • Deve corrispondere all'identificatore nel tuo Centro per sviluppatori
   • Deve corrispondere all'identificatore in App Store Connect

   Capacità di acquisto in-app

   1. Seleziona il tuo progetto in Xcode
   2. Vai a Firma e capacità
   3. Clicca Aggiungi capacità
   4. Aggiungi Acquisto in-app

5. Crea prodotti di acquisto in-app

   In App Store Connect, naviga al tuo app e crea i tuoi prodotti di acquisto in-app (abbonamenti, consumabili, ecc.).

   I prodotti devono essere almeno in stato "Pronto per la pubblicazione" per le prove del sandbox.

6. Verifica la tua Implementazione

   Costruisci e esegui l'app sul dispositivo di test. Quando effettui un acquisto, dovresti vedere:

   [Ambiente: Sandbox]

   Questa conferma indica che ti trovi nell'ambiente di test e non sarai addebitato denaro reale.

Nota Importante

Caratteristiche dell'Ambiente di Test

• Nessuna spesa reale: Tutti gli acquisti sono gratuiti in modalità sandbox
• Abbonamenti accelerati: Le durate degli abbonamenti sono accorciate per un test più veloce
  • 1 settimana di sottoscrizione = 3 minuti
  • 1 mese di sottoscrizione = 5 minuti
  • 2 mesi di sottoscrizione = 10 minuti
  • 3 mesi di sottoscrizione = 15 minuti
  • 6 mesi di sottoscrizione = 30 minuti
  • 1 anno di sottoscrizione = 1 ora
• Limite di rinnovo automatico: Le sottoscrizioni si rinnovano fino a 6 volte in sandbox
• Cancellazione immediata: Le sottoscrizioni annullate scadono immediatamente

Gestione del conto di sandbox

• Creare più conti di test per diversi scenari
• Usare conti di test solo su dispositivi di test
• Non utilizzare un ID Apple personale per il testing del sandbox
• I conti di test possono acquistare qualsiasi prodotto indipendentemente dalla regione

Utilizzo del testing del 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);

Verifica

Quando configurato correttamente, dovresti osservare:

1. Bannera del sandbox durante l'acquisto: '[Ambiente: Sandbox]'
2. Prodotti caricano con successo
3. Acquisti completati senza addebiti effettivi
4. Le ricevute vengono validate correttamente
5. Le sottoscrizioni si rinnovano automaticamente (a un ritmo accelerato)

Risoluzione dei problemi

Prodotti non caricano:

• Verifica che l'identificatore del pacchetto corrisponda a App Store Connect
• Verifica che gli accordi siano firmati e approvati
• Assicurati che i prodotti siano almeno nella condizione “Pronto per la pubblicazione”
• Attendi 2-3 ore dopo aver creato i prodotti

“Impossibile connettersi allo Store iTunes”:

• Verifica che l'account sandbox sia configurato correttamente
• Verifica che il dispositivo sia collegato a Internet
• Prova a disconnettersi e a riaccedere all'account sandbox
• Riavvia l'app

Acquisti che falliscono in silenzio:

• Controlla il console di Xcode per i messaggi di errore
• Verifica che la capacità di acquisto In-App sia abilitata
• Assicurati che l'indirizzo e-mail dell'account sandbox non sia un ID Apple reale
• Crea un nuovo account di test sandbox

Errori di validazione della ricevuta:

• Utilizza l'endpoint di validazione della ricevuta sandbox per le prove
• Endpoint di produzione: https://buy.itunes.apple.com/verifyReceipt
• Endpoint sandbox: https://sandbox.itunes.apple.com/verifyReceipt
• Il plugin native-purchases gestisce automaticamente questo aspetto

Durata della sottoscrizione sbagliata:

• Ricorda che le sottoscrizioni sono accelerate nel sandbox
• Utilizza la tabella di conversione sopra per le durate previste
• Le sottoscrizioni si rinnovano automaticamente fino a 6 volte nel sandbox

“Questa Apple ID non è ancora stata utilizzata nell'iTunes Store”:

• Questo è normale per nuovi account sandbox
• Procedi con l'acquisto per attivare l'account
• Succede solo alla prima utilizzo

Pratiche raccomandate

1. Creare più account di test per diversi scenari di test
2. Testare tutte le durate delle sottoscrizioni per verificare il comportamento
3. Testare la cancellazione e la rinnovazione dei flussi
4. Verificare la validazione del ricevuto funziona correttamente
5. Test ripristino acquisti funzionalità
6. Verifica l'aggiornamento/abbassamento della sottoscrizione comportamento
7. Testare con condizioni di rete scarse

Produzione vs. Sandbox

Funzione	Sandbox	Produzione
Carichi reali	No	Sì
Durata della sottoscrizione	Accelerato	Normale
Limite di rinnovo automatico	6 volte	Senza limiti
Effetto della cancellazione	Iniziale	Fine del periodo
Punto di ricezione della ricevuta	URL di sandbox	URL di produzione
Solo per conti di test	Sì	No

Risorse aggiuntive

Per ulteriori informazioni, si rinvia alla documentazione ufficiale di Apple StoreKit sulla testa del sandbox.

Continua da Configura la testa del sandbox per iOS

Se stai utilizzando Configura il testing di Sandbox per iOS per pianificare l'approvazione e la distribuzione della store, connettilo con Utilizza @capgo/native-purchases per la capacità nativa in Utilizza @capgo/native-purchases @capgo/capacitor-in-app-review per il dettaglio di implementazione in @capgo/capacitor-in-app-review Utilizza @capgo/capacitor-in-app-review per la capacità nativa in Utilizza @capgo/capacitor-in-app-review @capgo/capacitor-native-market per il dettaglio di implementazione in @capgo/capacitor-native-market, e Utilizza @capgo/capacitor-native-market per la capacità nativa in Utilizza @capgo/capacitor-native-market