Configurer l'intégration Alma pour vos terminaux de paiement Adyen

Alma propose désormais d’effectuer vos paiements Alma directement sur vos terminaux de paiement Adyen, pour vous permettre d’offrir une expérience fluide en point de vente tout en capitalisant sur vos investissements en terminaux de paiement.

📘

Pré-requis

• Effectuer les configurations ci-dessous. Il est nécessaire d’avoir les droits d’admin sur le dahsboard Adyen.
• Disposer de terminaux de paiements Adyen compatibles (terminaux de paiement tactiles : V400M et P400Plus)
• Utiliser la version Adyen Terminal API
• Produits Alma compatibles : 2, 3 et 4 fois

❗️

Clé API

La clé API utilisée pour configurer l'intégration TPE ne peut pas être utilisée pour configurer l'intégration Adyen et inversement. Chacune doit être distincte.

Comment configurer cette option

Etape 1 : Récupérer les informations suivantes:

• “Merchant Account” et “Company account”
• Clef API Adyen
• Liste des Store ID des boutiques Adyen concernées
  Une fois ces informations récupérées, merci de les envoyer par email à votre contact Alma.

Etape 2 : Il vous est également demandé d’effectuer les actions suivantes:

• Activer les WebSockets (nécessite une action de la part d’Adyen)
• Configurer les “Additional Data”

Vous trouverez ci-dessous le guide pas à pas vous permettant de récupérer ces informations et d’installer les éléments nécessaires à l’intégration TPE.

Etape 1 : Récupérer vos informations Adyen

Merchant account et company account

• “Company account” est le nom donné au compte parent. Dans l’exemple ci-dessous, il s’agit de “AlmaShop” (en haut à gauche de l’écran)
• Les comptes marchands (”Merchant account”), sont quant à eux, listés dans la partie “Account > Merchant accounts”
  Récupérez le company account ainsi que le merchant account

Clef d’API

Pour récupérer la clef d’API, vous devez

• Vous rendre dans le menu “Developers”
• Cliquer sur “API Credentials”
• En haut à droite, comme sur l’image ci-dessous, cliquez sur le bouton “ Create Credential” pour créer un nouveau “webservice user

C’est à partir de ce Web Service User que vous allez pouvoir générer la clef API.
Pour ce faire :

• Rendez-vous dans la section “Authentication”
• Cliquez sur le bouton “Generate New API key”

Veillez à bien enregistrer votre clef API. En effet, celle-ci n’étant pas sauvegardée par Adyen, vous devriez la générer à nouveau si vous la perdiez.

Dans la partie “Roles and Associated Account”, activez les rôles suivants sur le “WebService” user :
- Manage token sharing permits
- POS Terminal Management API role

Trouver le store id

La liste des boutiques est accessible dans l’onglet “Point of sales” puis dans l’entrée “Stores”.
Le numéro de la boutique (store id) correspond à la première ligne en gris clair dans la colonne “Store info”. Dans l’exemple ci-dessous, le numéro pour la boutique de Nice est le 1010.
Récupérez la liste des Store ID des boutiques Adyen concernées.

Vous avez désormais récupéré toutes les informations nécessaires à l'activation de l'intégration sur vos TPE, merci de les transmettre par email à votre contact Alma pour l'activation.

Etape 2 : Activation des Websockets et données aditionnelles

Activation des Websockets

• Pour activer les WebSockets, merci de contacter le support Adyen. Il vous suffit alors de leur demander de les activer.

Configurer la partie “additional data”

Dans la partie “Developers” cliquer sur “Additional data”
- Pour la section “card”, cochez l’ensemble des cases sauf la ligne : “Card bin payout details”.

Puis, pour la section “Payment”, sélectionnez seulement les cases suivantes :
- Recurring details
- Recurring contract information
- Include Alias Info

Un point sur vos Settlement Details Reports

Dans le cadre de cette intégration TPE, la transaction effectuée sur votre TPE apparaitra dans votre Settlement Details Report.
Pour pouvoir identifier la transaction Alma vous avez la possibilité d'ajouter une nouvelle colonne merchant_order_reference à votre Settlement Details Report. Pour cela, il vous suffit de demander l'ajout de cette colonne à votre contact Adyen.
Au moment de votre réconciliation comptable, vous devrez donc effectuer la réconciliation de votre SDR Adyen ainsi que de l'export de vos transactions Alma.

Attention : le format de votre Settlement Details Report sera probablement différent de celui attendu par votre système comptable. Vous devrez donc adapter votre système comptable pour l'intégration de format de votre fichier.