Migrating the YooKassa plugin to the @gorgo scope

The YooKassa payment plugin for Medusa has moved into the medusa-plugins monorepo and is now published as @gorgo/medusa-payment-yookassa. The plugin's functionality remains unchanged, but its development and support processes have become considerably more robust.

What is YooKassa

YooKassa is an online acquiring service by Yandex. It allows online stores to accept payments by card, as well as via SBP, SberPay, Mir Pay, YooMoney, and other methods. You can find more information on the YooKassa website.

Why we moved the plugin

We have consolidated all of our Medusa plugins into a single monorepo. This provides several advantages:

• All integration plugins in one place: A single codebase, common tooling, and the same quality requirements across every @gorgo/* package.
• Daily test runs: Every plugin goes through unit, integration, and contract tests against the APIs of the integrated services each day, and is checked for compatibility with the latest Medusa release. This lets us catch problems before you run into them.
• Faster support and development: Fixes and new features reach release sooner, and handling your questions and bug reports becomes simpler.

What changed

For you as a user, only the package name changes. The set of options and the plugin's functionality stay the same. You can read about all of the plugin's capabilities in the documentation.

At the same time, we have made the plugin more reliable. We covered it with tests and set up daily checks for compatibility with the latest Medusa release and the current YooKassa API.

Changes in the package
1- medusa-payment-yookassa           # before
2+ @gorgo/medusa-payment-yookassa    # after

The old medusa-payment-yookassa package has been marked as deprecated. It stays on npm until the end of 2026 but will no longer be supported. To keep receiving updates, we recommend moving to the new package now.

How to migrate

The migration consists of changing the package name and reinstalling it.

Step 1. Install the new package

npm install @gorgo/medusa-payment-yookassa

Step 2. Update medusa-config.js

Replace the provider path with the new one, prefixed with @gorgo/, in your medusa-config.js file:

medusa-config.js
1module.exports = defineConfig({
2  // ...
3  modules: [
4    {
5      resolve: "@medusajs/medusa/payment",
6      options: {
7        providers: [
8          {
9            resolve: "@gorgo/medusa-payment-yookassa/providers/payment-yookassa",
10            id: "yookassa",
11            options: {
12              // ... the same options
13            },
14          },
15        ],
16      },
17    },
18  ],
19})

Step 3. Remove the old package

npm uninstall medusa-payment-yookassa

The migration is now complete, and no further changes are required. A full installation and configuration guide is available in the documentation.

Support and the Medusa Telegram community

Ask questions and discuss Medusa in the Telegram community, report plugin issues in the Gorgo support chat, or open Issues and Pull Requests on GitHub.