Odoo Stripe Reconciliation in Odoo 19/20: Payouts, Fees, Disputes
Reconcile Stripe in Odoo 19 and 20: set up the Stripe journal and outstanding account, import payout data, and post fees, refunds and disputes with models.
Stripe pays out one net amount, while Odoo shows dozens of gross payments. Our Odoo integration services close that gap with a clear Odoo Stripe reconciliation flow built on standard Odoo features.
Related service: Odoo for finance teams — accounting, tax and reporting automation.
This guide is for finance teams on Odoo 19 or 20 who take card payments through Stripe. For direct debit, see our Odoo GoCardless integration guide, which covers the same payout problem.
How does Odoo Stripe reconciliation work in Odoo 19 and 20?
Odoo Stripe reconciliation is a three-step match: payments to Stripe activity, Stripe activity to payouts, and payouts to your bank deposit. Odoo handles the first link for you; the other two need data from Stripe.
When a customer pays online, the Odoo Stripe integration confirms the order or invoice and creates a payment for the full charge. That payment sits in an outstanding receipts account until it is matched with a bank transaction.
Stripe then nets fees, refunds and disputes and sends one payout. As one Odoo forum answer notes, that transfer covers several days, so you cannot fully match it from bank data alone.
The fix is to treat Stripe like a bank account inside Odoo: its own journal, its activity loaded as transactions, and Odoo matching each piece.
What does the Odoo Stripe integration record, and what does it skip?

