Skip to main content
Questa pagina copre tutto ciò che riguarda specificamente l’uso di Loop 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

Loop supporta tutti i tipi di Upgrade degli abbonamenti:
  • Modifica della frequenza di consegna o di fatturazione
  • 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)
  • Solo frequenze postpagate (il prepagato non è supportato — vedi Limitazioni qui sotto)

​
Limitazioni specifiche di Loop

  • La frequenza di fatturazione deve essere uguale alla frequenza di consegna. Loop non supporta gli abbonamenti prepagati tramite questa integrazione. Il campo della frequenza di fatturazione è disabilitato e sincronizzato automaticamente con la frequenza di consegna. Questo è il vincolo più importante da tenere presente se il tuo negozio si basa su piani prepagati.

​
Generare il tuo token API di Loop

  1. Apri l’app Loop e vai su Settings in basso a sinistra.
  2. Sotto Admin, clicca su API Tokens.
  3. Imposta le autorizzazioni necessarie ad Aftersell: Read and Write su Subscription contracts e Read su Orders e Selling plans. L’accesso in scrittura è richiesto solo per gli abbonamenti.
  4. Clicca su Generate New Token.
  5. Inserisci un nome, seleziona gli scope appropriati e clicca su Generate Token.
  6. Clicca su Show Token per visualizzare e copiare la tua chiave. Trattala come una password e conservala in un luogo sicuro.
Per maggiori dettagli, consulta la documentazione API di Loop.

​
Collegare Loop nella procedura guidata di configurazione

Quando arrivi allo Step 1: Connect provider nella procedura guidata degli Upgrade degli abbonamenti:
  1. Seleziona Loop dal menu a tendina Subscription provider.
  2. Incolla il tuo token API nel campo API token.
  3. Clicca su Test API key. Aftersell convalida il token, verificando che si autentichi correttamente, disponga di tutti gli scope richiesti e 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”. Il token è stato autenticato, tutti gli scope richiesti sono presenti e il token appartiene al tuo negozio. Continue è ora abilitato.
  • Icona rossa di annullamento. La verifica non è andata a buon fine. Leggi il messaggio accanto all’icona: il token è stato rifiutato oppure mancano gli scope richiesti. Il messaggio indica gli scope specifici mancanti. Correggi il token in Loop e ripeti il test. Oppure Aftersell non è riuscito a completare la verifica (“Could not verify the API key. Please try again.”), che indica una chiamata fallita e non un token errato — 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 il token azzera il risultato precedente.

​
Mantenere intatti gli abbonamenti multi-prodotto

Per impostazione predefinita, quando un upgrade di frequenza o di frequenza-e-prodotto si applica a un cliente con due o più righe attive sul suo abbonamento Loop, Aftersell scorpora il prodotto aggiornato in un nuovo abbonamento. In questo modo gli altri articoli mantengono la loro cadenza di fatturazione originale. Se gli altri prodotti dell’abbonamento sono add-on del prodotto aggiornato (anziché abbonamenti autonomi), puoi abilitare Don’t split multi-product subscriptions sull’offerta. Quando questa opzione è attiva, Aftersell riprogramma l’intero contratto sulla nuova frequenza invece di scorporarlo. Cosa aspettarsi quando questa impostazione è attiva:
  • Anche gli altri prodotti dell’abbonamento passano alla nuova frequenza.
  • Quei prodotti mantengono lo sconto del piano di vendita della loro frequenza originale, ma alla nuova cadenza.
  • Aftersell non garantisce prezzi corretti per gli articoli associati — se un prodotto associato è su un piano a prezzo fisso senza un piano corrispondente alla nuova frequenza, mantiene il suo prezzo assoluto originale alla nuova cadenza.
Abilita questa opzione solo quando gli altri prodotti sono add-on del prodotto aggiornato. Se sono abbonamenti indipendenti, usa il comportamento di scorporo predefinito così ogni prodotto resta sul proprio calendario di fatturazione.
Questa impostazione è disponibile per i tipi di upgrade frequency e frequency + product solo su Loop. Appare come una casella di controllo nel pannello delle impostazioni dell’offerta.

​
Prima di configurare l’upgrade (Step 3)

