Integrazione di pagamento BlueSnap per Shopware 6

BlueSnap è una piattaforma globale di payment orchestration che permette un’elaborazione dei pagamenti sicura e versatile direttamente nello store Shopware 6. Con il plugin BlueSnap per Shopware 6 sviluppato da solution25, i merchant possono accettare carte di credito e di debito, wallet digitali (Apple Pay, Google Pay) e metodi di pagamento locali tramite un’unica integrazione. Questa soluzione all in one include protezione integrata dalle frodi (3D Secure e Kount Risk Management) e aggiornamenti degli ordini in tempo reale, offrendo un checkout rapido e sicuro senza grande sforzo. In qualità di partner ufficiale Shopware, BlueSnap porta nell’admin di Shopware link di pagamento ospitati, dati dei clienti salvati (tokenizzazione) e il supporto ai wallet mobili.

La piattaforma BlueSnap è pensata per l’e-commerce globale: consente di vendere in oltre 200 aree geografiche con acquiring locale delle carte in 50 Paesi, per massimizzare i tassi di autorizzazione, evitare commissioni superflue e offrire i metodi di pagamento e le valute preferiti dai clienti. Con un solo account BlueSnap si raggiungono clienti in tutto il mondo, senza più account merchant. Per i merchant italiani che vendono all’estero è un modo semplice per gestire valute e metodi di pagamento internazionali. Il plugin per Shopware si installa in pochi minuti ed è facile da usare anche per chi non è tecnico, mentre gli sviluppatori beneficiano di codice open source, API e webhook. BlueSnap rende i pagamenti in Shopware 6 rapidi, sicuri e semplici.

• Checkout rapido e sicuro

Il checkout ospitato di BlueSnap offre una pagina di pagamento conforme PCI e ottimizzata per tutti i dispositivi. La pagina ospitata riduce al minimo il perimetro PCI e supporta l’autenticazione 3D Secure per ridurre frodi e chargeback.

• Più metodi di pagamento

Accetti le principali carte di credito e di debito, Apple Pay, Google Pay, Click to Pay, PayPal, ACH/ECP, BECS Direct Debit e altro ancora. I clienti hanno più flessibilità nella scelta del pagamento, con un effetto positivo sul tasso di conversione.

• Protezione dalle frodi integrata BlueSnap integra strumenti antifrode in tempo reale (inclusa una partnership con Kount) per verificare automaticamente le transazioni. Attivando 3D Secure si autenticano inoltre i titolari delle carte e si bloccano gli addebiti non autorizzati. Queste funzioni si gestiscono con semplici caselle di controllo nelle impostazioni del plugin.
• Clienti salvati (tokenizzazione) Permetta ai clienti di salvare le proprie carte in modo sicuro per acquisti futuri. Il plugin BlueSnap offre la funzionalità “Vaulted Shopper”, con cui gli acquirenti possono aggiornare o eliminare le carte salvate nel proprio account. I token di pagamento salvati velocizzano i checkout successivi e supportano gli ordini ricorrenti (abbonamenti).
• Sincronizzazione immediata degli ordini Gli stati di pagamento (autorizzato, incassato, rimborsato, chargeback ecc.) vengono sincronizzati automaticamente tra BlueSnap e Shopware. Dettagli dell’ordine e ID transazione si aggiornano in tempo reale, così può gestire gli ordini direttamente nell’admin di Shopware senza riconciliazioni manuali. I webhook (ad esempio gli eventi CHARGE e CHARGEBACK) gestiscono questi aggiornamenti in background.
• Supporto multivaluta globale Elabori vendite in oltre 100 valute e riceva i pagamenti nella valuta desiderata. Il routing intelligente dei pagamenti di BlueSnap utilizza banche acquirer locali in tutto il mondo per aumentare i tassi di approvazione, anche nelle transazioni transfrontaliere. Il risultato: più vendite internazionali per il Suo store Shopware.
• Admin intuitivo Gestisca tutte le impostazioni BlueSnap nella consueta interfaccia admin di Shopware 6. Il plugin include una pagina di configurazione guidata per le credenziali API, e i metodi di pagamento si attivano per ogni canale di vendita con pochi clic. Anche gli utenti non tecnici possono controllare tutto comodamente dalla dashboard.
• Pensato per gli sviluppatori Per gli utenti tecnici, BlueSnap offre API, SDK e documentazione completi. Il codice del plugin (di solution25) è disponibile come open source su GitHub e può essere personalizzato. BlueSnap mette a disposizione una REST API completa e opzioni di campi/checkout ospitati, se serve un’integrazione più profonda. Documentazione dettagliata per sviluppatori e un ambiente sandbox consentono di testare ogni scenario.

