Documentation

1Documentation d’inscription Datatrans

La documentation d’inscription explique comment obtenir votre propre compte Datatrans. C’est une condition préalable pour commencer à traiter des transactions.

1.1Demander un compte marchand Datatrans

Avant de pouvoir commencer à accepter des paiements via Datatrans, vous avez besoin d’un compte Datatrans. Vous pouvez obtenir ce compte à l’URL suivante : https://www.datatrans.ch/.

1.2Accéder au compte d’administration

Une fois que Datatrans a créé un compte pour vous, vous recevrez un compte de test et un compte Live ainsi que les identifiants suivants :

  • Datatrans Test & Live Merchant ID

  • Nom d’utilisateur

  • Mot de passe

Ces informations sont nécessaires pour se connecter au back-end d’administration. Vous trouverez ci-dessous l’URL vers l’environnement de test et l’environnement Live.

Le compte d’administration vous permet de consulter les transactions, de créer des comptes utilisateurs et d’effectuer d’autres opérations administratives.

1.3Test

Pour tester votre intégration, vous pouvez suivre deux stratégies :

  1. Soit vous créez une configuration de processeur et configurez les détails de test avec le mode de fonctionnement en test. Après avoir testé avec succès l’intégration, vous remplacez les paramètres par ceux du compte Live.

  2. Soit vous créez deux configurations de processeur, une pour le Live et une pour le test. Une fois vos tests réussis, vous désactivez les configurations de processeur et de connecteur de test et vous assurez d’utiliser la configuration Live.

Vous trouverez plus d’informations sur les stratégies de test dans la documentation de paiement.

D’autres cartes de test pour Datatrans se trouvent dans la documentation.

Note
Assurez-vous de passer en mode Live, car les transactions en mode test ne sont pas traitées.

2Documentation de configuration Datatrans

La documentation suivante vous guidera à travers les étapes nécessaires pour configurer la configuration du processeur et du connecteur Datatrans.

2.1Configurer la configuration du processeur

Pour configurer le processeur Datatrans, suivez attentivement les étapes suivantes. Accédez à Space > Paiement > Configuration > Processeurs et ajoutez le processeur. Recherchez Datatrans dans le menu déroulant.

2.1.1Configurer le Datatrans Merchant ID

Tout d’abord, vous devez définir le Datatrans Merchant ID que vous trouvez en haut de votre écran de connexion. Il s’agit normalement d’un numéro à 10 chiffres comme celui-ci 1100005635. Les comptes live commencent normalement par un 3 et les comptes de test par un 1.

2.1.2Configurer la configuration de sécurité et le hash

Accédez à l’onglet UPP Administration > Security et cliquez sur Security signature pour configurer les hashes :

  1. Cliquez sur Generate New Key afin de générer un nouveau HMAC

  2. Cochez pour utiliser une autre clé pour sign2 et générez un HMAC sign2

  3. Copiez la clé dans les réglages de votre configuration de processeur et enregistrez les réglages dans le compte Datatrans.

UPP Security
Figure 1. UPP Security Settings

2.1.3Configurer la protection Server-to-Server

Accédez à l’onglet UPP Administration > Security :

  1. Cochez la case "Protect server-to-server services with password"

  2. Copiez le mot de passe dans le réglage Basic Authentication de la configuration du processeur.

Note
Une fois que vous avez activé la protection server-to-server, il n’est pas possible de désactiver cette fonctionnalité. Si cette option est activée et que le mot de passe n’est pas défini sur le processeur, la connexion sera bloquée et la demande de paiement ne pourra pas être finalisée car l’accès sera refusé.

2.1.4Réglages UPP

Pour configurer les données UPP pour la notification de paiement, accédez à l’onglet UPP Administration > UPP Data. Vous pouvez ici définir votre URL Post pour la notification des transactions de paiement. Tous les champs sauf URL Post doivent être remplis avec none.

Dans le champ URL Post, saisissez l’URL : https://sandbox.app-wallee.com/payment/processor/datatrans/notify

UPP Data Settings
Figure 2. UPP Data Settings

2.1.5Paiements récurrents

Si vous souhaitez utiliser le processeur Datatrans en lien avec des paiements récurrents et des abonnements, vous devrez obtenir un compte marchand dédié de Datatrans avec l’option alias activée.

Pour ce faire, réglez le Recurring Account Setting sur utiliser un compte dédié et configurez le compte pour les paiements récurrents comme décrit ci-dessus.

2.1.6Paiements MoTo

Vous pouvez utiliser le processeur Datatrans pour créer des commandes par courrier et par téléphone afin de débiter les clients directement au téléphone. Réglez la configuration Moto sur activé et configurez le compte exactement comme décrit ci-dessus.

2.2Créer un mode de paiement

Si ce n’est pas déjà fait, vous devez créer un mode de paiement pour tous les types de paiement que vous souhaitez accepter via Datatrans. Pour ce faire, accédez à Space > Configuration > Processeur > Modes de paiement.

Create the payment methods.
Figure 3. Créez les types de mode de paiement pour votre compte.

2.3Créer les connecteurs Datatrans

Enfin, vous devez lier le mode de paiement à la configuration du processeur au sein d’une configuration de connecteur. Pour ce faire, accédez à Space > Configuration > Processeur > Connecteur et créez une nouvelle configuration de connecteur. Assurez-vous de lier chaque type de mode de paiement que vous souhaitez traiter via l’application au processeur Datatrans.

Pour plus d’informations sur le concept de processeur et son fonctionnement, consultez notre documentation de paiement.

Create the connector configurations.
Figure 4. Créez les configurations de connecteur pour votre compte.