В этом документе вы узнаете, как установить и настроить платежный провайдер ЮKassa для Medusa.

• Medusa v2.7.0 или новее
• Node.js v20 или новее
• Аккаунт ЮKassa – зарегистрируйтесь или войдите

yarn add medusa-payment-yookassa
# или
npm install medusa-payment-yookassa

Добавьте конфигурацию провайдера в файл medusa-config.js в приложении Medusa Admin:

// ...
module.exports = defineConfig({
  // ...
  modules: [
    {
      resolve: "@medusajs/medusa/payment",
      options: {
        providers: [
          {
            resolve: "medusa-payment-yookassa/providers/payment-yookassa",
            id: "yookassa",
            options: {
              shopId: process.env.YOOKASSA_SHOP_ID,
              secretKey: process.env.YOOKASSA_SECRET_KEY,
              capture: true,
              paymentDescription: "Test payment",
              useReceipt: true,
              useAtolOnlineFFD120: true,
              taxSystemCode: 1,
              taxItemDefault: 1,
              taxShippingDefault: 1
            },
          }
        ]
      }
    }
  ]
})

Добавьте следующие переменные окружения: идентификатор магазина shopId и секретный ключ secretKey:

YOOKASSA_SHOP_ID=1234567
YOOKASSA_SECRET_KEY=live_secret_api_key

Чтобы корректно обрабатывать платёжные уведомления от ЮKassa, настройте URL вебхука в своём аккаунте ЮKassa следующим образом:

1. Перейдите в личный кабинет ЮKassa по адресу yookassa.ru/my/merchant/integration/http-notifications
2. Добавьте новый URL вебхука в следующем формате:

   https://{YOUR_MEDUSA_DOMAIN}/hooks/payment/yookassa_yookassa

   Замените {YOUR_MEDUSA_DOMAIN} на домен вашей витрины Medusa.

ЮKassa будет отправлять обновления статуса платежей на этот URL, что позволяет Medusa обновлять статус платежа соответствующим образом.

Внимание! ЮKassa ожидает сообщение OK в ответе, чтобы подтвердить успешную обработку вебхука. В настоящее время Medusa не поддерживает кастомные ответные сообщения вебхуков «из коробки», но сами вебхуки обрабатываются корректно и без этого.