Adyen gebruiken in Shopify

Adyen is een betalingsgateway voor Enterprise-ondernemingen om betalingen te accepteren. Merchants met een bestaand Adyen-account kunnen Adyen rechtstreeks binnen Shopify gebruiken als betalingsverwerker.

Je kunt Shopify, inclusief de betalingsgegevens van Adyen, integreren met je enterprise resource planning-software (ERP) om te zorgen voor soepeler gegevensbeheer en synchronisatie tussen je systemen.

Op deze pagina

Deelnamevereisten voor Adyen in Shopify

Voordat je Adyen in Shopify kunt gebruiken, moet je aan de volgende vereisten voldoen:

Je moet een Enterprise-abonnement hebben.
Je bedrijf moet voldoen aan specifieke deelnamevereisten op basis van je regio.
Je moet al een Adyen-account hebben ingesteld voordat je de integratie activeert.
Je winkel moet gebruikmaken van Shopify Checkout.

Toegang tot Adyen is alleen op goedkeuring en kan niet worden gegarandeerd. Neem contact op met je Shopify-vertegenwoordiger of Customer Success Manager (CSM) om Adyen-activering aan te vragen. Als je geen Customer Success Manager hebt, kun je contact opnemen met Shopify Support voor hulp bij de volgende stappen.

Niet-compatibele of niet-beschikbare functies voor Adyen in Shopify

Bepaalde functies zijn niet beschikbaar of incompatibel met de Adyen-integratie in Shopify:

