Configurare Amazon Pay in Shopware 6: integrazione dei pagamenti passo dopo passo

Meno carrelli abbandonati grazie al pagamento con l’account Amazon: come installare e configurare Amazon Pay in Shopware 6, testare il checkout in sandbox e andare live in sicurezza nel Suo shop in Italia.

Introduzione

Amazon Pay è uno dei metodi di pagamento che nel checkout si spiegano quasi da soli: la maggior parte dei clienti ha un account Amazon e non deve quindi digitare né i dati della carta né l’indirizzo. Questo velocizza l’acquisto e riduce il tasso di abbandono, soprattutto da smartphone. Anche per gli shop in Italia è un’opzione da valutare accanto a PayPal, carte, Satispay e Scalapay.

Questa guida accompagna nell’intera configurazione in Shopware 6: account venditore, installazione del plugin, credenziali da Seller Central, notifiche (IPN), test in sandbox, go-live e gestione. È rivolta ai merchant che desiderano semplificare il checkout, agli sviluppatori incaricati di integrare Amazon Pay e alle agenzie che configurano metodi di pagamento per i clienti. Non servono conoscenze oltre all’amministrazione di Shopware.

Quali altri metodi di pagamento si possono collegare lo mostra la nostra panoramica sulle integrazioni di pagamento per Shopware.

Che cos'è Amazon Pay?

Amazon Pay è il servizio di pagamento di Amazon per gli shop esterni al marketplace Amazon. Nel checkout il cliente accede con il proprio account Amazon, sceglie indirizzo e metodo di pagamento già salvati e conferma l’acquisto. Il merchant riceve il pagamento tramite Amazon, con la Garanzia dalla A alla Z per l’acquirente.

Vantaggi per lo shop

• Checkout rapido: nessun modulo da compilare, indirizzo e metodo di pagamento arrivano dall’account Amazon.
• Fiducia: un fornitore noto con protezione per l’acquirente abbassa la soglia di diffidenza dei nuovi clienti.
• Meno abbandoni: soprattutto da mobile, dove i moduli lunghi fanno perdere acquisti.
• Più valute e paesi: Amazon Pay supporta i principali mercati europei, Italia compresa.

Per Shopware 6 Amazon mette a disposizione un plugin ufficiale che mostra il pulsante Amazon Pay nel carrello, nella pagina prodotto e nel checkout e sincronizza con lo shop pagamenti, rimborsi e cambi di stato.

Requisiti

Tecnica

• Versione di Shopware: Shopware 6.4 o successiva; la versione attuale del plugin è pensata per 6.5, 6.6 e 6.7. Verifichi la compatibilità nello Shopware Store.
• PHP: la versione richiesta dalla Sua versione di Shopware.
• Certificato SSL: obbligatorio. Senza un HTTPS valido Amazon Pay non funziona.
• Message queue: il worker deve essere attivo perché le notifiche di pagamento vengano elaborate.

Account venditore

Le serve un account venditore Amazon Pay dedicato, separato da un eventuale account venditore per il marketplace. Si registri con un indirizzo email dedicato sulla pagina di Amazon Pay per i venditori, inserisca dati aziendali, informazioni fiscali (per le aziende italiane la Partita IVA) e coordinate bancarie e attenda la verifica. Di norma richiede alcuni giorni lavorativi, quindi conviene muoversi per tempo.

Installare il plugin Amazon Pay

Dove trovarlo

Il plugin ufficiale „Amazon Pay“ è disponibile nello Shopware Store o direttamente nell’amministrazione.

Installazione passo dopo passo

1. Esegua un backup dello shop (database e file) prima di installare estensioni.
2. Acceda all’amministrazione di Shopware.
3. Apra Estensioni → Store e cerchi „Amazon Pay“.
4. Aggiunga l’estensione. Se l’ha già acquisita tramite il Suo account Shopware, la trova in Estensioni → Le mie estensioni pronta per il download.
5. Clicchi su Installa e attivi il plugin.
6. Dopo l’attivazione trova la configurazione nel menu contestuale dell’estensione e il metodo di pagamento in Impostazioni → Shop → Metodi di pagamento.

Configurare il plugin

Credenziali da Seller Central

1. In Shopware apra la configurazione dell’estensione Amazon Pay.
2. Acceda ad Amazon Seller Central (per l’Europa sellercentral-europe.amazon.com) con l’account venditore Amazon Pay.
3. Vada su Integration → Integration Central.
4. Come canale scelga „Sito web o dispositivo mobile“ e come piattaforma „Shopware 6“.
5. Copi Merchant ID e Store ID nella configurazione del plugin.
6. Con Create New Key Pair generi una coppia di chiavi. Scarichi il file .pem, lo apra con un editor di testo e copi l’intero contenuto nel campo Private Key in Shopware.
7. Riporti la Public Key ID da Seller Central.
8. Scelga la modalità: Sandbox per test senza pagamenti reali, Live per l’operatività.

Configurare le notifiche di pagamento (IPN)

1. La configurazione del plugin mostra un URL IPN per Sandbox e uno per Live. Copi quello corretto.
2. Lo inserisca in Seller Central in Integration → Impostazioni di integrazione come Merchant URL o endpoint IPN.
3. Salvi su entrambi i lati. Senza IPN Shopware non sa quando Amazon ha autorizzato, rifiutato o rimborsato un pagamento.

Attivare il metodo di pagamento

