GitHub

MaxMind: prevenzione frodi per Shopware 6
432285110 D37c88d5 0bdd 4ca9 Ba14 9d2a26cc988a

Inhaltsverzeichnis

Kostenlose 15-minütige Erstberatung direkt mit unseren Experten.

Kostenlose Beratung +49 421 438 1919-0

Introduzione

Il plugin MaxMind è uno strumento efficace che aiuta i titolari di negozi Shopware, anche in Italia, a riconoscere, prevenire e gestire le transazioni fraudolente. Grazie all’integrazione diretta con il servizio di fraud detection di MaxMind, il plugin valuta ogni ordine del negozio, analizza diversi fattori di rischio e genera un punteggio di rischio frode dettagliato. Questo punteggio consente ai merchant di individuare le transazioni potenzialmente sospette prima che vengano elaborate. Se a un ordine viene assegnato un punteggio di rischio elevato, il plugin lo contrassegna in automatico per un controllo approfondito, così il titolare del negozio può intervenire in via preventiva, ad esempio verificando i dati del cliente o contattandolo direttamente. Mettendo a disposizione queste informazioni direttamente nell’area di amministrazione di Shopware, il plugin permette ai merchant di prendere decisioni fondate in modo rapido ed efficiente.

Oltre alla valutazione del rischio in tempo reale, il plugin MaxMind contribuisce a ridurre chargeback, perdite economiche e interruzioni operative, rendendo automatico il processo di rilevamento delle frodi. Offre inoltre impostazioni configurabili per adattarsi a esigenze aziendali e volumi di transazioni diversi, ed è quindi adatto sia ai piccoli negozi online sia alle grandi piattaforme e-commerce. Con MaxMind i merchant in Italia trovano un partner affidabile che protegge il negozio e i clienti, rafforzando sicurezza e fiducia.

Funzionalità principali

Il plugin MaxMind offre un rilevamento frodi completo per i negozi Shopware: ogni ordine viene analizzato tramite il servizio MaxMind e riceve un punteggio di rischio dettagliato per valutare le possibili minacce. Gli ordini che superano una soglia di rischio predefinita vengono contrassegnati in automatico come «Fraud Review» per un controllo, così il titolare del negozio può prendere precauzioni prima di elaborare transazioni potenzialmente sospette. Grazie alla perfetta integrazione nel pannello di amministrazione, i merchant possono configurare le chiavi API, regolare le soglie di rischio e gestire le altre impostazioni direttamente in Shopware, mantenendo il pieno controllo sul rilevamento delle frodi.

Il plugin include anche il device tracking: integra nel negozio il JavaScript di MaxMind per riconoscere comportamenti anomali dei dispositivi che potrebbero indicare attività fraudolente. Per un monitoraggio semplice, tutti i punteggi di frode sono mostrati in modo chiaro nella griglia della panoramica ordini e nella vista di dettaglio dell’ordine, così i merchant vedono subito il livello di rischio di ogni singolo ordine. Il plugin MaxMind è pienamente compatibile con Shopware e supporta le versioni dalla 6.4 alla 6.6 oltre agli aggiornamenti futuri: una soluzione affidabile per gli ambienti Shopware attuali e futuri.

Per iniziare

  • Installazione e attivazione

1. Download

GIT

  • Clonare il repository del plugin:

  • Apra il terminale ed esegua il seguente comando nella directory di Shopware 6 dedicata ai plugin personalizzati (di norma custom/plugins/):

git clone https://github.com/solution25com/maxmind-fraud-prevention-shopware-6-solution25.git

Packagist 

composer require solution25/maxmind

2. Installare il plugin in Shopware 6

  • Acceda al pannello di amministrazione di Shopware 6.

  • Vada su Estensioni > Le mie estensioni.

  • Cerchi il plugin appena clonato e clicchi su Installa.

3. Attivare il plugin

  • Dopo l'installazione clicchi su Attiva per attivare il plugin.

  • Dopo l'installazione clicchi su Attiva per attivare il plugin.

  • Carichi o installi il plugin «MaxMind».

  • Dopo l'installazione sposti l'interruttore per attivare il plugin.

4. Verificare l’installazione

  • Dopo l'attivazione MaxMind compare nell'elenco dei plugin installati.

  • Nome, versione e data di installazione del plugin dovrebbero essere visualizzati come nello screenshot qui sotto.

432285237 3052ef31 11ef 4cb3 Ad68 D483343a8412

Configurazione del plugin

1. Aprire le impostazioni del plugin

  • Vada su Impostazioni > Sistema > Plugin.

  • Cerchi MaxMind e clicchi sull'icona con i tre puntini (...) o sul nome del plugin per aprire le impostazioni.

2. Impostazioni generali

Canale di vendita
Selezioni il canale o i canali di vendita in cui MaxMind deve essere attivo. Scegliendo «Tutti i canali di vendita», l’impostazione vale per ogni canale del negozio.

MaxMind Account ID
Inserisca l’Account ID fornito da MaxMind.

