Passer au contenu principal
Toutes les collectionsPilotez votre entreprisePaiements
Paiement en ligne des factures avec Adyen
Paiement en ligne des factures avec Adyen

Paramétrage du module Adyen sur Sellsy : activation, configuration et utilisation

Quentin avatar
Écrit par Quentin
Mis à jour il y a plus d'un an

Activation du module Adyen

Pour activer le module, rendez-vous dans Menu > Réglages > Module Sellsy et cliquez sur "Ajouter des modules".

Recherchez "Adyen Pay by Link" et activez le module.


Configuration

Rendez-vous ensuite dans Menu > Réglages > Module Externe, cliquez sur votre module Adyen Pay by Link puis renseignez les informations demandées.

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.

S’il y a un problème sur la génération du lien, un message d’information est affiché au client, sur la page du lien public du 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.

Avez-vous trouvé la réponse à votre question ?