The standard Odoo payment provider Stripe module records charges and refunds, but not fees, payouts or disputes. We checked this against the payment_stripe source code for Odoo 19 and 20, which only handles payment intent, setup intent and refund webhook events.
| Stripe event | What Odoo does by itself | What you add |
|---|---|---|
| Successful charge | Creates a gross payment on the provider's journal | Match it to the Stripe charge line |
| Refund from Odoo or Stripe | Creates an outbound refund payment | Match it to the Stripe refund line |
| Processing fee | Nothing | Fee line posted by a reconciliation model |
| Dispute opened | Nothing | Dispute line to a disputes account |
| Dispute won | Nothing | Reversal line back from disputes |
| Payout to bank | Nothing | Internal transfer to the bank journal |
Odoo's docs say the provider needs a payment journal so payments post to an outstanding account, and that provider payments "require you to follow another accounting workflow".
Stripe supports refunds and manual capture from Odoo. Odoo's provider table lists Stripe refunds as full and partial, and manual capture as full only. Card validation transactions create no payment, because the source notes they are not included in payouts.
Which accounts does an Odoo Stripe setup need?
You need four accounts: a Stripe balance account, an outstanding receipts account, a Stripe fees account and a disputes account. A fifth, the liquidity transfer account, usually exists already.
| Account | Type | Purpose |
|---|---|---|
| Stripe balance | Bank and cash | Default account of the Stripe bank journal |
| Stripe outstanding receipts | Current assets | Holds Odoo payments until matched with Stripe lines |
| Stripe fees | Expenses | Processing and dispute fees |
| Stripe disputes | Current assets | Funds held by Stripe while a dispute is open |
| Liquidity transfer | Current assets | Moves each payout from the Stripe journal to the bank |
Payments create journal entries only when outstanding accounts are set on the payment method. Leave them blank and open Stripe items stay off your balance sheet.
For the logic of journals and accounts, see how Odoo Accounting works.
How do you set up the Odoo payment provider Stripe journal?
Create a dedicated Stripe bank journal, point the Stripe provider to it, and set an outstanding receipts account on its Stripe payment method. Do it on a staging copy first.
- Connect Stripe: in Accounting, Configuration, Payment Providers, open Stripe and click Connect Stripe, or enter your keys and generate the webhook, as the Odoo Stripe docs describe.
- Create the journal: add a Bank journal named Stripe, with the Stripe balance account as its default account. Do not connect it to bank synchronization.
- Assign the journal: on the provider's Configuration tab, set Payment journal to Stripe. Odoo uses the Bank journal by default.
- Set the outstanding account: on the Stripe journal's Incoming Payments tab, set the Stripe outstanding receipts account on the Stripe payment method line.
- Repeat for refunds: set an outstanding payments account on the outgoing side so refund payments post too.
- Test first: use Stripe test mode keys on a staging copy and run a sale, a partial refund and a payout before you go live.
One Stripe account can serve several companies by reusing the credentials and webhook. Give each company its own Stripe journal.
How do you import Stripe activity into Odoo?
Download the itemized CSV from Stripe's payout reconciliation report and import it into the Stripe journal as bank transactions. This gives Odoo one line for every charge, refund, dispute and fee inside each payout.
Stripe's payout reconciliation report groups transactions by payout. Its itemized export holds gross, fee, net, payout ID and description for each balance transaction.
The report needs automatic payouts; on manual payouts, Stripe points you to the Balance report. For instant payouts, Stripe cannot tell which transactions each payout holds.
Odoo imports bank transactions from CSV, XLSX, OFX, QIF and CAMT.053. A good CSV mapping:
- Date: the created date of each balance transaction.
- Label: the reporting category plus the description, which carries the Odoo reference.
- Amount: the gross amount on one line, then the fee as a separate negative line.
- Reference: the balance transaction ID, so duplicates are easy to spot.
- Partner: the customer name or email, if your Stripe export includes it.
Splitting gross and fee is the key step: each charge then matches its Odoo payment exactly, and a model sweeps every fee line.
How do you post Stripe fees in Odoo?
Post Stripe fees with an automated reconciliation model that catches fee lines on the Stripe journal and books them to your Stripe fees account. This is the core of Odoo Stripe fees accounting, and it removes most manual work.
Odoo reconciliation models are Manual or Automated, with conditions on journal, partner, amount and label, plus counterpart lines.
- Create the model: open the Stripe journal menu and choose Models, then New.
- Set the type: choose Automated so it runs without a click.
- Set conditions: Journal is Stripe, and Label contains your fee keyword, such as "fee".
- Set the counterpart: account Stripe fees, amount type Percentage of balance, amount 100.
- Order the models: if several automated models match, Odoo applies the first one in the sequence.
Watch tax on fees. Stripe's itemized report has a withheld tax column that is already included in the fee. If you can reclaim it, add a tax on the model.
Matching payouts straight on the bank instead? Use a Manual model. Odoo's built-in Bank Fees model only applies to labels containing "Bank Fees".
How do you handle an Odoo Stripe refund?
An Odoo Stripe refund creates an outbound payment in Odoo, whether you click Refund in Odoo or refund from the Stripe dashboard. You then match that payment with the negative refund line from Stripe.
The Stripe module listens for refund events, so a dashboard refund still reaches Odoo through the webhook and becomes an outbound payment on the Stripe journal.
Issue a credit note so revenue and tax reverse. If a refund fails later, for example on an expired card, Odoo updates the refund transaction; check those at month end.
With manual capture, void unshipped orders instead of refunding: Odoo's docs note voids carry no refund fee.
How do you record a Stripe chargeback in Odoo?
Record a Stripe chargeback by posting the disputed amount to a Stripe disputes account and the dispute fee to Stripe fees, because Odoo does not track Stripe disputes. When the outcome arrives, you clear the disputes account.
Stripe's dispute documentation says it debits the disputed amount plus a dispute fee when a dispute opens, and the full lifecycle can take two to three months.
- Dispute opens: match the negative dispute line to the Stripe disputes account, with the customer set as partner.
- Dispute fee: your fee model posts it to Stripe fees. Outside Mexico, Stripe says the dispute received fee is not refundable.
- Dispute won: Stripe returns the funds; match the positive line back against the Stripe disputes account.
- Dispute lost: move the balance from Stripe disputes to a loss or bad debt account, or reverse the sale with a credit note.
The disputed amount can differ from the charge, for example after currency conversion. Post the amount Stripe shows.
How do you match a Stripe payout to the bank deposit?
Match each payout twice: once as a negative line on the Stripe journal and once as the deposit on your bank journal, both against the liquidity transfer account. Odoo's Internal Transfers model handles both sides.
Odoo's docs say the Internal Transfers model must be used on both the outgoing and incoming transaction. Put the payout ID in both labels.
On Odoo 20, Run Auto Reconciliation in the bank matching gear menu reruns matching on demand. Our Odoo 20 accounting release notes list it as an Enterprise feature.
Odoo 20 also blocks bank and cash accounts on manual journal entry lines. Teams posting Stripe fees by manual entry on Odoo 19 must switch to statement lines first.
How do you handle multi-currency Stripe payouts?
Create one Stripe journal per settlement currency and let Odoo post exchange differences when it reconciles payments in another currency. Stripe may charge customers in one currency and pay you in another.
Odoo posts an exchange gain or loss entry when a payment is reconciled in a different currency. Import in the settlement currency.
For rates, revaluation and FX accounts, see our Odoo multi-currency accounting guide.
Which industries feel Stripe reconciliation pain most?
Businesses with many small card payments, subscriptions or late disputes feel it most. The table shows where the effort comes from and how Odoo handles it.
| Industry | Pain or cost driver | Odoo approach | How iVentureTeam helps |
|---|---|---|---|
| eCommerce and retail | Hundreds of small charges per payout | Stripe journal with automated fee model | Import template and model setup |
| SaaS and subscriptions | Saved cards, renewals, partial refunds | Tokenized payments on Subscriptions | Refund and credit note rules |
| Events and ticketing | Disputes long after the sale | Disputes account with aging review | Dispute tracking report |
| Professional services | Invoice payment links, few large charges | Payout-only matching on the bank | Lean setup, no extra journal |
| Cross-border sellers | Charges and payouts in different currencies | One Stripe journal per currency | FX account mapping |
For future events, Stripe says the dispute window starts on the event date. For the billing side of renewals, see our Odoo Subscriptions guide for the billing side.
What mistakes break Odoo Stripe payout reconciliation?
Most broken setups come from posting Stripe straight to the main bank journal or leaving outstanding accounts blank. These are the issues we see most in audits.
- Default Bank journal: Stripe payments land on your real bank journal, so gross payments never match net deposits.
- No outstanding account: invoices show unpaid until reconciliation, and open Stripe money is invisible.
- Net-only imports: importing payout totals hides which charge, fee or refund caused a difference.
- Manual fee entries: these stop working on Odoo 20 bank accounts and break audit trails on Odoo 19.
- Ignoring disputes: held funds sit unexplained on the Stripe balance account.
Spot these with the free Odoo health check and our Odoo month-end close checklist every period.
How iVentureTeam helps with Odoo Stripe reconciliation

