Skip to main content
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.

​
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). 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.

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

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

​
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 · Configurazione e impostazioni · Cosa sono le integrazioni?