Vai al contenuto principale
— Guida alla configurazione

Gestisci chiavi assegnate, revocate e restituite per ordine

A ogni ordine Shopify contenente un prodotto con chiave di licenza viene assegnata una o più chiavi al momento dell'approvazione antifrode. Alva Digital Downloads le mostra nella pagina di dettaglio ordine, dove puoi revocare una chiave (togliendola permanentemente dalla circolazione) o restituire una chiave non utilizzata al pool così l'ordine successivo può rivendicarla.

Stati delle chiavi in Alva

Ogni chiave di licenza ha uno di quattro stati, che riflettono il punto del suo ciclo di vita:

  • AVAILABLE — nel pool, in attesa di essere assegnata.
  • ASSIGNED — collegata a una riga PurchaseLicenseKey su un ordine cliente.
  • REVOKED — rimossa manualmente dal pool, mai più riemessa.
  • RETURNED — era assegnata, poi rilasciata prima che il cliente la visualizzasse; la chiave sottostante torna ad AVAILABLE con una traccia di audit sulla riga d'acquisto.
AVAILABLE → ASSIGNED   (paid order, fraud-approved)
ASSIGNED  → REVOKED    (Revoke — terminal)
ASSIGNED  → AVAILABLE  (Return — only if not viewed)

Revoca una chiave da un ordine

La revoca è un'azione forte: la chiave passa a REVOKED, riceve un timestamp revokedAt sulla riga d'acquisto e non viene mai più offerta a un altro ordine. La copia della stringa della chiave del cliente resta invariata — se il tuo sistema a valle controlla un registro centrale all'attivazione, la chiave fallirà lì.

  1. Apri l'ordine in Ordini e scorri fino alla sezione Chiavi di licenza.
  2. Sulla riga della chiave assegnata, clicca Revoca.
  3. Conferma nella modale. La riga si aggiorna a Revocata e scompare dalla pagina account del cliente al prossimo ricaricamento.
Screenshot necessario

Pagina di dettaglio ordine admin Alva. Mostra la card Chiavi di licenza con una chiave elencata, il codice chiave parzialmente mascherato e il pulsante Revoca evidenziato con un riquadro rosso. Nessun dato cliente reale visibile.

L'azione Revoca su una riga di chiave di licenza assegnata.

Restituisci una chiave senza revocarla

Usa Restituisci quando il cliente dice che la chiave non funziona e vuoi una chiave nuova sull'ordine senza bruciare quella vecchia. Alva riporta l'originale ad AVAILABLE, registra un timestamp returnedAt, e l'ordine successivo in coda la rivendica. Restituisci è abilitato solo finché il cliente non ha ancora visualizzato la chiave.

  1. Apri l'ordine e scorri fino a Chiavi di licenza.
  2. Clicca Restituisci sulla riga della chiave interessata e conferma.
  3. Clicca Assegna nuova chiave per rivendicare la prossima chiave disponibile, poi reinvia l'email di consegna.
Screenshot necessario

Pagina di dettaglio ordine admin Alva. Mostra la card Chiavi di licenza con l'azione Restituisci visibile accanto a Revoca. Includi un piccolo badge "Non ancora visualizzata" sulla riga della chiave per rendere ovvia la precondizione.

L'azione Restituisci — disponibile solo finché il cliente non ha visualizzato la chiave.

Cosa vedono i clienti

Le chiavi revocate scompaiono dalla pagina account del cliente e dalla pagina di download dello stato ordine al prossimo caricamento — restano solo i link ai file. Anche le chiavi restituite scompaiono, poiché la riga di assegnazione viene rimossa. Nessuna delle due azioni invia una notifica: abbina Revoca a un'email di rimborso e abbina Restituisci a una nuova assegnazione più un reinvio manuale.

Domande frequenti

Posso annullare una revoca?

No. La revoca è permanente — la chiave non può tornare ad Available. Se hai revocato per errore, carica una nuova chiave nello stesso gruppo e assegnala manualmente all'ordine.

Perché il pulsante Restituisci è disabilitato?

Restituisci è disponibile solo finché il cliente non ha ancora visualizzato la chiave. Una volta che il cliente apre l'email di consegna o la pagina di download e la chiave viene contrassegnata come visualizzata, resta disponibile solo Revoca.

Il cliente verrà notificato di nuovo dopo che assegno una nuova chiave?

Nessuna email automatica viene inviata per una riassegnazione manuale. Usa l'azione Reinvia email dell'ordine dopo aver assegnato la chiave sostitutiva così il cliente riceve il nuovo codice.

Vedi anche

È stato utile?

Ancora bloccato? Scrivici.

Ultimo aggiornamento 2026-05-06