iVentureTeam sets up Stripe in Odoo so every payout ties to its charges, fees, refunds and disputes. We have delivered 150+ ERP projects across 35+ countries with 40+ Odoo specialists, led by a consultant with 13+ years in Odoo.
- Process design: journals, accounts and matching rules agreed with your accountant through our Odoo consulting services.
- Import template: a Stripe CSV mapping that splits gross and fee lines and keeps the Odoo reference in the label.
- Reconciliation models: fee, dispute and payout models tested on a staging copy before go-live.
- Automation: where volume is high, a scheduled Stripe import built by our Odoo customization services.
- Upgrade check: a review of manual bank entries before you move from Odoo 19 to Odoo 20.
Odoo Stripe reconciliation case study: payment gateways for eCommerce brands
This case is not a Stripe project, but it shows how we build payment flows on Odoo's provider framework so payments land on the right orders. It covered older Odoo versions and checkout acceptance, not payout matching.
eCommerce merchants selling into the US, Switzerland and Brazil had gateway contracts with CardConnect, BlueSnap, SecurionPay, Cielo and Paymee. Odoo had no native connector for any of them, and offline workarounds left payments unreconciled in Odoo.
We built five connectors on Odoo's standard payment acquirer framework across Odoo 12, 13 and 14, over 8 weeks. Transaction references land on the Odoo order automatically, and payment confirmations drive order confirmation.
The difference from this guide is scope: those merchants needed checkout acceptance, while Stripe already has a standard Odoo module. Read the payment gateways Odoo eCommerce integration case study.
The bottom line on Odoo Stripe reconciliation
Give Stripe its own bank journal, import Stripe's itemized payout data, and let reconciliation models post fees, disputes and payouts. Odoo then ties every deposit back to the orders behind it.
Odoo handles charges and refunds on its own. Fees, disputes and payouts need Stripe's data and a few rules. Set them up once and test on staging.
Ready to make every Stripe payout tie out in Odoo?

