Integrér Adyen i Shopware 6: opsætning af betalingsudbyder

Én platform til kort, wallets som MobilePay, lokale betalingsmetoder og udbetalinger på markedspladser: Sådan installerer og konfigurerer du Adyen-pluginet i Shopware 6, opsætter webhooks og går sikkert live i Danmark.

Introduktion

Valget af betalingspartner har stor betydning for, om en webshop lykkes. Adyen tilbyder én global platform til betalingskort, wallets, lokale betalingsmetoder og udbetalinger til forhandlere på markedspladser. Denne guide tager webshopejere, udviklere og bureauer i Danmark gennem integrationen af Adyen i Shopware 6, fra den klassiske B2C-webshop til markedspladsmodeller med Adyen for Platforms. Du lærer:

• hvordan du installerer og konfigurerer det officielle Adyen-plugin,
• hvordan du opretter API-adgangsdata og skifter mellem test- og livetilstand,
• hvordan du aktiverer betalingsmetoder og tester dem grundigt, herunder MobilePay til danske kunder,
• hvordan du behandler asynkrone notifikationer via webhooks,
• hvordan du løser typiske fejl og går sikkert live,
• hvilke regler der gælder for sikkerhed, compliance og svindelbeskyttelse.

Hvilke andre udbydere du kan integrere, kan du se i vores oversigt over betalingsintegrationer til Shopware.

Hvad er Adyen?

Adyen er en betalingsplatform, som forhandlere bruger til at modtage betalinger online, i apps og i fysiske butikker. De vigtigste egenskaber:

• Globale og lokale betalingsmetoder: Visa, Mastercard, American Express, Apple Pay, Google Pay samt regionale metoder som MobilePay, iDEAL, SEPA Direct Debit, Klarna og mange flere.
• Hostede komponenter: Drop-in og Card Component indsamler betalingsdata på Adyens servere; dit PCI DSS-omfang reduceres til SAQ A.
• Tilbagevendende betalinger og tokenisering: abonnementer og genkøb via gemte tokens, uden at du selv behandler kortdata.
• Svindelbeskyttelse: RevenueProtect kombinerer risikoregler med maskinlæring; 3-D Secure 2 opfylder kravene til stærk kundeautentificering.
• Rapporter og analyser: godkendelsesrater, afregninger og data fra alle kanaler i ét backoffice.
• Markedspladser: Adyen for Platforms håndterer onboarding og KYC-kontrol af underforhandlere, opdeling af betalinger, tilbageholdelse og automatiske udbetalinger.

„Én integration, ét API, én platform“: For Shopware-forhandlere med internationale ambitioner er Adyen derfor et oplagt valg. For mindre webshops med fokus på Danmark er Stripe, PayPal eller Amazon Pay ofte det enklere valg. Uanset udbyder bør MobilePay og Dankort indgå i overvejelserne, fordi danske kunder forventer dem i checkout.

Forudsætninger

• Shopware 6.4 eller nyere, helst den aktuelle version; kontrollér plugin-versionens kompatibilitet
• PHP i den version, Shopware kræver, med udvidelserne cURL, JSON og OpenSSL
• SSL-certifikat (HTTPS) på shoppens domæne
• Adyen-testkonto med en sandbox-forhandlerprofil
• Adyen-adgangsdata til test og live:
  • Merchant Account (fx DinVirksomhedCOM)
  • API-nøgle til server-til-server-kald
  • Client-nøgle til frontend-komponenterne, med dit domæne som tilladt oprindelse
  • Webhook-adgangsdata: Basic Auth-bruger og -adgangskode samt HMAC-nøgle til kontrol af indgående notifikationer
• Shopware-konto til installation via administrationen (valgfrit)
• Adgang til filsystemet eller SSH til installation med Composer og til logs

Installér Adyen-pluginet

Der er tre muligheder: via administrationen, med Composer eller som manuel upload.

Via administrationen

