Skip to main content
Questa pagina copre tutto ciò che riguarda specificamente l’uso di Recharge con gli Upgrade degli abbonamenti. Per una panoramica completa sul funzionamento degli Upgrade degli abbonamenti, consulta Upgrade degli abbonamenti.

​
Funzionalità supportate

Recharge 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)
  • Frequenze prepagate e postpagate

​
Generare il tuo token API di Recharge

  1. Accedi al tuo portale merchant di Recharge.
  2. Vai su Tools & Apps → API Tokens.
  3. Clicca su Create an API Token.
  4. Inserisci un nome e un’email di contatto.
  5. Imposta le autorizzazioni necessarie ad Aftersell: Read and Write su Subscriptions e Read su Orders e Plans. Non è richiesto alcuno scope Products.
  6. Clicca su Save e copia la chiave API.
Il token deve disporre di tutti e quattro gli scope: read_orders, read_subscriptions, write_subscriptions e read_plans. Aftersell verifica la presenza di tutti e quattro quando testi la chiave e indica quelli mancanti nel messaggio di errore. Per maggiori dettagli, consulta la documentazione API di Recharge.

​
Collegare Recharge nella procedura guidata di configurazione

Quando arrivi allo Step 1: Connect provider nella procedura guidata degli Upgrade degli abbonamenti:
  1. Seleziona Recharge 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 Recharge 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.

​
Verificare un upgrade in Recharge

Dopo aver effettuato un ordine di prova e accettato l’offerta di upgrade: Vai su Customers nella tua dashboard di Recharge, trova il cliente e apri Subscriptions. L’abbonamento attivo dovrebbe riflettere immediatamente la nuova frequenza, il nuovo prodotto o lo sconto. Recharge si aggiorna quasi in tempo reale dopo l’accettazione.

​
Risoluzione dei problemi specifici di Recharge

L’upgrade è stato accettato ma l’abbonamento non è stato modificato Le cause più comuni:
  • Il tuo token API è scaduto o non dispone delle autorizzazioni richieste. Il token deve avere read_orders, read_subscriptions, write_subscriptions e read_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 Recharge. Se il menu a tendina è vuoto:
  • Verifica che i piani di vendita siano configurati nella tua dashboard di Recharge.
  • Assicurati che il tuo token API abbia lo scope read_plans.
  • Torna allo Step 1: Connect provider, ripeti il test della tua chiave API e continua.
← Torna a Panoramica degli upgrade degli abbonamenti · Configurazione e impostazioni · Cosa sono le integrazioni?