Chiave di licenza MaxMind
Inserisca la chiave di licenza del Suo account MaxMind.

Soglia di rischio (da 0 a 99)
Se il punteggio di rischio di un ordine supera questa soglia, lo stato dell’ordine viene impostato su Verifica frode.

3. Salvare la configurazione

  • Clicchi su Salva in alto a destra per memorizzare le impostazioni.

432285310 Bc5adf85 F999 4ea8 Bf1f 11bb32699b25

Come funziona

1. Il cliente effettua un ordine

  • Quando il cliente completa il checkout, il plugin invia i dati dell'ordine all'API di MaxMind per la valutazione del rischio frode.

2. Calcolo del punteggio di rischio

  • MaxMind restituisce un punteggio di rischio frode (da 0,01 a 99).

  • Se il punteggio supera la soglia da Lei definita, il plugin imposta in automatico lo stato dell'ordine su Verifica frode.

  • Se il punteggio è inferiore alla soglia, l'ordine viene contrassegnato in automatico come Frode superata.

  • Gli stati Aperto e Annullato non vengono più utilizzati in questo flusso.

3. Aggiornamento dello stato dell’ordine

  • Il campo Stato ordine in Shopware mostra Verifica frode quando il punteggio di rischio supera la Sua soglia.

  • Questo stato è visibile nella pagina di panoramica degli ordini.

Visualizzare e gestire gli ordini

1. Aprire gli ordini

  • Nell'amministrazione di Shopware clicchi su Ordini.

  • Vedrà l'elenco di tutti gli ordini con le colonne Stato ordine, Stato pagamento, Stato consegna e Punteggio di rischio frode.

2. Controllare il punteggio di rischio frode

  • Osservi la colonna Punteggio di rischio frode (%).

  • Gli ordini con un punteggio superiore alla soglia impostata compaiono con lo stato Verifica frode.

  • Gli ordini con un punteggio inferiore alla soglia vengono contrassegnati in automatico come Frode superata.

  • Gli stati Aperto e Annullato non vengono più utilizzati in questo flusso.

3. Modificare manualmente lo stato dell’ordine

  • Clicchi su un ordine per aprire la pagina di dettaglio.

  • Nella scheda Generale, dopo aver verificato i dettagli, può cambiare lo stato dell'ordine da Verifica frode a Frode superata o Frode non superata.

4. Panoramica ordini con Verifica frode e punteggio di rischio

432285389 B9e10a68 1737 48f7 Ac44 Df56c0ce080f

5. Pagina di dettaglio dell’ordine con le opzioni di stato

432285476 Aff82a0e B262 492d 9b2a D3464da14454

Best practice

Impostare una soglia adeguata

Una soglia troppo bassa (ad es. 0,1) può segnalare come sospetti molti ordini legittimi.

Una soglia troppo alta (ad es. 99) può lasciar passare ordini fraudolenti.

Monitorare gli ordini segnalati

Controlli sempre manualmente gli ordini contrassegnati come «Verifica frode».

Presti attenzione a dettagli sospetti, come indirizzi non coerenti o domini e-mail insoliti.

Mantenere aggiornate le credenziali

Verifichi che Account ID e chiave di licenza MaxMind siano validi.

Una chiave scaduta impedisce di recuperare i punteggi di rischio.

Mantenere aggiornato il plugin

Installi sempre l’ultima versione del plugin per garantire la compatibilità con le modifiche più recenti di Shopware e dell’API di MaxMind.

Risoluzione dei problemi

In caso di problemi con il plugin MaxMind, alcuni controlli ricorrenti aiutano a individuare la causa. Se non vengono mostrati punteggi di rischio, verifichi prima le credenziali MaxMind, cioè Account ID e License Key, e si assicuri che il plugin sia attivo per il canale di vendita corretto. Se gli ordini non cambiano stato, controlli che la soglia di rischio sia impostata correttamente e che non ci siano conflitti con altri plugin di gestione ordini. Se le impostazioni non vengono salvate, svuoti la cache di Shopware dopo il salvataggio e verifichi che i permessi dei file consentano le modifiche. Seguendo questi passaggi il plugin funziona correttamente e garantisce un rilevamento frodi accurato su tutti gli ordini. Per i merchant in Italia, solution25 offre supporto da remoto nella configurazione.

FAQ

1. Serve un account MaxMind?
Sì. Per il funzionamento del plugin servono un account MaxMind attivo e una chiave di licenza valida.

2. Posso limitare il plugin a determinati canali di vendita?
Sì. Nelle impostazioni del plugin può scegliere a quali canali applicarlo.

3. Che cosa succede agli ordini contrassegnati come «Verifica frode»?
Può controllarli e cambiarne manualmente lo stato in Frode superata o Frode non superata.

4. Il plugin gestisce in automatico rimborsi o chargeback?
No. Fornisce solo un punteggio di rischio frode e imposta lo stato dell’ordine. Rimborsi e chargeback vanno gestiti separatamente.

Documentazione Wiki

Scopra di più sulla configurazione del plugin nella nostra Wiki