Perché è importante
Le chiavi di licenza sono finite. Un codice di attivazione monouso o un token di sblocco può essere usato solo una volta — e una volta inviato per email a un acquirente, ha effettivamente lasciato il tuo pool, che l'acquirente abbia pagato con una carta rubata o no. Senza questa regola, ogni ordine fraudolento consumerebbe una chiave reale, e i merchant che vendono software in piccoli lotti, accesso a corsi o codici di attivazione vedrebbero il loro inventario svuotarsi a causa delle frodi con chargeback. Alva Digital Downloads tratta l'assegnazione delle chiavi come una prenotazione fatta dopo che l'ordine è considerato affidabile, non al momento del pagamento.
Come funziona in pratica
Il flusso si svolge sempre nello stesso modo quando i controlli antifrode sono abilitati sullo shop:
- Ordine pagato — the Shopify
orders/paidwebhook lands. Alva creates the Purchase record and queues the order in the fraud queue. - Chiavi prenotate? No. Every linked key stays at status
AVAILABLEin the pool. NoPurchaseLicenseKeyrow exists yet. - Approvi — Alva picks the oldest available keys from the linked tag, marks them
ASSIGNED, attaches them to the purchase, and emails the customer. - Pool vuoto al momento dell'approvazione? Alva creates a
PendingLicenseKeyAssignmentrecord. The next CSV upload fills pending orders in FIFO order and emails customers automatically. - Rifiuti — nessuna chiave viene mai assegnata. Il pool è invariato. L'ordine non riceve email di download.
Cosa vedrai nell'admin
The order detail page shows the fraud-pending status in the License keys section. The license key status API returns pending_fraud_check with the message "Order is pending verification" while the order sits in the queue. The home dashboard surfaces a Approvazioni antifrode in attesa count so held orders don't get forgotten.
Pagina di dettaglio ordine nell'admin di Alva per un ordine in coda antifrode. Mostra la sezione Chiavi di licenza che mostra lo stato "in attesa di verifica", con i pulsanti Approva e Rifiuta visibili sopra. Nessun dato cliente reale visibile.
Cosa vedono i clienti
La pagina ordine Shopify del cliente mostra l'ordine come pagato — Alva non blocca il checkout di Shopify. Il cliente non riceve un'email di download e nessuna chiave appare sulla pagina dello stato ordine o sulla pagina account cliente. All'approvazione, Alva invia l'email di consegna con la chiave assegnata. Al rifiuto, nessuna email è inviata e il merchant rimborsa l'ordine tramite Shopify.
Limitazioni
Gli ordini POS saltano del tutto la coda antifrode. Un prodotto digitale venduto a un terminale POS Shopify assegna la sua chiave di licenza e invia l'email di consegna immediatamente al momento della vendita. Il ragionamento: una vendita con carta presente è operativamente diversa (l'acquirente è fisicamente presente, chip-and-PIN è già stato eseguito), e forzare l'approvazione su ogni acquisto in negozio romperebbe l'esperienza alla cassa. Se il tuo shop vende prodotti con chiavi di licenza al POS e online, aspettati che le vendite POS consumino le chiavi istantaneamente mentre le vendite online aspettano l'approvazione.
FAQ
Posso assegnare una chiave a un ordine prima dell'approvazione antifrode?
Non mentre l'ordine è nella coda antifrode. Approva prima l'ordine, poi Alva assegna e invia per email la chiave automaticamente. Per saltare del tutto l'attesa, disabilita i controlli antifrode in Impostazioni — ogni ordine pagato riceverà allora la sua chiave immediatamente.
Cosa succede se finisco le chiavi al momento dell'approvazione?
Alva crea un record PendingLicenseKeyAssignment per l'acquisto. Non appena carichi più chiavi su quel tag, il primo ordine in attesa le rivendica per primo (FIFO) e il cliente viene avvisato per email automaticamente.
Questo si applica anche alle chiavi assegnate manualmente?
Sì. Ogni chiave che passa per Alva — assegnata in automatico, generata automaticamente o allegata manualmente — è trattenuta finché l'approvazione antifrode non è completata. L'eccezione sono gli ordini POS, che saltano del tutto la coda.
Vedi anche
È stato utile?
Ultimo aggiornamento 2026-05-06