Quando configuri una modifica di frequenza, puoi scegliere un piano di vendita esistente oppure impostare la frequenza manualmente:
  • Usa un piano di vendita esistente. Scegli dal menu a tendina dei piani di vendita. Il piano deve già esistere ed essere attivo nella tua dashboard di Loop.
  • Imposta la frequenza manualmente. Inserisci tu stesso la frequenza di consegna. Loop accetta qualsiasi cadenza senza richiedere un piano di vendita corrispondente. Puoi anche applicare uno sconto ricorrente quando usi una frequenza manuale.
Se imposti la frequenza manualmente e l’abbonamento del cliente ha due o più righe di prodotto attive (un contratto multiprodotto o bundle), l’upgrade fallirà a meno che non esista un piano di vendita corrispondente alla frequenza target. Vedi Limitazioni per i dettagli.

​
Selezionare un livello di sconto ricorrente

Alcuni piani di vendita di Loop applicano sconti diversi in momenti diversi dell’abbonamento — per esempio, $20 di sconto sul primo addebito e $10 di sconto dal secondo addebito in poi. Quando selezioni un piano di questo tipo, il campo Recurring discount viene sostituito da un elenco di pulsanti radio che mostrano ciascun livello di sconto del piano con il relativo intervallo di addebiti (per esempio, “Charge 1” o “Charge 2 onward”). Seleziona il livello che vuoi applicare a ogni rinnovo futuro dell’abbonamento aggiornato. Il livello selezionato viene salvato con l’offerta e applicato quando un cliente accetta l’upgrade. Se il piano selezionato non ha livelli di sconto, o se stai impostando la frequenza manualmente, appare invece il campo standard di inserimento libero dello sconto.

​
Verificare un upgrade in Loop

Dopo aver effettuato un ordine di prova e accettato l’offerta di upgrade: Vai su Subscriptions nella tua dashboard di Loop e trova l’abbonamento del cliente. Le chiamate di upgrade di Loop sono sincrone, quindi non c’è alcun ritardo di elaborazione lato Aftersell — la modifica viene applicata in Loop nel momento in cui la chiamata restituisce il risultato. L’elenco degli abbonamenti di Loop può impiegare un po’ più di tempo ad aggiornarsi, quindi se non compare ancora, attendi qualche minuto e aggiorna la pagina prima di considerarlo un errore. Se la modifica non c’è, non è andata a buon fine — vedi sotto.

​
Risoluzione dei problemi specifici di Loop

Non riesco a modificare la frequenza di fatturazione È il comportamento previsto. Loop non supporta gli abbonamenti prepagati tramite questa integrazione. Il campo della frequenza di fatturazione è disabilitato e sincronizzato automaticamente con la frequenza di consegna. L’upgrade è stato accettato ma l’abbonamento non è stato modificato Se l’abbonamento è invariato, le cause più comuni sono:
  • Hai impostato la frequenza manualmente e l’abbonamento del cliente ha due o più righe di prodotto attive. In questo caso, Loop richiede un piano di vendita corrispondente alla frequenza target. Crea il piano di vendita in Loop, oppure passa a Use an existing selling plan nella configurazione dell’offerta.
  • Hai usato Use an existing selling plan e il piano di vendita selezionato non esiste più nella tua dashboard di Loop. Crea il piano di vendita in Loop e riprova.
  • Il tuo token API è scaduto o non dispone delle autorizzazioni richieste: write su Subscription contracts, read su Orders e Selling plans. Vai allo Step 1: Connect provider, ripeti il test della chiave e controlla il messaggio di errore per gli scope specifici mancanti.
  • 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. Il menu a tendina dei piani di vendita è vuoto L’opzione “Use an existing selling plan” recupera i piani direttamente da Loop. Se il menu a tendina è vuoto:
  • Verifica che i piani di vendita siano configurati nella tua dashboard di Loop.
  • Assicurati che il tuo token API abbia l’accesso Read su Selling plans.
  • Torna allo Step 1: Connect provider, ripeti il test della tua chiave API e continua.
Nella mia dashboard di Loop compaiono righe temporanee in elaborazione È il comportamento previsto quando un upgrade di abbonamento multilinea usa il comportamento di scorporo predefinito. Loop lo gestisce in due passaggi (scorporo, poi rimozione), il che può far emergere righe temporanee durante la finestra di sincronizzazione di 24 ore. Si risolvono automaticamente al completamento della sincronizzazione. Se vuoi evitare del tutto lo scorporo, vedi Mantenere intatti gli abbonamenti multi-prodotto.
← Torna a Panoramica degli upgrade degli abbonamenti · Configurazione e impostazioni · Cosa sono le integrazioni?