Amazon Pay instellen in Shopware 6: betaalintegratie stap voor stap

Minder afgebroken aankopen door betalen met het Amazon-account: zo installeert en configureert u Amazon Pay in Shopware 6, test u de checkout in de sandbox en gaat u veilig live.

Inleiding

Amazon Pay behoort tot de betaalmethoden die in de checkout bijna voor zich spreken: de meeste klanten hebben een Amazon-account en hoeven dus geen kaartgegevens of adres in te typen. Dat versnelt de aankoop en verlaagt het afhaakpercentage, vooral op de smartphone.

Deze gids begeleidt u door de volledige inrichting in Shopware 6: verkopersaccount, plugininstallatie, toegangsgegevens uit Seller Central, meldingen (IPN), test in de sandbox, go-live en beheer. Hij is bedoeld voor webshopeigenaren die de checkout willen vereenvoudigen, voor developers die Amazon Pay moeten integreren en voor bureaus die betaalmethoden voor klanten inrichten. Voorkennis buiten de Shopware-administratie hebt u niet nodig.

Welke betaalmethoden nog meer te koppelen zijn, ziet u in ons overzicht van Shopware-betaalintegraties.

Wat is Amazon Pay?

Amazon Pay is de betaaldienst van Amazon voor webshops buiten de Amazon-marktplaats. Klanten melden zich in de checkout aan met hun Amazon-account, kiezen daar opgeslagen adres en betaalmiddel en bevestigen de aankoop. De handelaar ontvangt de betaling via Amazon, inclusief A-tot-Z-garantie voor de koper.

Voordelen voor de webshop

• Snelle checkout: geen formulieren invullen, adres en betaalmiddel komen uit het Amazon-account.
• Vertrouwen: een bekende aanbieder met kopersbescherming verlaagt de drempel voor nieuwe klanten.
• Minder afhakers: vooral mobiel, waar lange formulieren tot afgebroken aankopen leiden.
• Meerdere valuta en landen: Amazon Pay ondersteunt de belangrijkste Europese markten.

Voor Shopware 6 biedt Amazon een officiële plugin die de Amazon Pay-knop in de winkelwagen, op de productpagina en in de checkout toont en betalingen, terugbetalingen en statuswijzigingen met de webshop afstemt.

Voorwaarden

Techniek

• Shopware-versie: Shopware 6.4 of nieuwer; de actuele pluginversie is bedoeld voor 6.5, 6.6 en 6.7. Controleer de compatibiliteit in de Shopware Store.
• PHP: de versie die uw Shopware-versie vereist.
• SSL-certificaat: verplicht. Zonder geldige HTTPS werkt Amazon Pay niet.
• Message queue: de worker moet draaien, zodat betalingsmeldingen worden verwerkt.

Verkopersaccount

U hebt een eigen Amazon Pay-verkopersaccount nodig, gescheiden van een eventueel verkopersaccount voor de marktplaats. Registreer u met een eigen e-mailadres op de Amazon Pay-pagina voor handelaren, voer bedrijfsgegevens, belastinginformatie en bankgegevens in en wacht de beoordeling af. Dat duurt doorgaans enkele werkdagen, regel het dus tijdig.

Amazon Pay-plugin installeren

Bron

De officiële plugin “Amazon Pay” vindt u in de Shopware Store of direct in de administratie.

Installatie stap voor stap

1. Maak een back-up van uw webshop (database en bestanden) voordat u extensies installeert.
2. Meld u aan in de Shopware-administratie.
3. Open Extensies → Store en zoek naar “Amazon Pay”.
4. Voeg de extensie toe. Hebt u deze al via uw Shopware-account aangeschaft, dan verschijnt ze onder Extensies → Mijn extensies om te downloaden.
5. Klik op Installeren en activeer de plugin.
6. Na de activering vindt u de configuratie via het contextmenu van de extensie en de betaalmethode onder Instellingen → Shop → Betaalmethoden.

Plugin configureren

Toegangsgegevens uit Seller Central

1. Open in Shopware de configuratie van de Amazon Pay-extensie.
2. Meld u aan bij Amazon Seller Central (voor Europa sellercentral-europe.amazon.com) met het Amazon Pay-verkopersaccount.
3. Ga naar Integratie → Integration Central.
4. Kies als kanaal “Website of mobiel apparaat” en als platform “Shopware 6”.
5. Kopieer Merchant ID en Store ID naar de pluginconfiguratie.
6. Genereer met Create New Key Pair een sleutelpaar. Download het .pem-bestand, open het in een teksteditor en kopieer de volledige inhoud naar het veld Private Key in Shopware.
7. Neem de Public Key ID over uit Seller Central.
8. Kies de modus: Sandbox voor tests zonder echte betalingen, Live voor de echte bedrijfsvoering.

Betalingsmeldingen (IPN) instellen

1. De pluginconfiguratie toont een IPN-URL voor sandbox en een voor live. Kopieer de juiste.
2. Voer deze in Seller Central onder Integratie → Integratie-instellingen in als Merchant URL of IPN-endpoint.
3. Sla aan beide kanten op. Zonder IPN weet Shopware niet wanneer Amazon een betaling heeft geautoriseerd, geweigerd of terugbetaald.

Betaalmethode activeren

