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). Vous n'avez donc pas besoin de recréer un nouveau compte marchant.
Si cela ne correspond pas à votre choix ou à vos besoins, retourner à la page précédente pour choisir une autre option de configuration.
Clé API
La clé API utilisée pour configurer l'intégration Adyen ne peut pas être utilisée pour configurer l'intégration TPE et inversement. Chacune doit être distincte.
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 :
- Rendez-vous sur la page de connexion d'Adyen
- Sélectionnez Live
- Identifiez-vous
![how-to-adyen-1.png 1920](https://files.readme.io/f3a7b95-how-to-adyen-1.png)
Étape 1 : Récupérer l'URL d'API
- 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
![how-to-adyen-5.png 2702](https://files.readme.io/4a41c30-how-to-adyen-5.png)
- 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 e-mail à votre contact Alma (commercial ou customer success manager)
![how-to-adyen-12.png 2702](https://files.readme.io/40fbe98-how-to-adyen-12.png)
É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 :
- Depuis le dashboard Adyen :
- Allez dans Developers
- Puis dans API credentials
- Cliquez le bouton Create credential
![how-to-adyen-6.png 2702](https://files.readme.io/cd3150f-how-to-adyen-6.png)
- 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
![how-to-adyen-7.png 2376](https://files.readme.io/03eac88-how-to-adyen-7.png)
- 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
⚠️ 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 ⚠️ - Une fois l'API key conservée en lieu sûr, cliquez sur Saved Generated API Key et valider les confirmations.
![how-to-adyen-8.png 3816](https://files.readme.io/3ce541f-how-to-adyen-8.png)
![how-to-adyen-9.png 3816](https://files.readme.io/e2d1a68-how-to-adyen-9.png)
- 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
![how-to-adyen-10.png 4832](https://files.readme.io/ae6ce31-how-to-adyen-10.png)
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).
⚠️ 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 :
- Envoyez une demande d'activation de rôle PCI à Adyen :
- Téléchargez et complétez le document suivant : Lettre d'engagement
- Envoyez-le grâce au modèle d'e-mail situé ci-dessous à l'adresse suivante : [email protected]
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
- 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é.
![how-to-adyen-11.png 3816](https://files.readme.io/636b1b6-how-to-adyen-11.png)
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 e-mail à votre contact Alma (commercial et/ou customer success manager) et nous activerons l'intégration.
Updated over 2 years ago