Option 1 : Configuration avec un Settlement Details Report commun aux paiements Alma et Adyen

Si vous vous trouvez sur cette page, cela signifie que vous avez choisi l'option 1 - Configuration avec un Settlement Details Report commun aux paiements Alma et Adyen :

  • Vos transactions Alma et Adyen apparaîtront dans le même Settlement Details Report
  • Vous utiliserez un compte marchand Adyen existant (merchantAccount) :
  • Une validation par Adyen sera nécessaire à l'étape 2, celle-ci peut prendre plusieurs jours

Si cela ne correspond pas à votre choix ou à vos besoins, retourner à la page précédente pour choisir une autre option de configuration.

Avant de commencer la configuration

Munissez-vous de droits d'accès admin Adyen

  • Il est nécessaire d'avoir des accès admin au dashboard Adyen afin de configurer cette intégration.

Connectez-vous à votre dashboard Adyen

Vous devez vous connecter dans votre environnement Live, pour cela :

Étape 1 : Récupérer l'URL d'API

  1. Assurez-vous d'être sur le compte marchand (merchantAccount) auquel vous voulez rattacher les transactions Alma, pour cela :
    • Cliquez sur le logo Adyen en haut à gauche de votre écran : le compte actuel apparaît en haut de la fenêtre contextuelle
    • S'il ne s'agit pas du bon compte, cliquez sur le bon parmi les autres comptes situés en dessous

  1. Pour récupérer l'URL d'API, vous devez :
    • Aller dans Developers
    • Puis dans API URLs
    • À la ligne Checkout API, récupérer l'URL du service qui finit par payments

Cette URL d'API est un élément à envoyer par mail à votre contact Alma (commercial ou customer sucess manager)

Étape 2 : Créer un Webservice user avec une clé d'API associée et activer le rôle PCI

1) Créer un Webservice user avec une clé d'API associée :

  1. Depuis le dashboard Adyen :
    • Allez dans Developers
    • Puis dans API credentials
    • Cliquez le bouton Create credential

  1. Dans l'écran User Account Details qui apparaît :
    • Ajoutez une note (ex : Intégration Alma). Il sera plus simple de savoir à quoi correspond la clé plus tard, car Adyen ne permet pas de nommer le Credential.
    • Cliquez sur Save en bas de la page

  1. Maintenant que le Webservice User est créé et sauvegardé :
    • Restez sur la même page, dans la section "Authentication → API"
    • Cliquez sur Generate new API Key
      :warning: Attention : il faut bien copier la valeur et la stocker avec précaution car il sera ensuite impossible de la récupérer. Le seul moyen sera de générer une nouvelle clé, ce qui interrompra le service d'intégration :warning:
    • Une fois l'API key conservée en lieu sûr, cliquez sur Saved Generated API Key et valider les confirmations.

  1. Toujours sur la même page, dans la section Roles and Associated Accounts :
    • Cliquez sur Accounts, ensuite désactivez tous les comptes et gardez actif uniquement le compte marchand choisit pour l'intégration
    • Cliquez sur Save en bas de la page

2) Activer le rôle PCI Adyen :

Le rôle PCI est désactivé par défaut par Adyen. Lorsque celui-ci est activé cela signifie : soit que l’acteur concerné est PCI-DSS compliant, soit que l’usage ne relève pas de la certification PCI-DSS (ce qui est le cas de cette intégration).
:warning: Adyen doit activer le rôle PCI sur le Web Service User précédemment créé, cette activation peut prendre plusieurs jours. Suivez ces étapes afin d'activer ce rôle :

  1. Envoyez une demande d'activation de rôle PCI à Adyen :

📘

Template demande d'activation rôle PCI Adyen

Object : ALMA integration : PCI role activation

Dear Support,

We would like to have activate Alma indirect integration.
Could you therefore please enable the PCI role for **the following ws-user [préciser le WebService User sous ce format : ws_XXXXX] under the merchant account [préciser le nom du compte Marchand]** in production.
Please, find attached a commitment letter certifying that this web service user will only be used in the indirect integration with Alma.

Thanks

  1. Une fois la demande validée par Adyen :
    • Dans Developers → API credentials, cliquez sur le Credential créé au point précédent
    • Dans la section "Roles and Associated Accounts", vérifiez que "API PCI Payments role" soit bien activé.

Envoi des informations à Alma

Vous avez configuré l'intégration et recueilli les 3 informations nécessaires à Alma pour activer l'intégration :

  • Le nom du MerchantAccount (compte marchand) utilisé pour l'intégration
  • L'URL d'API utilisée
  • La clé d’API associée au Webservice User

Vous pouvez dès à présent envoyer toutes ses informations par mail à votre contact Alma (commercial et/ou customer success manager) et nous activerons l'intégration.


Did this page help you?