1. Open Instellingen → Shop → Betaalmethoden en activeer Amazon Pay.
2. Wijs de betaalmethode toe aan de gewenste verkoopkanalen.
3. Leg via de beschikbaarheidsregels vast in welke landen en valuta Amazon Pay wordt aangeboden.

Overige instellingen

• Knoppen: toon de Amazon Pay-knop in de winkelwagen en op productpagina’s als u de express-checkout wilt gebruiken.
• Betalingsproces: kies of bedragen direct worden geïnd of pas bij verzending worden vastgelegd (autorisatie met latere capture).
• Regels: met de Rule Builder verbergt u Amazon Pay voor bepaalde klantgroepen of winkelwagenwaarden.

Checkout testen

Sandbox-testaccount aanmaken

1. Open in Seller Central Integratie → Testaccounts (sandbox-accounts).
2. Maak een testaccount voor kopers aan met een nieuw e-mailadres en wachtwoord.
3. Noteer de toegangsgegevens voor de testbestellingen.

Testbestellingen uitvoeren

1. Zet de plugin op Sandbox.
2. Test op een stagingomgeving of verberg de knop tijdens de test voor echte klanten.
3. Leg als klant een artikel in de winkelwagen, kies Amazon Pay, meld u aan met het testaccount en rond de bestelling af.
4. Controleer in de administratie onder Bestellingen of bestelling en transactie met de juiste betaalstatus zijn aangemaakt.
5. Test ook terugbetaling en annulering, zodat de terugkoppeling via IPN werkt.

Foutopsporing tijdens de test

Mislukt er iets, kijk dan eerst in de logs (Instellingen → Systeem → Logs) en filter op Amazon Pay. De ontwikkelaarstools van de browser tonen wat er tijdens de checkout gebeurt. Blijft de fout bestaan, controleer dan sleutels en instellingen in Seller Central nogmaals, één verkeerd teken is al genoeg.

Probleemoplossing

Typische problemen

• Authenticatie mislukt: Merchant ID, Store ID, Private Key en Public Key ID controleren op volledigheid en spaties.
• Verbindingsproblemen: is het SSL-certificaat geldig? Blokkeert de server uitgaande verzoeken naar Amazon?
• Pluginconflicten: andere checkout- of betaalplugins tijdelijk deactiveren om conflicten af te bakenen.
• Versieconflicten: Shopware- en PHP-versie moeten aansluiten bij de eisen van de plugin.
• Status wordt niet bijgewerkt: IPN-URL in Seller Central controleren en zorgen dat de message-queue-worker draait.

Logs controleren

Onder Instellingen → Systeem → Logs filteren op “Amazon Pay”. Let op mislukte authenticaties en fouten bij meldingen.

Storingen bij Amazon

Helpt niets, controleer dan in Seller Central of in het Amazon Pay-ontwikkelaarsportaal of er een storing is.

Go-live

1. Zet de plugin om van Sandbox naar Live en sla op.
2. Controleer Merchant ID, Store ID en sleutels voor de live-omgeving en de live-IPN-URL in Seller Central.
3. Controleer landen, valuta en verkoopkanalen.
4. Voer een echte testbestelling met een klein bedrag uit en betaal deze vervolgens terug.
5. Maak Amazon Pay zichtbaar: logo in de checkout en footer, vermelding in de nieuwsbrief of op sociale netwerken.

Best practices en beveiliging

Toegangsgegevens beschermen

• Merchant ID, Store ID en sleutels behandelen als wachtwoorden: niet per e-mail versturen, alleen opslaan in de pluginconfiguratie of een secret store.
• HTTPS voor de hele webshop, niet alleen voor de checkout.
• Regelmatige back-ups van database en bestanden.

Transacties bewaken

• Het Amazon Pay-dashboard regelmatig controleren op opvallende transacties.
• Meldingen instellen voor geweigerde betalingen en terugboekingen.

Terugbetalingen en geschillen

• Terugbetalingen direct vanuit de Shopware-bestelling of in Seller Central onder Amazon Pay → Transacties starten.
• De richtlijnen van Amazon voor terugbetalingen naleven, zodat klanten en verkopersbeoordeling er niet onder lijden.
• Geschillen (A-tot-Z-garantie) snel beantwoorden met verzendbewijs.

Veelgestelde vragen

Amazon Pay maakt geen verbinding. Wat nu?
Merchant ID, Store ID en sleutels controleren, SSL-certificaat nagaan, in Seller Central kijken naar storingen en de Shopware-logs lezen.

Welke kosten zijn er?
De kosten hangen af van land en transactietype, meestal een percentage plus een vast bedrag per betaling. De actuele voorwaarden staan in Seller Central.

Hoe werken terugbetalingen?
Direct vanuit de bestelling in Shopware, in het Amazon Pay-dashboard of via de API. Informeer de klant zodra de terugbetaling is gestart.

Welke andere betaalmethoden zou ik moeten aanbieden?
Voor de Duitse markt hebben zich naast Amazon Pay vooral PayPal, creditcard via een aanbieder als Stripe en betalen achteraf of in termijnen bewezen.

Wilt u uw checkout als geheel verbeteren? Onze shopanalyse laat zien waar klanten afhaken. Voor maatwerkaanpassingen aan het betalingsproces ondersteunen wij met Shopware-pluginontwikkeling.