1. Åbn Udvidelser → Store.
2. Søg efter „Adyen“, og vælg det officielle plugin „Adyen Payments for Shopware 6“.
3. Tilføj det, og klik på Installér under Udvidelser → Mine udvidelser.
4. Aktivér pluginet, og ryd cachen, så de nye betalingsmetoder vises.

Med Composer

cd /sti/til/shopware
composer require adyen/adyen-shopware6
bin/console plugin:refresh
bin/console plugin:install --activate AdyenPaymentShopware6
bin/console cache:clear

Det præcise tekniske navn kan du se med bin/console plugin:list.

Manuel upload

Download ZIP-filen fra Adyens GitHub-repository, og vælg filen under Udvidelser → Mine udvidelser → Upload udvidelse. Installér og aktivér som beskrevet ovenfor.

Efter aktiveringen finder du de nye betalingsmetoder under Indstillinger → Shop → Betalingsmetoder. Menunavnene kan variere en smule afhængigt af sprogindstillingen i din Shopware-administration.

Konfigurér pluginet

Åbn konfigurationen af Adyen-pluginet via udvidelsens kontekstmenu.

Grundindstillinger

• Miljø: først Test, senere Live.
• Merchant Account: navnet fra Adyen Customer Area; vær opmærksom på store og små bogstaver.
• API-nøgle (test/live): hemmelig nøgle til API-kald.
• Client-nøgle (test/live): offentlig nøgle til frontend-komponenterne.
• Live Endpoint Prefix: dit unikke præfiks til live-URL’en, fx abcd123-checkout-live.
• Webhook-bruger og -adgangskode: de Basic Auth-data, du har angivet for webhooken i Customer Area.
• HMAC-nøgle (test/live): til kontrol af webhook-signaturerne.

Gem; pluginet gemmer adgangsdataene i Shopware-konfigurationen.

Opsæt webhooks

1. Opret en standard-webhook i Customer Area under Developers → Webhooks.
2. Indtast den URL, som pluginet viser, og angiv Basic Auth-data og HMAC-nøgle.
3. Test webhooken fra Customer Area. Uden fungerende webhooks forbliver ordrer i Shopware på „åben“, selv om Adyen har godkendt betalingen.

Hvordan Shopware selv arbejder med webhooks, forklarer vi i vores artikel om webhooks i Shopware 6.

Valgfrie funktioner

• Adyen Giving: tilbyd donationer i checkout.
• Gemte betalingsmetoder: lad kunderne gemme kort til næste køb.
• Logoer for betalingsmetoder: hent dem automatisk fra Adyen, eller brug egne billeder.

Aktivér betalingsmetoder

1. Betalingsindstillinger i Shopware: Aktivér under Indstillinger → Shop → Betalingsmetoder Adyen-metoderne, fx kortbetaling, MobilePay, Klarna og gemte betalingsmetoder (den præcise betegnelse afhænger af sproget i administrationen).
2. Salgskanaler: Redigér hver storefront-kanal under Salgskanaler, og tilføj Adyen-metoderne i afsnittet om betalingsmetoder.
3. Adyen Customer Area: Under Account → Payment methods skal de ønskede metoder være aktiveret for din Merchant Account. Metoder, der er deaktiveret dér, vises ikke i checkout, uanset hvad der er indstillet i Shopware.

For danske webshops er MobilePay det vigtigste supplement til kortbetaling; ifølge Adyens dokumentation understøtter Shopware-pluginet MobilePay i Danmark og Finland. Dankort står ikke på listen over understøttede metoder i pluginet, så afklar med Adyen, hvordan Dankort og co-brandede Visa/Dankort-kort håndteres i din aftale.

Test checkout

Testbetalinger

1. Kontrollér, at miljøet i pluginet står på Test.
2. Læg en vare i kurven i storefronten, og vælg en Adyen-betalingsmetode i checkout.
3. Brug Adyens testkort, fx Visa 4111 1111 1111 1111 med en vilkårlig fremtidig udløbsdato og CVC 737. Kort til afvisninger, udløbne kort og 3-D Secure-forespørgsler finder du i Adyens dokumentation.
4. Gennemfør ordren. I administrationen vises den først som „åben“ eller „under behandling“ og skifter til „betalt“, så snart webhooken fra Adyen ankommer.

