Se rendre au contenu
Tutos Odoo › Point de Vente › Terminal de paiement
Tuto interactif · Cas qui coincent · 5 min

Relier un terminal de paiement à la caisse Odoo

Un terminal de paiement relié reçoit le montant de la caisse : plus de double saisie. Installez le module du fournisseur dans Point de Vente › Configuration › Paramètres › Terminaux de paiement (Viva.com, Adyen, Stripe ; Worldline et Ingenico passent par une IoT Box), ouvrez le moyen Carte (en Odoo 19 et 18, caisse fermée), mettez Intégration sur Terminal et choisissez le fournisseur dans Intégrer avec. En caisse, Carte puis Envoyer. Sans terminal relié, la carte reste un moyen simple : le caissier tape le montant sur le terminal et valide.

Par Loïc Vina Ranchel, Kameos · Mis à jour le · Odoo 20.0, 19.0 et 18.0

Écrans d’Odoo 20.0. Changez de version pour voir les différences.Simulateur et texte avec les libellés d’Odoo 19.0.Simulateur et texte avec les libellés d’Odoo 18.0.
En brefParamètres›Terminaux de paiement›Viva.com›Modes de paiement›Carte›Intégration : Terminal›Intégrer avec›Envoyer
En brefParamètres›Terminaux de paiement›Viva.com›Modes de paiement›Carte›Intégration : Terminal›Intégrer avec›Envoyer
En brefParamètres›Terminaux de paiement›Viva Wallet›Modes de paiement›Carte›Intégration : Terminal›Intégrer avec›Envoyer

Le pas à pas

Les étapes en détail

  1. Terminal relié ou pas ?

    Sans terminal relié, le moyen Carte est un moyen simple : le caissier clique sur Carte, le montant dû s'inscrit, il tape le même montant sur le terminal et valide. Odoo ne vérifie rien : une faute de frappe sur le terminal ne se voit qu'au rapprochement bancaire. Un terminal relié reçoit le montant de la caisse et lui renvoie le résultat. Il vaut la peine dès que le volume de cartes est réel.

  2. Quel fournisseur en Belgique ?

    Odoo ne parle qu'aux fournisseurs qu'il connaît. Par internet, sans boîtier : Viva.com, Adyen et Stripe, présents dans les trois versions. Les terminaux Worldline et Ingenico, très répandus en Belgique, passent par une IoT Box et l'application IoT : la case Worldline/Ingenico (BENELUX) n'apparaît dans les paramètres qu'une fois l'IoT installée, et le moyen de paiement se relie à l'appareil détecté par la box. Ce tuto montre Viva.com, qui se règle entièrement dans Odoo. Les cartes acceptées (Bancontact, Visa, Maestro…) dépendent de votre contrat avec le fournisseur, pas d'Odoo.

    Odoo 19Worldline et Ingenico ont chacun leur case : Worldline (BENELUX) et Ingenico (BENELUX), toujours avec l'IoT Box.
    Odoo 18Viva.com s'appelle encore Viva Wallet. Worldline et Ingenico sont dans le module IoT de la caisse (cases Worldline (BENELUX) et Ingenico (BENELUX)).
  3. Installer le module du terminal

    Point de Vente › Configuration › Paramètres, bloc Terminaux de paiement : cochez Viva.com et enregistrez. Odoo installe le module et recharge la page. Ces cases valent pour toutes les caisses.

    Odoo 18La case s'appelle Viva Wallet.
  4. Relier le moyen « Carte »

    Dans le bloc Paiement, cliquez sur Modes de paiement (ou menu Configuration › Modes de paiement) et ouvrez Carte. Mettez Intégration sur Terminal, puis Intégrer avec sur Viva.com. Sous le champ, des cartes listent les autres fournisseurs avec un bouton Activer qui installe leur module. Odoo 20 accepte ce changement caisse ouverte (il ne bloque que le type, le journal, les comptes et les devises).

    Odoo 19Mêmes champs et mêmes cartes, mais fermez d'abord la caisse : tant qu'une session est ouverte, Odoo refuse toute modification du moyen de paiement. Les champs du fournisseur s'affichent directement sous Intégrer avec, sans onglet.
    Odoo 18Fermez d'abord la caisse, comme en V19. Pas de cartes : si aucun module de terminal n'est installé, choisir Terminal affiche un encadré qui renvoie vers Configurations > Paramètres (son titre est traduit par erreur « Pourboire : »). Les champs Viva s'affichent sous Intégrer avec.
  5. Les identifiants Viva

    Dans l'onglet Viva Com, recopiez depuis votre espace Viva l'ID marchand, la Clé API, l'ID Client et le Secret client, puis l'ID terminal de l'appareil. Mode test envoie les paiements vers l'environnement de démonstration de Viva. À l'enregistrement, Odoo vérifie l'ID marchand et la clé API auprès de Viva : s'ils sont faux, l'enregistrement est refusé. Une erreur sur l'ID Client, le secret ou l'ID terminal ne se voit qu'au premier paiement. Le champ Point de terminaison Webhook Viva.com est visible dès le choix du fournisseur, mais ne contient son jeton qu'après l'enregistrement : copiez-le alors dans votre compte Viva. C'est par cette adresse que le terminal annonce le paiement à Odoo.

    Odoo 19Mêmes champs, sous Intégrer avec.
    Odoo 18Mêmes champs, sous Intégrer avec ; l'adresse s'appelle Point de terminaison webhook Viva Wallet.
  6. Ce que voit le caissier

    Ouvrez la caisse depuis le tableau de bord (Ouvrir la caisse). Au paiement, un clic sur Carte ajoute une ligne au montant dû et affiche Demande de paiement en attente : rien n'est encore parti. Envoyer pousse le montant sur le terminal, la ligne passe à En attente de la carte. Une fois la carte acceptée, la ligne affiche Paiement réussi et, avec Valider automatiquement de la commande (coché par défaut), la vente se valide seule. Si le client annule, la ligne affiche Transaction annulée et Réessayer. Forcer la validation valide la ligne sans réponse du terminal : ne l'utilisez que si le ticket du terminal montre le paiement accepté.

  7. Ce qu'Odoo garde de la carte

    Odoo n'enregistre jamais le numéro complet de la carte. Avec un terminal relié, il garde ce que le terminal renvoie : la référence de la transaction, la marque de la carte et le numéro masqué. Sans terminal relié, il ne garde que le montant et le moyen de paiement.

Ce qui change selon la version

Odoo 20Odoo 19Odoo 18
VivaViva.comViva.comViva Wallet
Champs du terminalongletsous le champsous le champ
Cartes « Activer »ouiouinon
WorldlineWorldline/IngenicoWorldline, Ingenicodans pos_iot
Bancontact Pay (QR)ouinonnon
Type du moyenau choixselon le journalselon le journal

Caisse, terminal, clôture : on règle votre Point de Vente Odoo avec vous ?

Une caisse qui tombe juste le soir, des remises maîtrisées, un terminal Bancontact qui encaisse sans double saisie : chez Kameos, je paramètre Odoo Point de Vente avec vous.

Parlons de votre cas →

Kameos vous accompagne aussi pour intégrer Odoo dans votre PME, équiper une ASBL avec Odoo, former vos équipes ou créer une application mobile connectée à Odoo, en Brabant wallon et dans toute la Wallonie.