cd custom/plugins

git clone https://github.com/solution25com/bluesnap payment shopware 6 solution25.git

• Svuoti poi la cache e ricostruisca l’elenco dei plugin (bin/console plugin:refresh). Dovrebbe vedere “BlueSnap” in Estensioni > Le mie estensioni.
• Attivare il plugin: nell’admin di Shopware 6 vada su Estensioni > Le mie estensioni, cerchi il plugin BlueSnap e clicchi su Installa. Poi porti l’interruttore su Attiva. Un interruttore blu (acceso) indica che il plugin è attivo.
• Inserire le credenziali API di BlueSnap: apra le impostazioni del plugin in Impostazioni > Sistema > Plugin (clicchi sui tre puntini … o sul nome del plugin). Nella scheda “Generale” scelga l’ambiente (Sandbox o Live) e inserisca:
• API Key Live e API Password Live (dal Suo account BlueSnap di produzione)
• Merchant ID (MID) del Suo account BlueSnap
• API Key Sandbox e API Password Sandbox (dal Suo account BlueSnap sandbox).
• Copi questi valori esattamente dal Suo account BlueSnap. Le credenziali sandbox Le permettono di eseguire transazioni di prova senza denaro reale. Vedi screenshot: impostazioni del plugin BlueSnap, che mostra dove inserire queste chiavi.
• Attivare 3D Secure e vaulting: nel plugin attivi l’opzione 3DS per abilitare 3D Secure sui pagamenti con carta di credito. (Nota: 3D Secure va prima attivato nelle impostazioni del Suo account BlueSnap.) Attivi inoltre Salva carta in “Vaulted Shopper”, così i clienti possono salvare le carte nel proprio account. Clicchi su Salva per applicare le modifiche.
• Assegnare i metodi di pagamento: vada su Impostazioni > Negozio > Metodi di pagamento e verifichi che il metodo “BlueSnap” sia attivo e assegnato ai canali di vendita corretti. Configuri nome visualizzato e descrizione a piacere. BlueSnap può essere impostato come opzione predefinita per le carte di credito. Vedi screenshot: metodi di pagamento Shopware per un esempio di configurazione.

Seguendo questi passaggi, BlueSnap è completamente integrato nel Suo store Shopware 6. Il plugin aggiunge automaticamente “BlueSnap” come opzione di pagamento al checkout e gestisce senza interruzioni il reindirizzamento alla pagina di pagamento sicura ospitata da BlueSnap.

Amministrazione e utilizzo semplici

Una volta installato, il plugin BlueSnap per Shopware è pensato per un uso semplice. Nell’admin di Shopware può gestire tutti i pagamenti BlueSnap come qualsiasi altro ordine:

• • • Checkout del cliente: nella pagina di checkout del Suo negozio i clienti vedono BlueSnap accanto alle altre opzioni di pagamento. Selezionandolo, vengono reindirizzati a una pagina sicura ospitata da BlueSnap per inserire i dati di pagamento. La pagina è ottimizzata per mobile e desktop e offre un’esperienza fluida.
    • Metodi di pagamento salvati: se ha attivato la funzione “Salva carta”, i clienti registrati possono salvare la carta di credito per ordini futuri. In seguito possono gestire o eliminare queste carte nell’area del proprio account, con più comodità e trasparenza nei pagamenti ricorrenti.
    • Gestione degli ordini: dopo il pagamento, lo stato dell’ordine in Shopware si aggiorna automaticamente in base alla risposta di BlueSnap (ad esempio “Pagato” o “Rimborsato”). I dettagli della transazione (ID di autorizzazione, importi rimborsati, chargeback ecc.) sono visibili direttamente nella schermata di modifica dell’ordine. La sincronizzazione immediata dello stato di pagamento mantiene aggiornati i dati del backend senza controlli manuali.
    • Reporting e dashboard: le transazioni BlueSnap compaiono anche nei report di vendita di Shopware. Usi gli strumenti di reporting di Shopware per filtrare le vendite per metodo di pagamento (BlueSnap) o verificare i ricavi nelle diverse valute. Il BlueSnap Merchant Portal offre analisi avanzate e informazioni sui pagamenti ricevuti, se servono approfondimenti.

Nel complesso non serve una formazione specifica: gestori del negozio e collaboratori possono gestire i pagamenti BlueSnap dalla familiare interfaccia di Shopware. Se necessario, nel BlueSnap Merchant Portal può consultare in qualsiasi momento dati e report più dettagliati sulle transazioni.

Risorse per sviluppatori

Per gli sviluppatori, BlueSnap offre un toolkit solido per personalizzare ed estendere l’integrazione con Shopware:

• • • Codice open source del plugin: il plugin BlueSnap (di solution25) è disponibile come open source su GitHub. Può esaminare o adattare il codice per realizzare workflow personalizzati, ad esempio sovrascrivere template, estendere le condizioni di pagamento o integrare il plugin con altre estensioni Shopware.
    • API e webhook: la REST API di BlueSnap offre il pieno controllo su pagamenti, rimborsi, abbonamenti e altro. Il plugin copre il flusso standard, ma gli sviluppatori possono usare l’API per funzioni avanzate o integrazioni di terze parti. Il plugin resta in ascolto dei webhook BlueSnap come CHARGE e CHARGEBACK per mantenere Shopware sincronizzato; se necessario può gestire questi eventi anche nel proprio codice o nei propri plugin.
    • Test in sandbox: BlueSnap mette a disposizione un ambiente sandbox per sviluppo e QA. Usi le credenziali sandbox inserite nel plugin per simulare transazioni senza carte reali. Così può testare gestione degli errori, flussi 3DS e rimborsi.
    • Sicurezza e compliance: le librerie e i campi ospitati di BlueSnap rispettano elevati standard di sicurezza. Gli sviluppatori devono assicurarsi che sul sito Shopware sia attivo l’SSL (BlueSnap richiede HTTPS per i frame incorporati). Eviti di registrare nei log o esporre le credenziali API nel codice: le conservi in modo sicuro nella configurazione del plugin.
    • Supporto di lingue e piattaforme: i servizi BlueSnap e il plugin supportano installazioni multilingua (Shopware può mostrare la pagina di pagamento in 29 lingue, italiano compreso). Il plugin è compatibile con Shopware 6.x su PHP 7.x/8.x (vedi requisiti Shopware). Per temi personalizzati o adattamenti dello storefront, la pagina di checkout ospitata può essere personalizzata tramite il Page Designer di BlueSnap.

Ulteriori informazioni sono disponibili nella documentazione per sviluppatori BlueSnap, con riferimenti API completi, esempi di codice e guide all’integrazione. La combinazione di plugin Shopware e API BlueSnap offre al Suo team di sviluppo una base flessibile per qualsiasi soluzione di pagamento avanzata.

Best practice

Per ottenere il massimo dall’integrazione BlueSnap con Shopware, segua queste best practice:

• • • Testare prima in modalità sandbox: per i primi test usi sempre l’ambiente sandbox di BlueSnap. Verifichi che checkout, rimborsi e webhook funzionino come previsto prima di passare alla modalità live.
    • Attivare 3D Secure: attivi 3D Secure (3DS) sia nel Suo account BlueSnap sia nel plugin Shopware. 3DS aggiunge ai pagamenti con carta un ulteriore livello di autenticazione (ad esempio codici via SMS) e riduce sensibilmente le frodi.
    • Proteggere le chiavi API: mantenga segrete le credenziali API di BlueSnap. Non le inserisca in codice pubblico e non le condivida. Ruoti le chiavi se sospetta un incidente. Inserisca le chiavi solo nell’interfaccia admin protetta di Shopware.
    • Comunicare il salvataggio della carta: se offre pagamenti con carte salvate (Vaulted Shopper), informi i clienti che la carta può essere salvata in modo sicuro. Fornisca link chiari per gestire o eliminare le carte salvate nell’area account.
    • Monitorare le transazioni: controlli regolarmente il BlueSnap Merchant Portal e i log degli ordini Shopware per individuare transazioni non riuscite o segnalate. Intervenire rapidamente su contestazioni o rifiuti riduce le perdite di fatturato.
    • Mantenere aggiornato il plugin: aggiorni il plugin BlueSnap non appena è disponibile una nuova versione. Gli aggiornamenti possono contenere miglioramenti di sicurezza, nuove funzioni o correzioni di compatibilità. Restare aggiornati garantisce un funzionamento senza intoppi.

Seguendo queste indicazioni, il flusso di pagamento BlueSnap in Shopware è sicuro, affidabile e ottimizzato sia per i Suoi clienti sia per la Sua azienda.

BlueSnap e altri gateway di pagamento a confronto

Come si posiziona BlueSnap rispetto ad altre soluzioni di pagamento come Stripe o PayPal? Ecco alcune caratteristiche distintive:

• • • • Copertura globale con un solo account: BlueSnap supporta la vendita in oltre 200 aree geografiche con i metodi di pagamento e le valute preferiti a livello globale, tutto tramite un unico account merchant. Stripe richiede account regionali separati per vendere a livello internazionale (ad esempio uno per gli USA e uno per l’UE). Questo rende BlueSnap più semplice per uno store Shopware globale: si integra una volta sola e si accettano pagamenti in tutto il mondo.
      • Ampie opzioni di pagamento: supporta carte di credito, PayPal, Apple Pay, Google Pay, Amazon Pay, Skrill e Alipay, tutto su un’unica piattaforma.

In sintesi, il vantaggio di BlueSnap sta nella flessibilità globale e nella gestione del rischio integrata in un’unica soluzione. Integra (o sostituisce) gateway come Stripe e PayPal aggiungendo più metodi di pagamento e strumenti avanzati, senza frammentare i Suoi processi.

Domande frequenti

• D: Serve un account BlueSnap per usare questo plugin? Sì. BlueSnap è il processore dei pagamenti in background. Deve registrarsi per un account merchant BlueSnap (live e sandbox) per ottenere le credenziali API (key, password, Merchant ID) e poter usare il plugin.
• D: Quali metodi di pagamento posso accettare? BlueSnap per Shopware supporta tutte le principali carte di credito e di debito, wallet digitali (Apple Pay, Google Pay, Click to Pay), molte opzioni di addebito diretto (ACH, SEPA ecc.) e PayPal e altri e-wallet tramite BlueSnap. Le opzioni esatte dipendono dalla configurazione del Suo account BlueSnap. Metodi diffusi in Italia come Satispay o Scalapay non sono citati tra quelli supportati: li verifichi direttamente con BlueSnap.
• D: Il plugin BlueSnap per Shopware è facile da installare? Sì. Può installarlo con un clic dallo Shopware Community Store oppure tramite Composer/Git clone. Non serve programmare; la configurazione avviene nell’interfaccia admin di Shopware (Impostazioni > Plugin). La procedura passo per passo è descritta sopra.
• D: Come ottengo le credenziali API di BlueSnap? Acceda al Suo account BlueSnap (o sandbox) e vada nelle impostazioni API. Lì può creare o copiare API Key e API Password e trovare il Suo Merchant ID (MID). Usi questi valori nella configurazione del plugin.
• D: Quali versioni di Shopware sono supportate? Il plugin è compatibile con Shopware 6 (incluse le versioni 6.4 e 6.5). Utilizza il sistema di plugin e i requisiti di sistema di Shopware. Si assicuri che la Sua installazione soddisfi i requisiti ufficiali di Shopware 6.
• D: I pagamenti vengono elaborati in modo sicuro? Assolutamente sì. BlueSnap è pienamente conforme PCI DSS. I dati dei clienti vengono raccolti nella pagina di checkout sicura e crittografata di BlueSnap, non sul Suo server. Può inoltre attivare 3D Secure per una sicurezza aggiuntiva. BlueSnap dispone di data center validati PCI e rispetta rigorosi standard di sicurezza.
• D: Posso gestire rimborsi e chargeback? Sì. Può effettuare i rimborsi dalla schermata dell’ordine in Shopware oppure nel BlueSnap Merchant Portal. Lo stato viene sincronizzato automaticamente con Shopware. In caso di chargeback, BlueSnap La avvisa tramite webhook e i dettagli della contestazione si gestiscono dal portale.
• D: BlueSnap supporta pagamenti ricorrenti e abbonamenti? La piattaforma BlueSnap supporta abbonamenti e pagamenti ricorrenti (con carte salvate o PayPal) tramite la sua Subscription API o AR Automation. Il plugin Shopware si concentra sui pagamenti singoli, ma i token di pagamento salvati possono essere usati tramite API per una logica di abbonamento personalizzata.