Særlige tilfælde

• Udløbet kort for at teste fejlhåndteringen.
• 3-D Secure-testkort for at teste autentificeringen.
• Metoder med viderestilling som MobilePay eller Klarna for at teste redirect og returnering til webshoppen.
• Refusion og annullering, så du sikrer, at også disse notifikationer kommer frem.

Detaljer finder du i logs under var/log/; pluginet skriver sin egen logfil.

Skift til live

1. Opret API-nøgle, client-nøgle, webhook-adgangsdata og HMAC-nøgle til livedrift i Customer Area for live.
2. Sæt miljøet i pluginet til Live, indtast live-adgangsdata og Live Endpoint Prefix, og gem.
3. Gennemfør en rigtig transaktion med et lille beløb, og kontrollér, at ordre og status er korrekte i Shopware.
4. Kontrollér afregning og webhook-leverancer i Adyens live-backoffice.

Best practices og sikkerhed

• PCI DSS: Brug hostede komponenter, så kortdata aldrig berører din server.
• HTTPS: Hele webshoppen kører via SSL.
• Administrér nøgler: Forny API- og HMAC-nøgler regelmæssigt, og gem dem i miljøvariabler eller et secret store.
• Svindelbeskyttelse: Aktivér RevenueProtect-regler og dynamisk 3-D Secure 2, og gennemgå markerede transaktioner regelmæssigt.
• Webhook-sikkerhed: Gennemtving HMAC-kontrol og Basic Auth, og tillad Adyens IP-intervaller på endpointet.
• Databeskyttelse: Udvid privatlivspolitikken med Adyens behandling af data i henhold til GDPR, og gem ikke selv følsomme data. Tilsynsmyndighed i Danmark er Datatilsynet.
• Opdateringer: Test plugin- og Shopware-opdateringer på staging først, og tjek release notes for breaking changes.
• Markedspladser: Ved Adyen for Platforms skal sælgernes KYC-data indsamles sikkert, udbetalinger afvikles server-til-server, og midler holdes adskilt.

Ofte stillede spørgsmål

Hvordan foregår refusioner?
I Adyens backoffice som delvis eller fuld refusion; webhooks opdaterer ordren i Shopware. I aktuelle plugin-versioner kan du også starte refusioner direkte fra ordrevisningen i Shopware, fx når en kunde benytter sin fortrydelsesret på 14 dage.

Koster pluginet noget?
Pluginet er gratis. Adyens transaktionsgebyrer (en procentsats plus et fast beløb) afhænger af din aftale og afregnes uden for Shopware.

Kan jeg opkræve gebyrer for betalingsmetoder?
Pluginet understøtter ikke gebyrer. I EU er gebyrer for almindelige kort- og SEPA-betalinger desuden ikke tilladt; tjek reglerne, inden du indfører gebyrer via en egenudvikling.

Hvilke ordrestatusser bruger Adyen?
Åben (betaling afventer), betalt (godkendelse gennemført), under behandling (asynkron betaling eller 3-D Secure i gang), fejlet eller afbrudt (afvist) og refunderet.

Kan jeg skifte nøgler uden nedetid?
Ja. Opret en ny nøgle hos Adyen, indtast den i plugin-konfigurationen, gem og test. Ændringen træder i kraft med det samme; vælg et tidspunkt med lav trafik.

Understøtter Adyen afbetaling?
Ja. Aktivér metoder som Klarna i din Merchant Account og derefter som betalingsmetode i Shopware.

Amazon Pay eller Adyen?
Amazon Pay passer, hvis dine kunder i forvejen bruger Amazon, og du vil have et hurtigt checkout med udfyldte data. Adyen er det stærkere valg for internationale forhandlere med høj volumen, lokale betalingsmetoder, afregning i flere valutaer og svindelbeskyttelse på tværs af flere webshops. Hvor dit checkout mister kunder, viser vores shopanalyse; til tilpasninger af betalingsflowet hjælper vi danske webshops med udvikling af Shopware-plugins.