Axepta BNP Paribas V2 pour Odoo : moyens de paiement, Wero et passage depuis la V1

Si votre contrat de vente à distance est chez BNP Paribas, vous avez deux raisons de lire cet article : vous démarrez sur Odoo et cherchez comment y brancher Axepta, ou vous utilisez encore une intégration V1 et BNP Paribas vous demande de passer à la V2. Les deux cas sont traités ci-dessous.

Ce qui change avec Axepta V2

Avec la V1, chaque demande de paiement était chiffrée en Blowfish puis signée en HMAC avec des clés partagées. Ça fonctionne, mais c'est lourd à maintenir et BNP Paribas pousse ses commerçants vers la nouvelle API. La V2 change trois choses pour vous :

• L'authentification se fait en OAuth2 (client credentials) : Odoo obtient un jeton à partir de votre Merchant ID et de votre clé API, au lieu de chiffrer chaque message ;
• Les échanges passent en JSON sur une API REST, avec un en-tête d'idempotence qui évite de créer deux paiements si une requête est rejouée ;
• Les notifications arrivent par webhook, en temps réel, et mettent à jour la transaction Odoo même si le client ferme son navigateur avant de revenir sur la boutique.

Le module n'a besoin d'aucune bibliothèque Python externe : il s'installe comme n'importe quel module Odoo, sur Odoo.sh ou sur votre serveur.

Les moyens de paiement disponibles

Le module gère huit moyens de paiement, plus une option « Payer avec Axepta » qui affiche tous ceux de votre Merchant ID sur la page Axepta. Chaque moyen s'active séparément dans Odoo, à condition d'être aussi ouvert sur votre contrat BNP Paribas.

Deux d'entre eux méritent l'attention. Instanea est un virement SEPA instantané : l'argent arrive en quelques secondes et il n'y a pas de rétrofacturation possible, ce qui intéresse les paniers élevés. Wero est la solution de paiement des banques européennes (EPI), que BNP Paribas pousse auprès de ses clients ; mieux vaut l'avoir sur sa page de paiement avant que les acheteurs ne la cherchent.

Pour le paiement en plusieurs fois, Floa Pay passe ici par Axepta. Si vous préférez un contrat direct avec FLOA, nous avons aussi un module dédié, présenté dans FLOA Pay pour Odoo.

Le parcours de paiement dans Odoo

1. Le client choisit son moyen de paiement sur la boutique, sur le lien de paiement d'un devis ou sur la facture du portail.
2. Odoo ouvre une session de paiement chez Axepta et redirige le client vers la page hébergée, conforme PCI DSS.
3. Le client paie, avec 3D Secure 2 pour les cartes (frictionless ou challenge selon sa banque), puis revient sur Odoo.
4. Le webhook et l'URL de retour confirment la transaction. La commande est validée, le paiement rapproché de la facture.

La devise est reprise de la transaction Odoo. Le module couvre la France, la Belgique, les Pays-Bas, le Luxembourg, l'Allemagne et l'Autriche, entre autres pays ouverts par Axepta.

Passer d'Axepta V1 à la V2 sans coupure

La V2 est un autre fournisseur de paiement dans Odoo, pas une mise à jour de l'ancien. C'est une bonne nouvelle : vous pouvez préparer la bascule sans toucher à ce qui tourne. Voici l'ordre que nous suivons chez nos clients.

1. Demandez vos identifiants V2 à BNP Paribas : Merchant ID et clé API, en test puis en production. Profitez-en pour faire la liste des moyens de paiement ouverts sur le contrat.
2. Installez le module V2 sur une copie de votre base et configurez le fournisseur en mode test, avec le Merchant ID de démonstration.
3. Testez chaque moyen activé : paiement accepté, refusé, abandonné, et la confirmation par webhook quand le client ne revient pas sur la boutique.
4. Basculez en production : publiez le fournisseur V2 et dépubliez la V1 au même moment. Les clients ne voient pas la différence.
5. Gardez l'historique : les transactions passées restent liées à l'ancien fournisseur. Pour rembourser une commande payée en V1, passez par le back-office Axepta.

Si la bascule tombe en même temps qu'une montée de version d'Odoo, faites-la après la migration, sur la nouvelle version : un seul chantier à la fois, et des tests plus simples. Notre page migration Odoo explique comment nous organisons ces projets.

Fiche technique

Questions fréquentes

Mon contrat Axepta V1 est-il compatible avec ce module ?

Le contrat commercial reste le même, mais la V2 utilise d'autres identifiants (Merchant ID et clé API). Demandez-les à votre conseiller BNP Paribas avant de commencer.

Tous les moyens de paiement sont-ils actifs par défaut ?

Non. Un moyen n'apparaît que s'il est activé dans Odoo et ouvert sur votre contrat. Wero, Instanea ou Floa Pay se demandent en général à part.

Le module fonctionne-t-il sur Odoo Online ?

Non, Odoo Online n'accepte pas les modules tiers. Il s'installe sur Odoo.sh ou sur votre propre serveur.

Peut-on l'utiliser pour les factures, pas seulement pour la boutique ?

Oui. Les factures envoyées par e-mail et le portail client proposent le paiement Axepta, et le paiement est rapproché automatiquement.