Klarna en PayPal zijn niet beschikbaar: Klarna en PayPal worden niet ondersteund als betaalmethoden via de Adyen in Shopify-integratie.
Niet alle lokale betaalmethoden zijn beschikbaar: De lokale betaalmethoden (LPM's) die worden aangeboden via de Adyen in Shopify-integratie verschillen per regio en bevatten mogelijk niet alle methoden die Adyen rechtstreeks aanbiedt. Raadpleeg de documentatie over betaalmethoden van Adyen voor de volledige lijst.
Fraudetools van Shopify zijn niet beschikbaar: Bij gebruik van Adyen heb je geen toegang tot de fraudetools van Shopify Payments, zoals geschillenbeheer, bescherming tegen kaarttesten en fraude-analytics. Adyen biedt eigen tools voor fraudepreventie, die mogelijk tegen extra kosten beschikbaar zijn. Je kunt nog steeds de fraudeanalyse van Shopify en Shopify Flow gebruiken om aangepaste regels in te stellen.
Managed Markets wordt niet ondersteund: Managed Markets (merchant of record-service) vereist Shopify Payments en kan niet worden gebruikt met Adyen.
Handmatige betaalmethoden ondersteunen niet meerdere valuta: De functionaliteit voor meerdere valuta werkt alleen voor creditcards. Handmatige betaalmethoden zoals bankoverschrijving of rembours gebruiken standaard de winkelvaluta.

Adyen in Shopify activeren

Voordat je Adyen kunt activeren, moet je overleggen met je Shopify-vertegenwoordiger of Customer Success Manager om goedkeuring te krijgen. Nadat je goedkeuring hebt gekregen, stel je een account in bij Adyen. Vervolgens installeer en activeer je de betalingsapp.

Stappen:

Ga in het Shopify-beheercentrum naar Instellingen > Betalingen.
Klik in de sectie Shopify Payments op Beheren.
Klik op Overschakelen naar een externe provider en klik vervolgens nogmaals op Overschakelen naar een externe provider om te bevestigen.
Kies Adyen Payments - Credit Cards in de lijst met beschikbare betalingsproviders. Als je geen goedkeuring hebt om Adyen te gebruiken, wordt de optie Adyen Payments - Credit Cards niet weergegeven in de lijst met betalingsproviders.
Klik op Account beheren.
Sta de Adyen-betalingsextensie, indien nodig, toe om de gegevens van je winkel te openen en te wijzigen.
Selecteer op de pagina Adyen-betalingsconfiguratie het Adyen-account dat je wilt gebruiken voor je Shopify-winkel.
Volg de instructies in de Customer Area van Adyen om de Adyen-betalingsapp voor Shopify te installeren en je integratie te testen.

Adyen-instellingen configureren

Na het activeren van Adyen kun je de instellingen configureren op basis van je zakelijke behoeften.

Instellingen voor het vastleggen van betalingen configureren

Het vastleggen van betalingen bepaalt wanneer het geld wordt geïnd bij je klanten.

Stappen:

Ga in het Shopify-beheercentrum naar Instellingen > Betalingen.
Klik in de sectie voor betalingsproviders op Beheren.
Kies de gewenste methode voor vastleggen:
- Automatisch vastleggen: Betalingen worden direct vastgelegd wanneer de bestelling wordt geplaatst.
- Handmatig vastleggen: Betalingen worden geautoriseerd, maar pas vastgelegd wanneer je dit handmatig doet.
- Vastleggen bij afhandeling: Betalingen worden vastgelegd wanneer je de bestelling afhandelt.

Lokale betaalmethoden installeren

Om lokale betaalmethoden via Adyen aan te bieden, moet je eerst de app Adyen Payments - Credit Cards hebben geïnstalleerd als je primaire gateway. Als de creditcard-app niet is geïnstalleerd, kun je geen lokale betaalmethoden installeren.

Neem na het installeren van de creditcard-app contact op met je Customer Success Manager of Shopify-vertegenwoordiger om toegang te krijgen tot lokale betaalmethoden voor jouw regio.

Creditcard-termijnbetalingen voor Brazilië en Mexico configureren

Als je aan klanten in Brazilië of Mexico verkoopt, kun je termijnbetalingen met een creditcard aanbieden bij de checkout.

Voordat je termijnbetalingen configureert, controleer je of aan de volgende vereisten is voldaan:

Voor Brazilië moet je markt de valuta BRL (Braziliaanse real) gebruiken.
Voor Mexico moet je markt de valuta MXN (Mexicaanse peso) gebruiken.
De app Adyen Payments - Credit Cards moet zijn geïnstalleerd als je primaire gateway.

Stappen:

Ga in het Shopify-beheercentrum naar Instellingen > Betalingen.
Klik in de sectie Adyen Payments - Credit Cards op Beheren.
Klik op Meer acties en vervolgens op Beheren.
Voeg ?credit_card_installments=1 toe aan het einde van de URL in de adresbalk van je browser en druk vervolgens op Enter op je toetsenbord.
De configuratieopties voor termijnbetalingen worden onderaan de pagina weergegeven.
Configureer het maximale aantal termijnbetalingen en de minimale betaling per termijnbetaling. Voor Brazilië kunnen termijnbetalingen worden geconfigureerd van 2 tot 12 termijnbetalingen. Voor Mexico kunnen termijnbetalingen worden geconfigureerd in 3, 6, 9, 12 of 18 termijnbetalingen.
Klik op Opslaan.

Adyen gebruiken met Shopify Markets

Adyen is compatibel met Shopify Markets. Wanneer Shopify Markets is geactiveerd, worden transacties verwerkt in de valuta die Shopify naar Adyen verzendt.

Als je in meerdere valuta's wilt verkopen met Adyen, controleer je of aan de volgende vereisten is voldaan:

De valuta's van je markten moeten ook zijn geconfigureerd in je Adyen-account.
Als de valuta een van de afwikkelingsvaluta's van Adyen voor jouw regio is, wikkelt Adyen het bedrag in diezelfde valuta af.

Je integratie valideren met testbestellingen

Voordat je live betalingen gaat accepteren, test je de Adyen-integratie met conceptbestellingen om te bevestigen dat betalingen correct worden verwerkt.

Stappen:

Ga in het Shopify-beheercentrum naar Bestellingen > Concepten.
Klik op Bestelling aanmaken.
Voeg een product en klantinformatie toe.
Klik op Betaling innen en selecteer vervolgens je gewenste betaalmethode.
Voltooi het betalingsproces en controleer of de bestelling correct wordt weergegeven in zowel Shopify als je Adyen-portal.

Bestellingen reconciliëren bij gebruik van Adyen

Wanneer een bestelling wordt betaald via Adyen, verzendt Shopify een merchantReference-nummer naar Adyen voor de transactie. Het merchantReference-nummer is een unieke ID die je kunt gebruiken om bestellingen te reconciliëren.

Het merchantReference-nummer bestaat uit twee delen:

Shopify-winkel-ID: het eerste deel van het nummer identificeert je Shopify-winkel.
Betalings-ID: het tweede deel is de betalings-ID voor de specifieke transactie.

Het merchantReference-nummer kan bijvoorbeeld worden weergegeven als 12345-67890. In dit voorbeeld is 12345 de Shopify-winkel-ID en 67890 de betalings-ID.

De betalings-ID voor een transactie wordt weergegeven in de tijdlijn van de bestelling in het Shopify-beheercentrum.

Om transacties te reconciliëren, doorzoek je het Shopify-beheercentrum met behulp van het betalings-ID-deel van het merchantReference-nummer. De zoekfunctie retourneert de bestelling die is gekoppeld aan de betalings-ID.

Overwegingen voor het reconciliëren van bestellingen

Neem de volgende overwegingen door wanneer je de tijdlijn van de bestelling en de betalings-ID gebruikt om bestellingen te reconciliëren met transacties in Adyen:

De autorisatiesleutel van een bestelling vinden: de autorisatiesleutel wordt niet bijgewerkt op de tijdlijn van de bestelling in het Shopify-beheercentrum wanneer een transactie is voltooid via Adyen. Raadpleeg je Adyen-account om de autorisatiesleutel van een bestelling op te halen.
Betalingsstatus in behandeling: het kan meerdere dagen duren voordat betalingen zijn verwerkt. Als er geen reactie wordt ontvangen van de betalingsprovider, kunnen betalingen worden weergegeven als In behandeling. Wanneer de betalingsstatus verandert in Betaald, kun je de bestelling afhandelen.
Verlopen betalingsstatus: als de betalingsstatus verandert in Verlopen, controleer dan of de betaling niet is ontvangen in je Adyen-account voordat je de klant opnieuw om betaling vraagt. De betalingsstatus verandert in Verlopen om aan te geven dat het niet mogelijk was om de betaling te verwerken.

Veelvoorkomende problemen met Adyen oplossen

Als je problemen ondervindt met je Adyen-integratie, neem dan de volgende veelvoorkomende problemen en oplossingen door.

Problemen met de betalingsstatus in behandeling oplossen

Dit is verwacht gedrag voor lokale betaalmethoden, zoals AliPay en WeChat Pay. De betaling krijgt de status in behandeling totdat de betaling succesvol is bij de verwerker. Nadat de betaling is bevestigd, wordt de status bijgewerkt in zowel Adyen als Shopify.

Wat je kunt doen: wacht tot de betaling is verwerkt. De meeste betalingen worden binnen enkele minuten bijgewerkt, maar sommige kunnen 10 tot 15 minuten duren.

Problemen oplossen waarbij de klant heeft betaald, maar er geen bestelling in Shopify staat

Dit kan gebeuren als een klant een betaling start waarvoor 3D Secure-verificatie is vereist, maar het proces afbreekt of problemen ondervindt buiten de controle van Shopify.

Wat je kunt doen:

Controleer je Adyen-portal om te bevestigen dat de betaling is vastgelegd.
Als de betaling is vastgelegd, maak dan een conceptbestelling aan in Shopify.
Markeer de conceptbestelling als betaald en handel deze dienovereenkomstig af.
Als de betaling niet is vastgelegd, is er geen actie nodig.

Problemen oplossen waarbij er twee keer bij de klant is afgeschreven

Dit kan optreden wanneer een klant de 3D Secure-verificatie voltooit, maar niet correct wordt teruggestuurd naar Shopify. De klant ziet dan mogelijk twee autorisatiepogingen op het rekeningoverzicht.

Wat je kunt doen:

Controleer je Adyen-portal om te bepalen hoeveel betalingen er daadwerkelijk zijn vastgelegd.
Als er maar één betaling is vastgelegd, geef dan bij de klant aan dat de tweede afschrijving een in behandeling zijnde autorisatie is die automatisch wordt vrijgegeven door de bank.
Als er twee betalingen zijn vastgelegd, betaal dan de dubbele transactie terug in je Adyen-portal.

Problemen oplossen waarbij de bestelling is aangemaakt, maar de betaling is geweigerd

Als Adyen er langer dan verwacht over doet om een geweigerde betaling te verwerken, kan de betaling de status In behandeling krijgen en wordt de bestelling aangemaakt in Shopify.

Wat je kunt doen:

Controleer de betalingsstatus in zowel het Shopify-beheercentrum als je Adyen-portal.
Als de betaling is mislukt, kun je de bestelling annuleren of de klant opnieuw om betaling vragen.

Problemen met een afgebroken checkout waarbij de betaling is bevestigd in Adyen oplossen

Dit kan optreden wanneer een sessie van een lokale betaalmethode verloopt, maar de klant nog steeds was geautoriseerd in Adyen.

Wat je kunt doen:

Wacht 10 tot 15 minuten totdat de betalingsstatus is gesynchroniseerd tussen Adyen en Shopify.
Als de betaling wordt weergegeven als voltooid in Adyen, maar de bestelling na 15 minuten nog steeds niet is aangemaakt in Shopify, maak dan een conceptbestelling aan en markeer deze handmatig als betaald.

Problemen met de foutmelding 'App is niet beschikbaar voor installatie' oplossen

Deze fout geeft meestal aan dat je winkel niet voldoet aan de deelnamevereisten om Adyen te gebruiken.

Wat je kunt doen:

Controleer of je winkel een Enterprise-abonnement heeft.
Neem contact op met je Customer Success Manager (CSM) of Shopify-vertegenwoordiger om de geschiktheid en activering te bespreken.
Als je geen Customer Success Manager hebt, neem dan contact op met Shopify Support voor hulp bij de volgende stappen.

Problemen oplossen waarbij lokale betaalmethoden niet worden weergegeven bij de checkout

Als lokale betaalmethoden niet worden weergegeven voor je klanten, controleer je of aan de volgende vereisten is voldaan:

De app Adyen Payments - Credit Cards moet als je primaire gateway zijn geïnstalleerd. Zonder deze app kun je geen lokale betaalmethoden gebruiken.
Het bezorgadres van de klant moet zich bevinden in een regio waar de lokale betaalmethode beschikbaar is.
De checkoutvaluta moet worden ondersteund door de lokale betaalmethode.

Wat je kunt doen:

Controleer of de app Adyen Payments - Credit Cards is geïnstalleerd en actief is.
Controleer of je lokale betaalmethoden correct zijn geconfigureerd in je Adyen-account.
Test de checkout met een adres van een klant in de doelregio.

Problemen oplossen met creditcard-termijnbetalingen die niet worden weergegeven bij de checkout

Als creditcard-termijnbetalingen niet worden weergegeven voor klanten in Brazilië of Mexico, controleer dan of aan de volgende vereisten is voldaan:

Voor Brazilië moet de markt de valuta BRL (Braziliaanse real) gebruiken.
Voor Mexico moet de markt de valuta MXN (Mexicaanse peso) gebruiken.
De app Adyen Payments - Credit Cards moet als je primaire gateway zijn geïnstalleerd.
Termijnbetalingen moeten worden geactiveerd met de URL-parameter.
Er worden geen betaal-apps voor winkeltegoed en cadeaubonnen van derden gebruikt (deze zijn niet compatibel met termijnbetalingen).

Veelgestelde vragen

Kan ik Adyen gebruiken voor lokale betaalmethoden en een andere gateway voor creditcards?

Nee. Om lokale betaalmethoden met Adyen te verwerken, moet de app Adyen Payments - Credit Cards als je primaire gateway zijn geïnstalleerd. Adyen vereist deze configuratie en controleert het gebruik om gedeeltelijke integratie te voorkomen.

Kan ik de Adyen PSP Reference bekijken in mijn Shopify-beheercentrum?

Nee. De Payment Service Provider (PSP) Reference van Adyen wordt niet in Shopify opgeslagen. De Shopify-transactiereferentie wordt echter wel opgeslagen in het veld merchantReference in je Adyen-portal. Deze kun je gebruiken voor reconciliatie.

Is Adyen compatibel met abonnementen?

Ja, de Adyen-betaalapp ondersteunt abonnementen via abonnements-apps die met de Shopify Checkout zijn geïntegreerd. Als je bestaande abonnementen moet migreren naar Adyen, neem dan contact op met je Customer Success Manager (CSM) of de Shopify-vertegenwoordiger om de migratieopties te bespreken.

Ondersteunt Adyen Apple Pay en Google Pay?

Ja, Apple Pay (voor iOS) en Google Pay (voor Android) zijn beschikbaar via de Adyen-integratie.

Is Adyen compatibel met upsells na aankoop?

Ja, de Adyen-app ondersteunt upsells na aankoop via de checkout-extensie voor na aankoop. Raadpleeg de Shopify-ontwikkelaarsdocumentatie voor beperkingen en aandachtspunten voor checkout-extensies voor na aankoop.

Hoe migreer ik van de verouderde Active Merchant-integratie naar de nieuwe betaalapp?

De verouderde Adyen-gateway wordt niet meer ondersteund en kan betalingsproblemen veroorzaken. Als je nog steeds de verouderde Adyen-gateway gebruikt, moet je onmiddellijk migreren naar de nieuwe Adyen-betaalapp.

Neem contact op met Shopify Support of je Customer Success Manager voor begeleiding bij het migratieproces.

Voordat je contact opneemt met Shopify Support over Adyen

Voordat je contact opneemt met Shopify Support over een probleem met Adyen, is het handig om de volgende informatie te verzamelen om het probleem sneller te kunnen oplossen:

Het bestelnummer of de bestelnummers waar het probleem zich voordoet
De datum en tijd waarop het probleem is opgetreden
Schermafbeeldingen van foutmeldingen die je hebt ontvangen
De betalingsstatus die wordt weergegeven in zowel je Shopify-beheercentrum als je Adyen-portal
Het merchantReference-nummer van Adyen (indien van toepassing)
Een beschrijving van wat je had verwacht dat er zou gebeuren ten opzichte van wat er daadwerkelijk is gebeurd
Stappen uit het gedeelte voor probleemoplossing die je al hebt geprobeerd

Ondersteuning en bronnen voor Adyen

Als je weet met welk team je contact moet opnemen voor ondersteuning, verbetert dit je ervaring en krijg je sneller antwoord bij het gebruik van Adyen op Shopify.

Verantwoordelijkheden van Shopify Support

Voor hulp bij de Adyen-integratie op Shopify, waaronder hulp bij installatie, configuratie en probleemoplossing voor veelvoorkomende problemen, is Shopify Support je eerste aanspreekpunt. Shopify Support kan je helpen met de volgende soorten problemen:

Toegang aanvragen en de Adyen-betalingsgateway in Shopify activeren
Technische problemen met betrekking tot de Adyen-betalingsgateway op Shopify
Probleemoplossing voor integratieproblemen
Hulp bij het configureren en beheren van Adyen-instellingen binnen Shopify

Verantwoordelijkheden van Adyen Support

Neem voor problemen die specifiek zijn voor je Adyen-account rechtstreeks contact op met Adyen Support via support@adyen.com. Adyen Support verwerkt de volgende soorten vragen:

Accountverificatie en onboarding van merchants
Naleving van regelgeving
Prijsstelling en verwerkingstarieven
Uitbetalingsschema's, mislukte uitbetalingen en andere vragen die te maken hebben met uitbetalingen
Strategieën en tools voor fraudepreventie
Beheer van terugboekingen en geschillen
Gedetailleerde rapportage- en reconciliatievereisten

Bronnen

Raadpleeg de volgende bronnen voor meer informatie over Adyen en de integratie met Shopify: