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.
  • Gli abbonamenti multilinea vengono gestiti in due passaggi: la riga del prodotto target viene scorporata in un nuovo abbonamento con la frequenza desiderata e poi rimossa dall’originale. Ciò comporta più chiamate API e potrebbe far comparire righe temporanee in elaborazione nella tua dashboard di Loop durante la finestra di sincronizzazione.
  • La frequenza personalizzata non è supportata per gli abbonamenti multilinea. Quando imposti la frequenza manualmente (senza selezionare un piano di vendita), l’upgrade funziona per i clienti il cui abbonamento contiene una sola riga di prodotto. Per i clienti con un abbonamento multiprodotto o bundle (due o più righe attive) l’upgrade fallirà se non esiste un piano di vendita corrispondente alla frequenza target. Per supportare questi clienti, crea il piano di vendita corrispondente nella tua dashboard di Loop.

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

​
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 per gli abbonamenti multilinea. Loop li gestisce in due passaggi (scorporo, poi rimozione), quindi una riga temporanea può comparire tra i due. Si risolve non appena il secondo passaggio viene completato.
← Torna a Panoramica degli upgrade degli abbonamenti · Configurazione e impostazioni · Cosa sono le integrazioni?