Medusa v2.22.2 introduces an official beta Adyen payment provider, major search improvements, and a comprehensive round of dependency updates. Developers should note behavior changes in BigNumber and body-parser validation that may cause custom code to throw errors instead of returning fallback values.
Review custom calculations using BigNumber and middleware configuration files for body-parser size limits, as invalid values now throw runtime errors instead of silent fallbacks.
๐ Product & Engineering Leads
Merchants can now integrate directly with Adyen's payment platform in beta, expanding checkout capabilities.
โ๏ธ DevOps & Security
Ensure compatibility with updated project dependencies, including Vite v7.3.7 and broader infrastructure tooling upgrades.
โจ New Features & Capabilities (1)
Official Adyen payment provider module in beta for card payments, captures, and refunds
โก Performance & Enhancements (2)
Search enhancements and fixes for more reliable product and catalog search
Broad round of dependency updates including Vite v7.3.7, BigNumber 11, and body-parser 1.20.9
๐ง Bug Fixes & Patches (3)
Fixed payment session replacement issues and active payment preservation
Disabled payment providers removed from config on startup and reject webhooks for nonexistent providers
Fixed pricing overrides, inventory reservations, and order claim writing bugs
๐ View Raw Release Notes (Original Developer Log)
<!--

# v2.22.2: Adyen Payment Provider, Search Improvements, Dependency Updates
This release introduces an official Adyen payment provider alongside search improvements and a broad round of dependency updates that improve security and compatibility across the platform.
CMS_BREAK -->
## Highlights
### Adyen Payment Provider
Medusa now includes an official Adyen payment provider module in beta, enabling merchants to accept card payments through Adyen's payment platform. The provider integrates with Adyen's APIs to handle payment sessions, captures, and refunds within Medusa's payment workflows.
[#17577](https://github.com/medusajs/medusa/pull/17577)
---
### Search Improvements and Fixes
Several enhancements and fixes have been applied to Medusa's search functionality, making product and catalog search more reliable across Medusa applications.
[#17540](https://github.com/medusajs/medusa/pull/17540)
## Dependency Updates
This release includes a large round of dependency updates across the server, CLI, admin dashboard, and design system, including several major version upgrades. Most of them require no changes in your application, but note the following behavior changes:
* the Medusa admin now uses vite v7.3.7. If you have it installed in your project, make sure to update it as well.
* **`bignumber.js` 11:** `BigNumber` and `MathBN` from `@medusajs/framework/utils` now throw an error when they receive an invalid number, instead of returning `NaN`. Medusa validates amounts before they reach these helpers, so this only affects custom code that passes invalid values and relies on `NaN`:
```ts
import { BigNumber, MathBN } from "@medusajs/framework/utils"
// Before: NaN
// After: throws "[BigNumber Error] Not a number: abc"
MathBN.add("abc", 1)
new BigNumber("")
```
* **`body-parser` 1.20.9:** an invalid `bodyParser.sizeLimit` in a route's middleware configuration (for example, `"abc"`) now throws an error when the route is called, instead of silently disabling the size limit.
* **`@medusajs/ui-preset`:** the unused `@tailwindcss/forms` dependency was removed. If your Tailwind configuration loads `@tailwindcss/forms` without installing it yourself, add it to your project's dependencies.
For the full list of updated dependencies, refer to the following pull requests:
* [#17567](https://github.com/medusajs/medusa/pull/17567): major version updates for repo and dev tooling
* [#17572](https://github.com/medusajs/medusa/pull/17572): major dependency updates for admin and UI
* [#17575](https://github.com/medusajs/medusa/pull/17575): `bignumber.js` 11.1.5
* [#17517](https://github.com/medusajs/medusa/pull/17517): `multer` 2.5.0
* [#17535](https://github.com/medusajs/medusa/pull/17535): AWS SDK dependencies
* [#17533](https://github.com/medusajs/medusa/pull/17533): database and Redis drivers
* [#17532](https://github.com/medusajs/medusa/pull/17532): auth and telemetry dependencies
* [#17528](https://github.com/medusajs/medusa/pull/17528): admin dashboard and UI dependencies
* [#17527](https://github.com/medusajs/medusa/pull/17527): server and CLI dependencies
* [#17525](https://github.com/medusajs/medusa/pull/17525): dev packages
* [#17487](https://github.com/medusajs/medusa/pull/17487): patch dependencies
* [#17519](https://github.com/medusajs/medusa/pull/17519): `handlebars` 4.7.10
* [#17515](https://github.com/medusajs/medusa/pull/17515): `zod` 4.6.6 in `@medusajs/admin-sdk`
* [#17573](https://github.com/medusajs/medusa/pull/17573) and [#17523](https://github.com/medusajs/medusa/pull/17523): documentation dependencies
## Features
* feat: Implement Adyen as a payment provider by [@sradevski](https://github.com/sradevski) in [#17577](https://github.com/medusajs/medusa/pull/17577)
* feat: search improvements and fixes by [@sradevski](https://github.com/sradevski) in [#17540](https://github.com/medusajs/medusa/pull/17540)
## Bugs
* fix[adyen]: Ensure no capture override, only cards support until core improvements are done, better idempotency by [@sradevski](https://github.com/sradevski) in [#17579](https://github.com/medusajs/medusa/pull/17579)
* fix(core-flows): don't replace payment sessions with an active payment by [@shahednasser](https://github.com/shahednasser) in [#17536](https://github.com/medusajs/medusa/pull/17536)
* fix: Medusa payment changes to match the latest in Cloud by [@sradevski](https://github.com/sradevski) in [#17558](https://github.com/medusajs/medusa/pull/17558)
* fix(payment): disable payment providers removed from config on startup by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17545](https://github.com/medusajs/medusa/pull/17545)
* fix(medusa): reject webhooks for nonexistent providers by [@Mezzle](https://github.com/Mezzle) in [#17538](https://github.com/medusajs/medusa/pull/17538)
* fix(pricing): don't charge a sale price above a matching override price by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17530](https://github.com/medusajs/medusa/pull/17530)
* fix(inventory): don't re-add reserved quantity when restoring live reservations by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17509](https://github.com/medusajs/medusa/pull/17509)
* fix(order): don't write off claimed items more than once by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17510](https://github.com/medusajs/medusa/pull/17510)
* fix(promotion): reject null max_quantity for each and once allocations by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17514](https://github.com/medusajs/medusa/pull/17514)
* fix(orchestration): retry steps with retryIntervalAwaiting after they fail by [@medusa-agents](https://github.com/apps/medusa-agents) in [#17408](https://github.com/medusajs/medusa/pull/17408)
* fix(js-sdk): allow admin.upload.create in Node.js without FileList by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17505](https://github.com/medusajs/medusa/pull/17505)
* fix(caching): close the in-memory provider's cache client on shutdown by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17503](https://github.com/medusajs/medusa/pull/17503)
* fix(ui): stop long labels from shifting left in DataTable select filter options by [@NicolasGorga](https://github.com/NicolasGorga) in [#17543](https://github.com/medusajs/medusa/pull/17543)
* fix(medusa): stop logging user emails in super admin role migration script by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17494](https://github.com/medusajs/medusa/pull/17494)
* fix: re-apply changesets assemble-release-plan patch by [@shahednasser](https://github.com/shahednasser) in [#17546](https://github.com/medusajs/medusa/pull/17546)
* fix(ci): allow Actions artifact host in harden-runner egress allowlists by [@shahednasser](https://github.com/shahednasser) in [#17554](https://github.com/medusajs/medusa/pull/17554)
* fix(docs): resolve vulnerable dependencies and upgrade turbo to v2 by [@shahednasser](https://github.com/shahednasser) in [#17573](https://github.com/medusajs/medusa/pull/17573)
## Documentation
* docs: add next.js caching section to cloud docs, and how data migration errors are thrown by [@shahednasser](https://github.com/shahednasser) in [#17570](https://github.com/medusajs/medusa/pull/17570)
* docs: document pending preview environment states by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17566](https://github.com/medusajs/medusa/pull/17566)
* docs: document AI troubleshooting for failing custom domains by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17562](https://github.com/medusajs/medusa/pull/17562)
* docs: correct reservation handling in inventory fulfillment flow by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17549](https://github.com/medusajs/medusa/pull/17549)
* docs: clarify fractional inventory quantities don't apply to cart items by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17555](https://github.com/medusajs/medusa/pull/17555)
* docs: add webhooks changelog entry for private-address delivery blocking by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17498](https://github.com/medusajs/medusa/pull/17498)
* docs: doc changes for next release by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17430](https://github.com/medusajs/medusa/pull/17430)
* docs: disable source map upload for resources worker by [@shahednasser](https://github.com/shahednasser) in [#17524](https://github.com/medusajs/medusa/pull/17524)
* docs: update deps + some fixes by [@shahednasser](https://github.com/shahednasser) in [#17523](https://github.com/medusajs/medusa/pull/17523)
## Chores
* chore: major dependency updates for admin and UI by [@shahednasser](https://github.com/shahednasser) in [#17572](https://github.com/medusajs/medusa/pull/17572)
* chore: major version updates for repo and dev tooling by [@shahednasser](https://github.com/shahednasser) in [#17567](https://github.com/medusajs/medusa/pull/17567)
* chore(types,utils,dashboard): update bignumber.js to 11.1.5 by [@shahednasser](https://github.com/shahednasser) in [#17575](https://github.com/medusajs/medusa/pull/17575)
* chore(medusa): bump multer to ^2.5.0 by [@shahednasser](https://github.com/shahednasser) in [#17517](https://github.com/medusajs/medusa/pull/17517)
* chore: minor version bump for aws dependencies by [@shahednasser](https://github.com/shahednasser) in [#17535](https://github.com/medusajs/medusa/pull/17535)
* chore: minor version updates for database and redis drivers by [@shahednasser](https://github.com/shahednasser) in [#17533](https://github.com/medusajs/medusa/pull/17533)
* chore: update minor dependencies for auth and telemetry by [@shahednasser](https://github.com/shahednasser) in [#17532](https://github.com/medusajs/medusa/pull/17532)
* chore: minor dependency updates for admin dashboard and UI by [@shahednasser](https://github.com/shahednasser) in [#17528](https://github.com/medusajs/medusa/pull/17528)
* chore: update minor dependencies used in server and CLI by [@shahednasser](https://github.com/shahednasser) in [#17527](https://github.com/medusajs/medusa/pull/17527)
* chore: minor version updates for dev packages by [@shahednasser](https://github.com/shahednasser) in [#17525](https://github.com/medusajs/medusa/pull/17525)
* chore: automation hardening by [@shahednasser](https://github.com/shahednasser) in [#17520](https://github.com/medusajs/medusa/pull/17520)
* chore(ci): fix issue routing for Cloud docs, log classifier reasons, let docs agent run prep and lint by [@shahednasser](https://github.com/shahednasser) in [#17556](https://github.com/medusajs/medusa/pull/17556)
* chore(deps): bump handlebars from 4.7.8 to 4.7.10 by [@dependabot](https://github.com/apps/dependabot) in [#17519](https://github.com/medusajs/medusa/pull/17519)
* chore(deps): bump zod from 4.2.0 to 4.6.6 in /packages/admin/admin-sdk by [@dependabot](https://github.com/apps/dependabot) in [#17515](https://github.com/medusajs/medusa/pull/17515)
* chore(deps): update patch dependencies by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17487](https://github.com/medusajs/medusa/pull/17487)
* chore(docs): Generated References (automated) by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17492](https://github.com/medusajs/medusa/pull/17492)
* chore(docs): Update version in documentation (automated) by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17491](https://github.com/medusajs/medusa/pull/17491)
* chore(docs): Updated UI Reference (automated) by [@medusa-os-bot](https://github.com/apps/medusa-os-bot) in [#17490](https://github.com/medusajs/medusa/pull/17490)
**Full Changelog**: [v2.22.1...v2.22.2](https://github.com/medusajs/medusa/compare/v2.22.1...v2.22.2)