Les étapes en détail
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.
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)).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.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.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.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é.
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 20 | Odoo 19 | Odoo 18 | |
|---|---|---|---|
| Viva | Viva.com | Viva.com | Viva Wallet |
| Champs du terminal | onglet | sous le champ | sous le champ |
| Cartes « Activer » | oui | oui | non |
| Worldline | Worldline/Ingenico | Worldline, Ingenico | dans pos_iot |
| Bancontact Pay (QR) | oui | non | non |
| Type du moyen | au choix | selon le journal | selon le journal |