OdooWiki OCA HUB

eCommerce: charge payment fee

website_sale_charge_payment_fee folder_open OCA/e-commerce open_in_new
Website License: AGPL-3

This module allows to associate generic payment fee to online payment methods. Thus, when website user select a payment method with additional fee, an additional sale order line will be added to online order

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Adds an optional payment fee to online orders when customers choose a payment method that charges extra. The fee appears as a separate order line and in the order total on the website.

This module lets you configure a fee on each payment provider (like a credit card surcharge). In the payment provider form, a new 'Charge payment fee' tab appears where you can enable the fee, choose a service product to represent it, and set either a fixed amount or a percentage of the order total. You can also set the currency for fixed fees.

On the website shop, when a customer selects a payment method that has a fee, the fee is automatically added as a separate line to the order. The fee line is hidden from the normal cart lines but shown in the order total summary as 'Payment Fee'. The fee amount is recalculated whenever the order changes or the payment method is switched.

The fee is computed based on the order subtotal (tax excluded) or total (tax included), depending on the website setting for showing subtotals. If the fee currency differs from the order currency, the fixed fee is converted automatically.

This module affects payment providers, sale orders, and sale order lines. It also modifies the website payment form to display the fee next to the payment method and to refresh the order total when a method is selected.

Depends on

paymentwebsite_sale
Models and fields (3)
  • sale.order · extends an existing modelamount_payment_fee (Payment Fee Amount)
  • sale.order.line · extends an existing modelpayment_fee_line (Payment fee line)
  • payment.provider · extends an existing modelcharge_fee (Fee charged to customer), charge_fee_type (Computation type), charge_fee_percentage (Percentage), charge_fee_product_id (Fee Product), charge_fee_currency_id (Fee Currency), charge_fee_description (Fee Description), charge_fee_fixed_price (Fixed Price)

Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 5 confirmed, 4 with no information of 9 versions.

Sources · Odoo 19.0

Confirmed on 2026-11-03 in branch 19.0 of OCA/e-commerce.

terminal Installation and usage

OCA documentation · Odoo 19.0

Click

Accounting -\> Configuration -\> Payments -\> Payment Acquirers

open an acquirer and in CHARGE PAYMENT FEE tab, you can set the fee to be charged to customer.

No verified information in OCA: Installation, Usage.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.