Passer au contenu principal

Activer le paiement en ligne avec Adyen

Ce guide explique comment connecter Adyen Ă  Sellsy afin de permettre Ă  vos clients de payer leurs factures par carte bancaire.

Mis à jour aujourd’hui


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.

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