> ## Documentation Index > Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt > Use this file to discover all available pages before exploring further. # Upgrade degli abbonamenti con Stay AI > Guida passo passo per collegare Stay AI e configurare gli Upgrade degli abbonamenti in Aftersell, incluse le limitazioni specifiche di Stay AI relative a piani prepagati, cancellazioni e valuta. Questa pagina copre tutto ciò che riguarda specificamente l'uso di **Stay AI** con gli Upgrade degli abbonamenti, incluse le sue limitazioni particolari. Per una panoramica completa sul funzionamento degli Upgrade degli abbonamenti, consulta [Upgrade degli abbonamenti](/it/aftersell/subscription-upgrades).
## Funzionalità supportate
Stay AI supporta tutti i tipi di Upgrade degli abbonamenti: * Modifica della frequenza di consegna o di fatturazione (applicata all'intero abbonamento) * Sostituzione con un prodotto diverso * Entrambi - modifica della frequenza e sostituzione del prodotto * Aggiunta di un altro articolo abbonabile all'abbonamento (vedi [Aggiungere un articolo](/it/aftersell/subscription-upgrades-add-item)). Se il cliente è già abbonato a quel prodotto, Stay ne aumenta la quantità invece di aggiungere una nuova riga (con una condizione di corrispondenza del prezzo - vedi le limitazioni qui sotto). * Frequenze postpagate (pagamento a ogni consegna), incluso il passaggio di un abbonamento postpagato a un piano con pagamento anticipato (alle condizioni indicate qui sotto) Le sostituzioni di prodotto sono supportate **tranne verso un prodotto venduto solo con piani a pagamento anticipato** - vedi la limitazione sul prepagato qui sotto.
### Passare un abbonamento a un piano con pagamento anticipato
Il passaggio di un abbonamento postpagato a un piano con pagamento anticipato (prepagato) è supportato, a due condizioni: * **Il piano con pagamento anticipato deve già esistere in Stay AI ed essere assegnato al prodotto.** Aftersell non può crearne uno; l'offerta ti permette solo di scegliere tra i piani già configurati in Stay AI. * **Il passaggio crea un nuovo abbonamento e annulla quello precedente.** Stay applica questa modifica creando un nuovo abbonamento sul piano con pagamento anticipato e annullando quello originale, quindi l'abbonamento riceve un **nuovo riferimento**. Gli strumenti di magazzino, 3PL o reportistica che tracciano gli abbonamenti tramite riferimento devono essere risincronizzati. Vedi [Evasione e mappatura 3PL](/it/aftersell/subscription-upgrades-fulfillment).
## Limitazioni specifiche di Stay AI
* **Gli abbonamenti prepagati (con pagamento anticipato) non possono essere modificati.** Stay non consente alcuna modifica a un abbonamento che il cliente ha pagato in anticipo, qualunque sia il tipo di upgrade. Se un cliente con un piano prepagato accetta un'offerta di upgrade, l'upgrade viene annullato e il cliente viene rimborsato, quindi l'abbonamento resta invariato. Per lo stesso motivo, non puoi sostituire un abbonamento con un prodotto venduto solo con piani a pagamento anticipato. * **Le cancellazioni sono limitate a un'app per account.** Stay invia gli aggiornamenti sulle cancellazioni a **una sola app per account**. Se un'altra app o integrazione si è registrata al webhook di cancellazione di Stay prima di Aftersell, Aftersell non può ricevere quegli aggiornamenti e il [grafico Subscriptions cancelled](/it/aftersell/analytics_metrics_reference#subscriptions-cancelled-chart) non rifletterà le cancellazioni di Stay. La chiave API che colleghi deve includere il permesso **Webhooks** (vedi sotto) perché il tracciamento delle cancellazioni funzioni. * **Una modifica della frequenza si applica all'intero abbonamento.** Stay ha un solo calendario per abbonamento, quindi cambiare la frequenza di arrivo sposta tutti i prodotti al suo interno. Quando l'abbonamento contiene due o più prodotti, devi attivare **Keep on existing subscription** sull'offerta; altrimenti l'upgrade di frequenza viene rifiutato e l'acquirente viene rimborsato. Questo è necessario solo per le modifiche di frequenza: le sostituzioni di prodotto e gli add-on non sono interessati e funzionano senza questa opzione. * **Aggiungere altre unità di un prodotto a cui il cliente è già abbonato richiede un prezzo corrispondente.** Quando l'add-on è un prodotto che il cliente ha già, Stay ne aumenta la quantità invece di aggiungere una riga, ma solo se il prezzo dell'offerta corrisponde a quello che il cliente paga già. Se i prezzi sono diversi (per esempio, l'add-on offre il 20% di sconto mentre il piano del cliente ha il 10% di sconto), l'upgrade viene rifiutato e l'abbonamento resta invariato. Assegna all'add-on lo stesso sconto del piano del cliente, oppure offri un prodotto diverso (un prodotto diverso non è interessato). * **La valuta deve corrispondere ai prezzi del tuo negozio.** Se l'abbonamento del cliente viene fatturato in una valuta in cui il tuo negozio non ha prezzi, l'upgrade viene rifiutato. * **Gli abbonamenti duplicati provenienti da un unico ordine non possono essere distinti.** Se un singolo ordine ha avviato due abbonamenti Stay che contengono entrambi il prodotto dell'offerta, Aftersell non può capire a quale si riferisse il cliente, e l'upgrade viene rifiutato invece di essere applicato al contratto sbagliato. * **I limiti di richieste limitano il volume.** Stay consente 60 richieste al minuto per account. Un upgrade richiede da quattro a sei richieste, quindi un negozio arriva al massimo a circa 10-15 upgrade al minuto nei momenti di picco.
## Generare la tua chiave API di Stay AI
1. Nella tua dashboard di Stay AI, vai su **Account → API tokens → Add API key**. 2. Quando crei la chiave, seleziona **All permissions**. Aftersell ha bisogno dell'accesso a **Subscriptions**, **Orders**, **Selling Plan Groups** e **Webhooks**. Il permesso Webhooks è quello che consente ad Aftersell di essere informato delle cancellazioni. 3. Copia la chiave e conservala in un luogo sicuro. Trattala come una password. Per maggiori dettagli, consulta la [documentazione sull'autenticazione API di Stay AI](https://docs.stay.ai/reference/authentication).
## Collegare Stay AI nella procedura guidata di configurazione
Quando arrivi allo **Step 1: Connect provider** nella procedura guidata degli Upgrade degli abbonamenti: 1. Seleziona **Stay AI** dal menu a tendina **Subscription provider**. 2. Incolla la tua chiave API nel campo **API key**. 3. Clicca su **Test API key**. Aftersell convalida la chiave, verificando che si autentichi correttamente e che appartenga al tuo negozio. 4. Una volta superato il test (spunta verde), clicca su **Continue** per passare allo Step 2. Il risultato del test mostra uno di due stati: * **Spunta verde - "API key verified".** La chiave è stata autenticata e appartiene al tuo negozio. **Continue** è ora abilitato. Se alla chiave manca il permesso **Webhooks**, il test viene comunque superato ma avvisa che le cancellazioni degli abbonamenti non verranno registrate: ricrea la chiave in Stay AI con **All permissions** se vuoi tracciare le cancellazioni. * **Icona rossa di annullamento.** La verifica non è andata a buon fine. Leggi il messaggio accanto all'icona: la chiave è stata rifiutata, oppure Aftersell non è riuscito a completare la verifica ("Could not verify the API key. Please try again."), che indica una chiamata fallita e non una chiave errata - in quel caso basta ripetere il test. Un risultato di verifica non riuscita appare identico a un rifiuto, quindi basati sul messaggio e non sull'icona. **Continue** resta disabilitato finché la verifica non risulta verde, e modificare il provider o la chiave azzera il risultato precedente.
## Verificare un upgrade in Stay AI
Dopo aver effettuato un ordine di prova e accettato l'offerta di upgrade: Vai su **Subscriptions** nella tua dashboard di Stay AI e trova l'abbonamento del cliente. La frequenza di fatturazione, il prodotto o la data del prossimo addebito dovrebbero riflettere la modifica. La modifica stessa viene applicata non appena Aftersell elabora l'accettazione, ma Stay può essere lento ad acquisire un ordine appena creato: l'upgrade di solito arriva in pochi minuti, e fino a 24 ore nei casi più lenti. Se la modifica non c'è ancora, attendi un po' prima di considerarla un errore.
## Se un upgrade non può essere applicato
Gli upgrade con Stay AI sono sicuri per progettazione: a un acquirente non viene mai addebitato un upgrade che non è avvenuto. * **Gli upgrade non riusciti vengono ritentati automaticamente.** Se una chiamata a Stay AI fallisce, Aftersell la ritenta in un flusso di lavoro in background. * **Se non può ancora essere applicato, l'acquirente viene rimborsato.** Un Subscription Upgrade addebita solo una piccola riga segnaposto sull'ordine Shopify (non un prodotto che l'acquirente conserva), quindi Aftersell rimborsa quell'addebito quando l'upgrade non può essere completato. * **Tutto ciò che non può essere confermato viene segnalato per una revisione manuale** invece di essere ipotizzato, così a un acquirente non viene mai addebitato un upgrade che non è avvenuto. Per tutti i dettagli sul meccanismo di nuovi tentativi e riconciliazione (comune a tutti i provider), consulta [Come funzionano gli Upgrade degli abbonamenti](/it/aftersell/subscription-upgrades#how-subscription-upgrades-work).
## Risoluzione dei problemi specifici di Stay AI
**L'upgrade è stato accettato ma l'abbonamento non è stato modificato** Le cause più comuni: * Il cliente ha un piano **prepagato (con pagamento anticipato)**. Stay non consente di modificare i contratti prepagati, quindi l'upgrade viene annullato e rimborsato. È il comportamento previsto. * L'abbonamento viene fatturato in una **valuta in cui il tuo negozio non ha prezzi**, quindi l'upgrade è stato rifiutato. * L'abbonamento contiene **due o più prodotti** e hai modificato la frequenza senza attivare **Keep on existing subscription**. * Un ordine ha avviato **due abbonamenti Stay** che contengono entrambi il prodotto dell'offerta, quindi Aftersell non ha potuto capire quale aggiornare. * La tua chiave API appartiene a un altro negozio, oppure non dispone di un permesso richiesto (**Subscriptions**, **Orders** o **Selling Plan Groups**). Ricrea o riseleziona la chiave in Stay AI, vai allo **Step 1: Connect provider** e ripeti il test. * Il prodotto idoneo nel funnel non corrisponde a ciò a cui il cliente si è effettivamente abbonato. Aftersell riprova automaticamente le chiamate al provider non riuscite in un flusso di lavoro in background. Se tutti i tentativi falliscono, contatta il supporto indicando l'URL del tuo negozio, l'ID dell'ordine Shopify, l'email del cliente, l'orario approssimativo in cui l'upgrade è stato accettato e il provider che stai utilizzando. **Le cancellazioni di Stay non compaiono nelle analitiche** Stay invia gli aggiornamenti sulle cancellazioni a una sola app per account. Se un'altra app si è registrata al webhook di cancellazione di Stay prima di Aftersell, Aftersell non può riceverli. Verifica che nessun'altra integrazione detenga il webhook di cancellazione di Stay e assicurati che la chiave API collegata includa il permesso **Webhooks**. *** ← Torna a [Panoramica degli upgrade degli abbonamenti](/it/aftersell/subscription-upgrades) · [Configurazione e impostazioni](/it/aftersell/subscription-upgrades-setup) · [Cosa sono le integrazioni?](/it/aftersell/subscription-upgrades-integrations)