Viva Wallet Smart Checkout, en natif dans Odoo
Viva Wallet est l'un des principaux établissements de paiement en Europe. Sa page de paiement hébergée, Smart Checkout, accepte les cartes, les portefeuilles numériques et les moyens de paiement locaux en une seule intégration. Notre module de paiement Viva Wallet pour Odoo en fait un fournisseur de paiement natif d'Odoo : vos clients paient sur Viva Wallet, et vous gérez toute la vie du paiement depuis Odoo, de la confirmation de la commande aux remboursements, captures, cartes enregistrées et renouvellements d'abonnements.
Cet article présente ce que fait le module, comment il se configure et à quoi ressemble chaque parcours de paiement dans Odoo, avec des captures d'écran issues de vrais paiements sur l'environnement de démonstration de Viva Wallet.
Dans cet article
- Pourquoi Viva Wallet Smart Checkout avec Odoo
- Configurer Viva Wallet dans Odoo en quelques minutes
- Le statut des paiements en temps réel grâce à des webhooks sécurisés
- L'expérience de paiement
- Paiements refusés, nouvelles tentatives et doubles paiements
- Remboursements depuis Odoo et depuis le dashboard Viva Wallet
- Capture manuelle : autoriser à la commande, débiter à l'expédition
- Cartes enregistrées et paiement en un clic
- Des abonnements Odoo payés automatiquement
- Aucune commande payée oubliée
- FAQ
Pourquoi Viva Wallet Smart Checkout avec Odoo
Avec Smart Checkout, votre client est redirigé vers une page de paiement sécurisée, conforme PCI DSS et hébergée par Viva Wallet, puis renvoyé vers votre boutique Odoo. Les données de carte ne passent jamais par vos serveurs, le 3-D Secure est géré par Viva Wallet, et vous proposez de nombreux moyens de paiement sans avoir à les intégrer un par un :
- Cartes : Visa, Mastercard, Maestro, American Express, Diners Club, Discover, JCB, UnionPay.
- Portefeuilles numériques : Apple Pay, Google Pay, Samsung Pay, PayPal.
- Moyens de paiement locaux : iDEAL, Bancontact, EPS, Przelewy24, BLIK, MB WAY, Multibanco, Trustly, Swish, MobilePay, WeChat Pay et d'autres, selon votre compte.
Ce qui fait la différence au quotidien, c'est le côté Odoo. Un module de paiement n'est pas qu'un bouton « Payer » : il doit confirmer la bonne commande à chaque fois, expliquer les refus, gérer les remboursements et les captures, et ne jamais laisser une commande payée en devis. C'est là-dessus que nous avons mis l'accent.
Configurer Viva Wallet dans Odoo en quelques minutes
Le module a besoin de quatre identifiants issus de votre dashboard Viva Wallet, dans Réglages > Accès API : l'ID Commerçant et la Clé API, ainsi que l'ID Client et le secret client des identifiants Smart Checkout. Sur la même page, cochez Autoriser les remboursements et Autoriser les paiements récurrents et les prélèvements de pré-auth via l'API.
Dans Odoo, ouvrez le fournisseur de paiement Viva Wallet, saisissez les identifiants et utilisez les deux boutons ajoutés par le module :
- Create a payment source for this website : Odoo crée la source de paiement Viva Wallet avec votre domaine et les bonnes URL de retour, puis renseigne le code de la source. Aucune URL à saisir à la main, donc aucune faute de frappe qui empêcherait vos clients de revenir sur votre boutique.
- Generate Webhook URL : Odoo récupère la clé de vérification de votre compte et construit l'URL authentifiée du webhook, prête à coller dans Viva Wallet.
Passez ensuite le fournisseur en mode test sur l'environnement de démonstration de Viva Wallet, ou en mode activé en production, et publiez-le. Les deux boutons refusent une adresse locale comme localhost : Viva Wallet ne pourrait pas la joindre.
Le statut des paiements en temps réel grâce à des webhooks sécurisés
Les clients ne reviennent pas toujours sur votre site après avoir payé : ils ferment l'onglet, perdent leur connexion ou paient sur leur téléphone. Les webhooks permettent à Viva Wallet de prévenir Odoo directement. Créez un webhook par événement avec l'URL générée :
| Événement Viva Wallet | Action d'Odoo |
|---|---|
| Transaction Payment Created | Confirme le paiement et la commande, enregistre la marque de la carte. |
| Transaction Failed | Enregistre le refus avec le motif donné par la banque. |
| Transaction Reversal Created | Rattache un remboursement à son paiement, y compris les remboursements faits dans le dashboard Viva Wallet. |
| Order Updated | Annule la transaction Odoo quand l'ordre est annulé côté Viva Wallet. |
La sécurité dès la conception.
L'URL du webhook porte la clé de vérification de votre compte, contrôlée en temps constant, et le contenu de la notification n'est jamais cru pour le statut du paiement : Odoo relit toujours la transaction auprès de l'API Viva Wallet authentifiée, et contrôle le montant et la devise, avant de confirmer une commande. Une notification falsifiée ne peut pas marquer une commande comme payée.
L'expérience de paiement
Au moment de payer, votre client voit Carte avec les marques de votre compte, ainsi que les moyens locaux que vous activez. Le moyen choisi dans Odoo est présélectionné sur Smart Checkout, qui s'ouvre dans la langue du client et à la couleur de votre marque. De retour dans Odoo, la commande est confirmée et la marque réelle de la carte est enregistrée sur le paiement.
Chaque ordre transmet à Viva Wallet des données client propres : le pays de l'adresse de facturation et un numéro de téléphone au format international, ce qui aide les contrôles anti-fraude de la banque et réduit les refus injustifiés.
Paiements refusés, nouvelles tentatives et doubles paiements
Un motif lisible
Fonds insuffisants, carte expirée, 3-D Secure non terminé : Odoo enregistre pourquoi un paiement a été refusé, sur la transaction et sur la commande, au lieu d'un code technique.
Une nouvelle tentative prise en compte
Quand le client réessaie après un refus et paie, la commande est confirmée. Elle ne reste jamais en devis alors que Viva Wallet a encaissé.
Pas de double paiement
Si le client clique de nouveau sur « Payer » dans un autre onglet, Odoo annule les ordres Viva Wallet précédents non payés : la même commande ne peut pas être payée deux fois.
Remboursements depuis Odoo et depuis le dashboard Viva Wallet
Effectuez des remboursements totaux ou partiels directement depuis le paiement Odoo ou depuis un avoir : inutile d'ouvrir le dashboard Viva Wallet. Et quand un remboursement est fait dans le dashboard, il revient automatiquement dans Odoo, rattaché à son paiement : votre comptabilité reste à jour.
Capture manuelle : autoriser à la commande, débiter à l'expédition
Activez la capture manuelle sur le fournisseur et la commande devient une pré-autorisation : le montant est réservé sur la carte, et vous le capturez depuis Odoo à l'expédition, en totalité ou en partie. Si la commande est annulée, annulez l'autorisation depuis Odoo et la réservation est libérée. Une pré-autorisation n'est jamais confirmée comme payée par erreur, et les vérifications automatiques ne capturent jamais à votre insu.
Cartes enregistrées et paiement en un clic
Les clients connectés peuvent cocher Enregistrer mes données de paiement. Leurs commandes suivantes se paient en un clic, directement depuis Odoo, sans repasser par la page de paiement. Odoo ne garde qu'une référence à la transaction Viva Wallet et les quatre derniers chiffres : aucun numéro de carte n'arrive dans votre base. Vos clients peuvent aussi ajouter une carte depuis leur portail, par une vérification de carte à montant nul.
Des abonnements Odoo payés automatiquement
Avec les abonnements Odoo, la carte que votre client enregistre lors du premier paiement règle chaque renouvellement. À chaque échéance, Odoo crée la facture et débite la carte enregistrée via Viva Wallet, sans action du client. Aucun module supplémentaire n'est nécessaire.
- Renouvellement refusé : l'abonnement affiche le motif donné par la banque, la carte reste enregistrée et la date de renouvellement ne bouge pas.
- Consentement retiré : si le client révoque le consentement aux paiements récurrents de sa carte, Odoo arrête de la débiter et lui demande un nouveau moyen de paiement au prochain renouvellement.
- Résultat perdu : si le résultat d'un débit n'arrive jamais dans Odoo, il est récupéré auprès de Viva Wallet et la facture est réglée.
Aucune commande payée oubliée
Même avec les webhooks, une notification peut se perdre. Le module ajoute deux filets de sécurité :
- Réconciliation horaire : une tâche planifiée demande à Viva Wallet le statut réel des paiements encore en attente dans Odoo et confirme ceux qui sont payés.
- Rattrapage à la mise à jour : les paiements manqués par une version antérieure du module sont retrouvés chez Viva Wallet et confirmés ; les cas douteux reçoivent une note sur la commande pour une vérification humaine.
Le module est traduit en 17 langues européennes en plus de l'anglais, et Smart Checkout s'ouvre dans la langue de votre client. Il est disponible pour Odoo 17, 18, 19 et 20, en Community et Enterprise.
FAQ
Quelles versions d'Odoo le module Viva Wallet prend-il en charge ?
Odoo 17, 18, 19 et 20, en Community et Enterprise.
Les numéros de carte passent-ils par Odoo ?
Non. Les clients paient sur la page Smart Checkout hébergée par Viva Wallet. Les cartes enregistrées sont conservées par Viva Wallet ; Odoo ne stocke qu'une référence et les quatre derniers chiffres.
Peut-on rembourser depuis Odoo ?
Oui, en totalité ou en partie, depuis le paiement ou depuis un avoir. Les remboursements faits dans le dashboard Viva Wallet sont aussi enregistrés dans Odoo.
Est-ce compatible avec les abonnements Odoo ?
Oui. Les renouvellements sont débités automatiquement sur la carte enregistrée par le client, avec une gestion claire des renouvellements refusés.
Que se passe-t-il si un webhook se perd ?
Une réconciliation horaire demande à Viva Wallet le statut réel des paiements en attente et confirme les commandes payées.
Peut-on tester avant la mise en production ?
Oui : utilisez le mode test du fournisseur avec votre compte de démonstration Viva Wallet.
Besoin d'aide avec Viva Wallet dans Odoo ?
Nous installons, configurons et adaptons le module à votre activité. Nous développons aussi des modules de paiement Odoo pour d'autres banques et prestataires de paiement : voir tous nos modules de paiement Odoo, ou contactez-nous.