> ## 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 Recharge

> Guida passo passo per collegare Recharge e configurare gli Upgrade degli abbonamenti in Aftersell.

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](/it/aftersell/subscription-upgrades).

<div id="supported-features">
  ## Funzionalità supportate
</div>

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](/it/aftersell/subscription-upgrades-add-item))
* Frequenze prepagate e postpagate

<div id="generating-your-recharge-api-token">
  ## Generare il tuo token API di Recharge
</div>

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](https://docs.rechargepayments.com/).

<div id="connecting-recharge-in-the-setup-wizard">
  ## Collegare Recharge nella procedura guidata di configurazione
</div>

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.

<div id="verifying-an-upgrade-in-recharge">
  ## Verificare un upgrade in Recharge
</div>

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.

<div id="troubleshooting-recharge-specific-issues">
  ## Risoluzione dei problemi specifici di Recharge
</div>

**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](/it/aftersell/subscription-upgrades) · [Configurazione e impostazioni](/it/aftersell/subscription-upgrades-setup) · [Cosa sono le integrazioni?](/it/aftersell/subscription-upgrades-integrations)