Avant de commencer
Pour connecter Adyen, vous devez :
disposer dâun compte Adyen actif
avoir un accĂšs administrateur dans Sellsy
â
Ătape 1 : Activer Adyen dans Sellsy
2. Cliquez sur le bouton "Connecter" dans l'encadré Adyen
3. Cliquez ensuite sur "Connecter mon compte Adyen"
Ătape 2 : Configuration d'Adyen
Renseignez les informations demandées pour finaliser l'intégration d'Adyen et Sellsy.
Trouver la Clé API *
Rendez-vous sur Adyen dans le menu "Developers" > "API credentials" ou créez en une nouvelle si besoin :
1. Cliquez sur âCreate new credentialâ et conservez le type par dĂ©faut âWeb service userâ. Ajoutez une description si souhaitĂ© puis cliquez sur âCreate credentialâ.
2. Descendez dans "Server settings" puis cliquez sur âGenerate API keyâ et copiez la clĂ©.
3. Nâoubliez pas de cliquer sur âSave Changesâ.
Trouver la Clé HMAC *
Rendez-vous sur Adyen dans le menu "Developers" > "Webhooks" ou créez en un nouveau si besoin :
1. Cliquez sur le bouton â+ Webhookâ puis sur âAddâ de "Standard notification".
2. Positionnez le bouton on/off (en haut Ă droite) sur âEnabledâ.
3. Cliquez sur le bouton "modifier" de "Server configuration" et renseignez les champs demandés :
URL : webhook.sellsy.com/adyen_pay_by_link
Method (JSON) et SSL Version (TLSv1.2) puis cliquez sur âApplyâ.
4. Vous pouvez inclure/exclure des comptes marchands via le bouton "modifier" de "Merchant accounts" si besoin. Par défaut, Adyen prend tous les comptes marchands présents sur le compte.
5. Si nécessaire, dans "Security", ajoutez identifiant / password du serveur via le bouton "modifier" de "Basic authentication".
6. Cliquez sur le bouton "modifier" de "HMAC Key" puis sur le bouton âGenerateâ et copiez la clĂ©. Attention Ă bien la conserver car le cas Ă©chĂ©ant, il faudra la gĂ©nĂ©rer de nouveau. Cliquez sur âApplyâ.
7. Ajoutez une description si souhaitĂ© puis cliquez sur âSave changesâ.
Bon Ă savoir : Pour vĂ©rifier que votre paramĂ©trage est correct, cliquez sur âTest configurationâ en bas de votre page.
Sélecteur environnement *
Vous devez choisir entre "Production" (sélectionné par défaut) et "Test". Cela correspond aux deux environnements live et test proposés par Adyen (visible dans la popup de connexion de leur interface).
Préfixe URL API *
Ce champ nâapparaĂźt que si le sĂ©lecteur dâenvironnement est positionnĂ© sur âProductionâ. Il faut Ă©galement le rĂ©cupĂ©rer depuis lâinterface Adyen, dans "Developers" > "API URLs".
Il correspond au prĂ©fixe que lâon peut retrouver Ă la place des rectangles rouges sur lâĂ©cran ci-dessous.
Identifiant du compte marchand *
Il contient lâidentifiant du compte marchand Adyen que lâon veut associer aux liens de paiement gĂ©nĂ©rĂ©s. Il est visible dans "Settings" > "Merchant account".
Identifiant du thĂšme
Câest un champ non obligatoire qui permet dâutiliser le thĂšme de son choix prĂ©alablement créé dans Adyen. Sinon, câest le thĂšme par dĂ©faut du compte qui est utilisĂ©.
Pour le récupérer, rendez-vous dans "Pay by Link" > "Themes" puis cliquez sur le bouton à 3 points du thÚme voulu et faites "Copy theme ID".
Pour créer un nouveau thÚme :
1. Cliquez sur âCreate a new themeâ, puis choisissez un nom de thĂšme et un display name (qui sera le nom affichĂ© au client).
2. Choisissez un logo, une image de fond et une couleur de fond (qui remplacera lâimage si elle ne peut ĂȘtre chargĂ©e).
3. Définissez-le ensuite comme thÚme par défaut, puis cliquez sur "Create".
Moyen de paiement associé à Adyen *
Ă ne pas confondre avec les moyens de paiements choisis dans Adyen, ce sera ici le moyen de paiement que lâon voudra associer cĂŽtĂ© Sellsy Ă un paiement gĂ©nĂ©rĂ© depuis un lien de paiement Adyen (peu importe le moyen de paiement qui aura Ă©tĂ© utilisĂ© via Adyen).
Les moyens de paiement disponibles ici seront ceux que lâon peut trouver dans "Menu" > "RĂ©glages" > "Catalogue" > "Tarifs et taxes", et celui sĂ©lectionnĂ© par dĂ©faut sera le premier de cette mĂȘme page.
Enregistrer
Une fois que lâon a renseignĂ© ces champs et cliquĂ© sur âEnregistrerâ, un appel vers Adyen (mĂ©thode POST /paymentLinks) sera automatiquement gĂ©nĂ©rĂ© pour crĂ©er un lien de paiement de test qui expirera aussitĂŽt. Cela permet de vĂ©rifier si lâensemble des champs renseignĂ©s (exceptĂ© la HMAC que lâon ne peut vĂ©rifier) sont corrects. Un message de notification confirmera alors lâenregistrement des paramĂštres.
Si lâenregistrement nâa pas fonctionnĂ©, dĂ» au fait quâau moins un des paramĂštres Ă©tait incorrect ou que le serveur Adyen Ă©tait indisponible, cela sera indiquĂ© via des messages dâerreur dans le module.
Il est Ă©galement obligatoire, dĂšs que lâon est en mode Production, de configurer ses termes et conditions depuis lâinterface Adyen, sur la page "Pay by Link" > "Settings".
Dâautres paramĂ©trages sont possibles depuis Adyen directement, notamment si lâon veut par exemple limiter le choix des moyens de paiement que lâon veut rendre disponible : "Settings" > "Payment methods".
Génération des liens de paiement
Une fois activĂ© et configurĂ©, Adyen Pay by Link est disponible dans les moyens de paiement que lâon peut proposer dans les prĂ©fĂ©rences du document.
Lorsque vous cliquez pour la premiÚre fois sur le lien public du document de vente, un lien de paiement sera généré.
La page de paiement, accessible via le bouton âPayer en ligneâ du lien public, sera disponible jusquâĂ 70 jours aprĂšs le clic sur le lien public et dans la langue de votre navigateur. Si le dĂ©lai restant avant expiration est infĂ©rieur Ă 24h, un nouveau lien de paiement est gĂ©nĂ©rĂ© et associĂ© au document.
Suivi du paiement
Si le paiement a fonctionnĂ©, Adyen vous envoie une confirmation. Vous pourrez alors ĂȘtre redirigĂ© vers la page de paiement.
Si le moyen de paiement utilisĂ© nâest pas dĂ©tectĂ© comme sĂ»r par Adyen, votre paiement sera en attente de confirmation. Vous devrez alors vous rendre sur Adyen pour accepter le paiement, dans la section "Risk" > "Case management".
En cliquant sur lâidentifiant visible dans la colonne "PSP reference", vous pouvez choisir dâaccepter ou refuser le paiement.




