Suggerimenti per la risoluzione dei problemi

• • • Il plugin non compare: verifichi di aver inserito la cartella del plugin in custom/plugins e di aver eseguito bin/console plugin:refresh. Svuoti la cache e controlli Estensioni > Le mie estensioni.
    • Credenziali non valide: controlli API Key, password e Merchant ID. Si assicuri di usare le credenziali corrette per la modalità scelta (sandbox o live).
    • Errori 3D Secure: se si verificano errori 3DS, verifichi di aver prima attivato 3DS nel Suo account BlueSnap; altrimenti l’impostazione 3DS del plugin non funziona.
    • Pagamento rifiutato: controlli il motivo del rifiuto restituito da BlueSnap (fondi insufficienti, mancata corrispondenza AVS ecc.). Verifichi anche i codici di valuta e Paese: devono corrispondere alle impostazioni consentite nel Suo account BlueSnap.
    • Problemi con webhook o notifiche: se lo stato degli ordini non si aggiorna, controlli gli URL di callback/webhook nel Suo account BlueSnap e che siano raggiungibili. Si assicuri inoltre che il sito Shopware sia accessibile tramite HTTPS.
    • Problemi di stile o layout: la pagina ospitata da BlueSnap si può personalizzare dal portale BlueSnap. In Shopware, se il frame della pagina di pagamento appare strano, verifichi che il tema supporti il plugin e che non ci siano conflitti JS.
    • Messaggi di errore: controlli i log di Shopware (var/logs/) e i log API nel BlueSnap Merchant Portal. Possono fornire indicazioni utili (ad esempio una richiesta errata o problemi di autenticazione).

Se i problemi persistono, consulti la documentazione BlueSnap o si rivolga al supporto BlueSnap/solution25.

Inizi oggi stesso

L’integrazione BlueSnap per Shopware 6 è un modo efficace per aggiungere pagamenti sicuri e flessibili al Suo store e-commerce. Con il supporto a più metodi di pagamento, la protezione avanzata dalle frodi e una configurazione semplice, può migliorare le conversioni al checkout e la fiducia dei clienti. Vuole portare i pagamenti del Suo negozio Shopware a un livello superiore? Scarichi il plugin BlueSnap dallo Shopware Store e configuri il Suo account oggi stesso. Ulteriori informazioni sono disponibili sul sito di BlueSnap, oppure contatti il nostro team: supportiamo anche merchant in Italia.

Argomenti correlati

• Plugin di integrazione pagamenti Cybersource per Shopware
• Prevenzione frodi MaxMind
• Integrazione MaxMind per la prevenzione delle frodi