Tuto : Connexion d'un TPE Ingenico avec Qweekle

Ce guide vous aide à connecter votre TPE à Qweekle afin que les paiements par carte soient transmis automatiquement, sans saisie manuelle.

Dans ce guide, nous allons :

🛠️Conditions à remplir pour pouvoir connecter son TPE à Qweekle

Avant de commencer, assurez-vous que :

  • ✅ Vous possédez un TPE "Ingenico DESK" ou "MOVE 5000" connecté.

  • QZ Tray version 2.2.1 (ou plus récente) est installé sur votre caisse.

  • ✅ Aucun blocage dans QZ Tray (voir ce ce tuto video).

  • ✅ Votre TPE est connecté à Internet et accessible sur le même réseau que votre caisse.

Vérifier la version du SDK de votre TPE

Le TPE doit avoir un SDK en version 11.16.08 (D) ou plus récent. Pour le vérifier :

  1. Accédez à Paramètres > Panneau de Contrôle > Information terminal.

  2. Allez dans SDK Information.

  3. Appuyez sur Afficher ou Imprimer.


🔧 Configurer votre TPE

Activer la connexion caisse

  1. Allez dans Paramètres > Panneau de Contrôle > Connexion Caisse.

  2. Appuyez sur Activer.

  3. Choisissez IP/ETH comme mode de connexion.

Configurer l'IP de votre TPE

Pour communiquer avec votre TPE, Qweekle a besoin de connaitre son adresse IP, si cette dernière change il sera nécessaire de refaire le lien. Deux méthodes existent

Méthode A: Fixer l'IP dans le TPE

  1. Désactiver le WiFi (si votre TPE le supporte) :
    • Accédez à Panneau de Contrôle > Paramètres du terminal > Moyen de communication > WiFi.

    • Appuyez sur Désactivé.

  2. Vérifier l'adresse IP :

    1. Branchez le TPE en Ethernet.

    2. Allez dans Panneau de Contrôle > Paramètres du terminal > Moyen de communication > Ethernet.

    1. Mettez DHCP sur ON.
    1. Vérifiez la connexion Internet via une télécollecte.

    2. Notez les informations suivantes :

      1. Adresse IP (ex: 192.168.2.16)

      2. Masque de sous-réseau (ex: 255.255.255.0)

      3. Adresse de la passerelle (ex: 192.168.2.1)
      4. Adresse DNS 1 (ex: 192.168.2.1)

  1. Fixer l'IP :

    • Mettez DHCP sur Off.

    • Entrez les valeurs notées précédemment.

      • Adresse IP (ex: 192.168.2.16)

      • Masque de sous-réseau (ex: 255.255.255.0)

      • Adresse de la passerelle (ex: 192.168.2.1)
      • Adresse DNS 1 (ex: 192.168.2.1)

    • Mettez Adresse DNS 2 : 8.8.4.4

    • Validez avec le bouton Jaune jusqu'à l'affichage de "Voulez-vous sauvegarder ?".

    • Refaire une télécollecte pour vérifier la connexion. 

Méthode B: Fixer l'IP via le routeur (ou votre box) 

Cette méthode permet d'être plus résiliente en cas de mise à jour de votre infrastructure réseau; mais étant très fortement dépendante de cette dernière, si vous désirez de l'assistance votre gestionnaire réseau sera votre interlocuteur. Notez l'IP de votre TPE.
  • Configurez votre routeur pour assigner une IP fixe au TPE.

  • Mettez DHCP sur ON sur votre TPE

🖥️ Configuration du TPE dans Qweekle

Une fois l'adresse IP de votre TPE fixé, nous allons configurer votre caisse pour faire le lien.

  1. Allez dans les Paramètres de vos caisses > Périphériques
  2. Allez dans l'onglet TPE puis rentrez les paramètres suivants:
    1. Cochez TPE aller-simple
    2. Sélectionnez le mode de paiement CB
    3. Sélectionnez le modèle de votre TPE INGENICO ou VERIFONE
    4. Renseignez l’adresse IP de votre TPE 
    5. Configurez le port à 8888 si votre TPE est un modèle Ingenico
    6. Numéro de caisse (à 2 chiffres, ex : 01, 02...) qui sera imprimé sur le ticket commerçant

  3. Tester la connexion

    1. Dans l'onglet TPE, entrez un montant test.

    2. Cliquez sur Envoyer au TPE.

    3. Si l'opération échoue, vérifiez le lien réseau TPE <-> Caisse

Utilisation du TPE en caisse

  • Le bouton TPE vous permet, en 1 clic, d'encaisser un payement en cb et de transmettre l'information au TPE 
  • Le TPE reçoit le montant à payer de Qweekle

  • En caisse, un modal s'ouvre
  • Il vous faut confirmer dans Qweekle que le paiement est OK

    • Si payement est bien encaissé sur le TPE > cliquer sur payement réussi

    • Si le payement ne passe pas > cliquer sur « Echec du paiement » et sélectionner un autre moyen de paiement.

⚠️Mon TPE ne fonctionne pas, que faire ?

Vérifier la connexion Internet du TPE

Une vérification à faire pour vérifier que votre TPE a accès à internet est le bon fonctionnement de la télécollecte.

  • Effectuez une télécollecte :

    • Appuyez sur la touche grise en haut à droite du clavier.

    • Allez dans Raccourcis > Lancer les télécollectes.

  • Si ça échoue :

    • Réactivez le DHCP et refaites une télécollecte.

    • Si cela échoue encore, vérifiez le pare-feu et la configuration réseau.

Vérifier la communication TPE <-> Caisse

  1. Ajoutez un produit à une commande et sélectionnez Paiement TPE.

  2. Si la case Paiement réussi reste grise, testez la connexion 

    1. Appuyez sur Win + R, tapez "cmd", puis validez

    2. Dans la fenêtre noire, entrez : ping [IP du TPE] puis appuyez sur Entrer. (L'IP est celle que vous avez rentré dans Qweekle, Dans paramètres de vos caisses -> Périphérique -> TPE)

    3. Si vous voyez "Request timed out.", la caisse et le TPE ne sont pas sur le même réseau.

    4. Dans la fenêtre de commande (la fenêtre noire), marquez ip config puis appuyez sur Entrer.

    1. Vérifiez que l'entrée "Gateway" correspond à la passerelle de votre TPE, si ce n'est pas le cas vérifiez que votre TPE et votre caisse sont bien branché sur le même routeur puis configurez votre TPE 

Mon TPE marchais bien, mais ne marche plus

Probablement votre configuration réseau à changée, cela peut arriver pour différentes raisons, entre autre:

  • Changement ou mise à jour de routeur (box internet)
  • Basculement sur un réseau de backup qui est configuré différemment
  • Changement des branchements des câbles RJ45...

Dans ce cas vous devez reconfigurer l'IP de votre TPE

J'ai le message "Retour base"

Ce message nécessite que vous appeliez votre fournisseur de TPE

Je veux utiliser ANCV Connect

Qweekle permet d'envoyer le montant pour un seul moyen de paiement, si vous désirez utiliser votre TPE pour encaisser des montants ANCV connect, vous pouvez

  • Contacter votre fournisseur de TPE pour configurer la mode ANCV connect
  • Dans Qweekle, créer un moyen de paiement ANCV
  • Lors d'une vente d'ANCV
    • Rentrer manuellement le montant sur le TPE et laisser le client faire le processus de paiement
    • Une fois le paiement encaissé, enregistrer le paiement en caisse