Skip to content

Odoo 14 to 15 Migration Guide: Payment Module and Breaking Changes

DeployMonkey Team · March 24, 2026 7 min read

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.acquirer model renamed/restructured as payment.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 Cardsgift_card, pos_gift_card, sale_gift_card, website_sale_gift_card
  • Event Boothsevent_booth, event_booth_sale, website_event_booth
  • Project Bridgesproject_account, project_purchase, project_hr_expense
  • GS1 Barcodesbarcodes_gs1_nomenclature
  • Work Entrieshr_work_entry_contract, hr_work_entry_holidays

Removed Modules

  • procurement_jit — just-in-time procurement removed
  • adyen_platforms — Adyen for platforms
  • sale_timesheet_edit, sale_timesheet_purchase
  • website_form — merged into core
  • website_mail_channel, website_sale_management
  • payment_ingenico — replaced by payment_ogone
  • payment_odoo_by_adyen, payment_adyen_paybylink

Migration Steps

  1. Audit all custom modules for payment.acquirer references
  2. Rewrite custom payment integrations for the new provider architecture
  3. Review project-related customizations against new bridge modules
  4. Check if custom gift card or coupon logic overlaps with new modules
  5. Update Python version if needed (v15 requires 3.7+)
  6. 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.