Axepta BNP Paribas V2 in Odoo: cards, Wero, Bancontact and pay in 3
Axepta is the online payment platform of BNP Paribas. Its version 2 replaces the old Blowfish-encrypted integration with a REST API authenticated through OAuth2. Our Axepta BNP Paribas V2 module for Odoo is built on that new API: your customers pay on the Axepta hosted page, and Odoo receives the result in real time, linked to the order and the invoice.
If your merchant contract is with BNP Paribas, you are probably reading this for one of two reasons: you are starting on Odoo and want to connect Axepta, or you still run a V1 integration and BNP Paribas is asking you to move to V2. Both cases are covered below.
In this article
What changes with Axepta V2
With V1, every payment request was encrypted with Blowfish and then signed with HMAC using shared keys. It works, but it is heavy to maintain, and BNP Paribas is moving its merchants to the new API. V2 changes three things for you:
- Authentication uses OAuth2 client credentials: Odoo gets a token from your Merchant ID and API key instead of encrypting each message;
- Exchanges are JSON over a REST API, with an idempotency header so that a replayed request never creates a second payment;
- Notifications arrive by webhook in real time and update the Odoo transaction even if the customer closes the browser before returning to the shop.
The module needs no external Python library: it installs like any other Odoo module, on Odoo.sh or on your own server.
Available payment methods
The module handles eight payment methods, plus a "Pay with Axepta" option that shows every method of your Merchant ID on the Axepta page. Each method is enabled separately in Odoo, provided it is also open on your BNP Paribas contract.
Bank cards
CB, Visa, Mastercard and American Express, with 3D Secure 2
Apple Pay
One-touch payment on iPhone, iPad, Mac and Safari
Google Pay
Card saved in the Google account, on Android and Chrome
PayPal
For customers who would rather not type their card
Wero
Account-to-account payment backed by European banks
Floa Pay
Pay in 3 or 4 instalments, by the BNP Paribas subsidiary
Instanea
SEPA instant transfer from the customer's IBAN
Bancontact
The debit card most Belgian shoppers use
Two of them deserve attention. Instanea is a SEPA instant transfer: the money arrives within seconds and there is no chargeback, which matters for large baskets. Wero is the payment solution of the European banks (EPI), which BNP Paribas promotes to its customers; better to have it on your checkout before shoppers start looking for it.
For instalments, Floa Pay goes through Axepta here. If you prefer a direct contract with FLOA, we also have a dedicated module, described in FLOA Pay for Odoo.
The payment flow in Odoo
- The customer picks a payment method on the shop, on the payment link of a quotation or on an invoice in the portal.
- Odoo opens a payment session at Axepta and redirects the customer to the PCI DSS compliant hosted page.
- The customer pays, with 3D Secure 2 for cards (frictionless or challenge depending on their bank), then returns to Odoo.
- The webhook and the return URL confirm the transaction. The order is validated and the payment reconciled with the invoice.
The currency is taken from the Odoo transaction. The module covers France, Belgium, the Netherlands, Luxembourg, Germany and Austria, among the other countries Axepta serves.
Moving from Axepta V1 to V2 without downtime
V2 is a separate payment provider in Odoo, not an update of the old one. That is good news: you can prepare the switch without touching what is running. This is the order we follow with our clients.
- Ask BNP Paribas for your V2 credentials: Merchant ID and API key, for test and for production. List the payment methods open on the contract at the same time.
- Install the V2 module on a copy of your database and configure the provider in test mode with the demo Merchant ID.
- Test every enabled method: accepted, refused and abandoned payments, and the webhook confirmation when the customer never comes back to the shop.
- Go live: publish the V2 provider and unpublish V1 at the same time. Customers see no difference.
- Keep the history: past transactions stay linked to the old provider. To refund an order paid through V1, use the Axepta back office.
If the switch coincides with an Odoo version upgrade, do it after the migration, on the new version: one project at a time, and simpler tests. Our Odoo migration page explains how we run these projects.
Technical sheet
| API | Axepta REST V2, JSON (replaces V1 Blowfish / HMAC) |
|---|---|
| Authentication | OAuth2 client credentials: Merchant ID and API key |
| Flow | Hosted payment page (HPP), by redirection |
| 3D Secure | 3D Secure 2, frictionless and challenge |
| Notifications | Server-to-server webhooks, in real time |
| Security | PCI DSS through the hosted page, TLS, OAuth2 tokens, Idempotency-Key headers |
| Test mode | Demo Merchant ID |
| Odoo versions | 18, 19 and 20, Community and Enterprise |
| Dependencies | No external Python library |
Frequently asked questions
Is my Axepta V1 contract compatible with this module?
The commercial contract stays the same, but V2 uses different credentials (Merchant ID and API key). Ask your BNP Paribas advisor for them before you start.
Are all payment methods active by default?
No. A method only shows if it is enabled in Odoo and open on your contract. Wero, Instanea or Floa Pay usually have to be requested separately.
Does the module work on Odoo Online?
No, Odoo Online does not accept third-party modules. It installs on Odoo.sh or on your own server.
Can it be used for invoices, not only for the shop?
Yes. Invoices sent by e-mail and the customer portal offer Axepta payment, and the payment is reconciled automatically.
An Axepta V1 to V2 migration coming up?
We install the module, test every payment method of your contract on a copy of your database and make the switch with you. Tell us about your project, or see all our Odoo payment modules.
Other guides on Odoo payments
- CAWL for Odoo: 32 Payment Methods : 3D Secure 2, Tokenization, Manual Capture & Refunds
- Monetico Integration in Odoo: Card Payment Module for Crédit Mutuel and CIC
- FLOA Pay for Odoo: Buy Now Pay Later with 35 Payment Methods Across 7 European Countries
Module page in our catalogue: Axepta BNP Paribas V2 (HPP)