Overview
Migrating from Odoo 14 to 15 primarily involves adapting to the payment module rewrite and handling new module additions. This guide covers the breaking changes, migration strategy, and common issues encountered during the upgrade.
Payment Module Rewrite
The most significant breaking change in Odoo 15 is the complete rewrite of the payment module. The old payment.acquirer model is replaced with a new payment.provider architecture.
Key Changes
payment.acquirermodel renamed/restructured aspayment.provider- Transaction flow standardized with new state machine
- Webhook handling completely rewritten
- Provider-specific code moved to dedicated modules
- Token management system overhauled
Impact on Custom Payment Integrations
Any custom payment acquirer built on v14's payment.acquirer model must be rewritten from scratch. The new architecture is cleaner and more standardized, but there is no direct mapping from old to new code. Budget significant development time for this.
New Modules to Consider
- Gift Cards —
gift_card,pos_gift_card,sale_gift_card,website_sale_gift_card - Event Booths —
event_booth,event_booth_sale,website_event_booth - Project Bridges —
project_account,project_purchase,project_hr_expense - GS1 Barcodes —
barcodes_gs1_nomenclature - Work Entries —
hr_work_entry_contract,hr_work_entry_holidays
Removed Modules
procurement_jit— just-in-time procurement removedadyen_platforms— Adyen for platformssale_timesheet_edit,sale_timesheet_purchasewebsite_form— merged into corewebsite_mail_channel,website_sale_managementpayment_ingenico— replaced bypayment_ogonepayment_odoo_by_adyen,payment_adyen_paybylink
Migration Steps
- Audit all custom modules for payment.acquirer references
- Rewrite custom payment integrations for the new provider architecture
- Review project-related customizations against new bridge modules
- Check if custom gift card or coupon logic overlaps with new modules
- Update Python version if needed (v15 requires 3.7+)
- Test all eCommerce and POS payment flows thoroughly
Common Issues
- Payment tokens not migrating correctly
- Webhook URLs changing for payment providers
- Coupon module conflicts with gift card additions
- Project accounting customizations conflicting with new bridge modules
DeployMonkey Advantage
DeployMonkey handles Odoo version management and can assist with migration from v14 to current versions. Our platform ensures payment providers are correctly configured on the target version.