1. Apra Impostazioni → Shop → Metodi di pagamento e attivi Amazon Pay.
2. Assegni il metodo di pagamento ai canali di vendita desiderati.
3. Con le regole di disponibilità stabilisca in quali paesi e valute offrire Amazon Pay.

Altre impostazioni

• Pulsanti: mostri il pulsante Amazon Pay nel carrello e nelle pagine prodotto se desidera usare l’express checkout.
• Flusso di pagamento: scelga se addebitare subito gli importi o incassarli solo alla spedizione (autorizzazione con capture successivo).
• Regole: con il Rule Builder nasconde Amazon Pay per determinati gruppi clienti o valori del carrello.

Testare il checkout

Creare un account di test sandbox

1. In Seller Central apra Integration → Account di test (account sandbox).
2. Crei un account acquirente di test con un nuovo indirizzo email e una password.
3. Annoti le credenziali per gli ordini di prova.

Eseguire ordini di prova

1. Imposti il plugin su Sandbox.
2. Esegua i test in un ambiente di staging oppure nasconda il pulsante ai clienti reali durante il test.
3. Come farebbe un cliente, metta un articolo nel carrello, scelga Amazon Pay, acceda con l’account di test e completi l’ordine.
4. Nell’amministrazione, in Ordini, verifichi che ordine e transazione siano stati creati con lo stato di pagamento corretto.
5. Testi anche rimborso e annullamento, così da verificare che il riscontro via IPN funzioni.

Ricerca degli errori durante il test

Se qualcosa non va, consulti prima i log (Impostazioni → Sistema → Log) e filtri per Amazon Pay. Gli strumenti per sviluppatori del browser mostrano cosa accade durante il checkout. Se l’errore persiste, ricontrolli chiavi e impostazioni in Seller Central: basta un solo carattere sbagliato.

Risoluzione dei problemi

Problemi tipici

• L’autenticazione non riesce: verifichi che Merchant ID, Store ID, Private Key e Public Key ID siano completi e senza spazi.
• Problemi di connessione: il certificato SSL è valido? Il server blocca le richieste in uscita verso Amazon?
• Conflitti tra plugin: disattivi temporaneamente altri plugin di checkout o pagamento per circoscrivere il conflitto.
• Conflitti di versione: le versioni di Shopware e PHP devono rispettare i requisiti del plugin.
• Lo stato non si aggiorna: controlli l’URL IPN in Seller Central e verifichi che il worker della message queue sia attivo.

Controllare i log

In Impostazioni → Sistema → Log filtri per „Amazon Pay“. Presti attenzione ad autenticazioni non riuscite ed errori nelle notifiche.

Disservizi di Amazon

Se nulla funziona, verifichi in Seller Central o nel portale sviluppatori di Amazon Pay se è in corso un disservizio.

Go-live

1. Passi il plugin da Sandbox a Live e salvi.
2. Verifichi Merchant ID, Store ID e chiavi per l’ambiente live e l’URL IPN live in Seller Central.
3. Controlli paesi, valute e canali di vendita.
4. Esegua un vero ordine di prova con un importo ridotto e poi lo rimborsi.
5. Renda visibile Amazon Pay: logo nel checkout e nel footer, segnalazione nella newsletter o sui social network.

Best practice e sicurezza

Proteggere le credenziali

• Tratti Merchant ID, Store ID e chiavi come password: non le invii via email, le conservi solo nella configurazione del plugin o in un secret store.
• HTTPS sull’intero shop, non solo nel checkout.
• Backup regolari di database e file.

Monitorare le transazioni

• Controlli regolarmente la dashboard di Amazon Pay alla ricerca di transazioni anomale.
• Imposti notifiche per pagamenti rifiutati e chargeback.

Rimborsi e contestazioni

• Avvii i rimborsi direttamente dall’ordine in Shopware o in Seller Central in Amazon Pay → Transazioni. Per i consumatori in Italia ricordi il diritto di recesso di 14 giorni previsto dal Codice del Consumo.
• Rispetti le linee guida di Amazon sui rimborsi, così che clienti e valutazione del venditore non ne risentano.
• Risponda rapidamente alle contestazioni (Garanzia dalla A alla Z) con la prova di spedizione.

Domande frequenti

Amazon Pay non si collega. Cosa fare?
Verifichi Merchant ID, Store ID e chiavi, controlli il certificato SSL, cerchi eventuali disservizi in Seller Central e consulti i log di Shopware.

Quali commissioni si applicano?
Le commissioni dipendono dal paese e dal tipo di transazione, di solito una percentuale più un importo fisso per pagamento. Le condizioni aggiornate, secondo il fornitore, sono indicate in Seller Central.

Come funzionano i rimborsi?
Direttamente dall’ordine in Shopware, nella dashboard di Amazon Pay o tramite API. Informi il cliente non appena il rimborso è stato avviato.

Quali altri metodi di pagamento dovrei offrire?
Per il mercato italiano, oltre ad Amazon Pay, sono consolidati soprattutto PayPal, le carte di credito e di debito tramite un fornitore come Stripe, Satispay, il pagamento rateale con Scalapay e il bonifico bancario.

Desidera migliorare il checkout nel suo complesso? La nostra analisi dello shop mostra dove i clienti abbandonano. Seguiamo anche merchant in Italia e per adattamenti personalizzati del processo di pagamento La supportiamo con lo sviluppo di plugin per Shopware.