| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
eCommerce (website_sale)
• Discuss (mail) • Invoicing (account) • Website (website) |
| Lines of code | 632 |
| Technical Name |
fees_extension_stripe |
| License | LGPL-3 |
| Website | https://www.shadailtech.com |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
eCommerce (website_sale)
• Discuss (mail) • Invoicing (account) • Website (website) |
| Lines of code | 632 |
| Technical Name |
fees_extension_stripe |
| License | LGPL-3 |
| Website | https://www.shadailtech.com |
| Versions | 18.0 19.0 |
|
||
|
✔Real-time fee calculation at checkout ✔Configurable rate — no code changes needed ✔Card-only trigger, ACH & bank transfer fee-free ✔Fee reconciled as dedicated sale order line ✔Stripe webhook integration, idempotency safe ✔Saved card & portal transparency support 💻
Community
✔ Supported
🏢
Enterprise
✔ Supported
☁️
Odoo.sh
✔ Supported
🌐
Online (SaaS)
⚠ Not Available
v 18.0.1.0.0
Odoo 18
LGPL-3
$29.99
|
Overview
What does this module do?
This module extends the Odoo 18 Stripe payment provider to automatically calculate and collect a configurable processing fee when a customer pays by credit or debit card. The fee is computed in real time on the payment portal, displayed as a dedicated line item so customers always know exactly what they will be charged before confirming, and then reconciled back into the sale order as a separate order line once payment is confirmed via Stripe webhook. Bank transfers and ACH payments are fee-free.
Key Features
Everything you need to collect and reconcile Stripe processing fees transparently.
Payment Flow
How the fee moves from the portal through to the sale order.
Selects card on portal
Real-time breakdown
Stripe webhook fires
SOL created on order
Clean accounting
Step-by-Step Setup Guide
From installation through live fee collection.
Install the Module
Go to Apps → Search “Stripe Processing Fee Extension” → Install.
💡Prerequisites Requirespayment_stripe,sale, andwebsite_sale. The Stripe provider must be configured and active first.Verify Auto-created Fee Product
After install, a Stripe Processing Fee product is auto-created under Sales → Products. This product is used as the fee order line — do not delete it.
Open Stripe Provider Settings
Go to Accounting → Configuration → Payment Providers → Stripe.
Set the Fee Rate
Field Description Default Fee PercentageVariable part as % of order total 2.9% Fixed FeeFlat amount added per card transaction $0.30 Fee ProductOdoo product for the fee order line Auto-created
Verify Stripe Webhook is Active
The fee order line is created when Stripe confirms payment via webhook. Confirm the webhook URL is registered in your Stripe Dashboard under Developers → Webhooks.
⚠️Important Without an active webhook, the fee line will not be added to the sale order after payment. Ensurepayment_intent.succeededevent is enabled.Test with Stripe Test Mode
Use Stripe's test card
4242 4242 4242 4242to simulate a card payment and verify the fee line appears on the sale order.
Customer Checkout Experience
When a customer selects a card method, the fee breakdown block appears automatically showing Order Subtotal, Processing Fee, and Total Charged.
Review the Fee on the Sale Order
After successful payment, open the sale order in Sales → Orders. The fee appears as a dedicated order line and is included in the invoice automatically.
Technical Details
Dependencies, data models, and extensions.
| Requirement | Details |
|---|---|
| Odoo Version | 18.0 (Community or Enterprise) |
| Required Modules | payment_stripe sale website_sale |
| Stripe Account | Active Stripe account with payment_intent.succeeded webhook configured |
| Python Packages | No additional packages required beyond standard Odoo dependencies |
Data Models & Extensions
| Model / View | Change |
|---|---|
payment.provider | Adds stripe_fee_percentage, stripe_fee_fixed, and stripe_fee_product_id fields |
sale.order | Adds helper method to locate or create the processing fee order line |
| Website payment form template | Injects the real-time fee breakdown block below the order summary |
| Website sale template | Extends the checkout page to surface the fee when a card method is selected |
Support & Contact
Need help with installation, configuration, or customisation?
Our team at Shadail Technology is here to help with installation, custom Stripe configurations, multi-currency setups, or deeper Odoo integrations.
|
Please log in to comment on this module