Stop matching net deposits by hand. Get your Stripe reconciliation flow reviewed, call +91-90235-15208, or email business@iventureteam.com.
Frequently Asked Questions
Does Odoo import Stripe payouts automatically?
+
No. The standard Stripe module records charges and refunds only. Payouts, fees and disputes come from Stripe's reports, which you import as bank transactions or load with a scheduled custom import.
Does Odoo record Stripe fees?
+
Not by itself. Odoo posts the gross charge, so you need fee lines from Stripe's itemized report and a reconciliation model that books them to a Stripe fees account.
Can I refund a Stripe payment from Odoo?
+
Yes. Open the payment and click Refund; Stripe supports full and partial refunds. Refunds made in the Stripe dashboard also reach Odoo through the webhook and create an outbound payment.
How do I record a Stripe chargeback in Odoo?
+
Post the disputed amount to a Stripe disputes account and the dispute fee to Stripe fees. When the dispute is won, match the returned funds back; when it is lost, move the balance to a loss account or issue a credit note.
What is the outstanding receipts account used for with Stripe?
+
It holds Odoo's Stripe payments until they are matched with Stripe transactions. It reduces the invoice's amount due at once and shows unmatched Stripe money on your balance sheet.
Which Stripe report should I import into Odoo?
+
Use the itemized payout reconciliation report if you have automatic payouts. On manual payouts, Stripe recommends the Balance report. Both export to CSV for Odoo's bank transaction import.
Can Odoo bank synchronization connect to Stripe?
+
Odoo's bank sync works through bank data providers such as Plaid, Yodlee and Salt Edge. We have not verified a Stripe balance feed through them, so plan on a CSV import or a custom connector.
Does Stripe reconciliation work the same in Odoo 19 and Odoo 20?
+
Mostly. The provider setup, outstanding accounts and reconciliation models work the same. Odoo 20 blocks manual journal lines on bank accounts and adds Run Auto Reconciliation in Enterprise.
Free written answer from a certified consultant
Getting Odoo Accounting set up right?
We map your accounting, tax and reporting in Odoo and show what to set up first, and what to watch.
Free, with no obligation. A senior consultant replies within 12 business hours.
Free Odoo tools
All tools- Odoo Health CheckVersion, modules, findings and upgrade cost
- Odoo App SelectorWhich apps you need, by industry
- Odoo Project EstimateIndicative cost and timeline in minutes
- Odoo Implementation Cost CalculatorImplementation cost and timeline, in minutes
- Odoo Migration Cost CalculatorVersion jump or legacy ERP, priced in minutes
Continue reading
Odoo Accounting for CFOs in the GCC: VAT, E-Invoicing and Controls
Odoo accounting for CFOs in the GCC: UAE and Saudi VAT, ZATCA and UAE e-invoicing, AED and SAR multi-currency, lock dates and hashed audit controls.
Odoo Argentina Localization: ARCA E-Invoicing, ARBA and Withholdings
Odoo Argentina localization for Odoo 19 and 20: l10n_ar_edi ARCA e-invoicing, ARBA retenciones, IIBB percepciones, setup steps and the padron gap.
Odoo 20 Accounting Upgrade Checklist: Reconciliation, Taxes, Reports
Odoo 20 accounting changes explained, with an upgrade test checklist for bank reconciliation, taxes, fiscal positions, lock dates and financial reports.
