Начало работы с Robokassa для Medusa

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

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

yarn add @gorgo/medusa-payment-robokassa

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

medusa-config.js
1// ...
2module.exports = defineConfig({
3  // ...
4  modules: [
5    {
6      resolve: "@medusajs/medusa/payment",
7      options: {
8        providers: [
9          {
10            resolve: "@gorgo/medusa-payment-robokassa/providers/payment-robokassa",
11            id: "robokassa",
12            options: {
13              merchantLogin: process.env.ROBOKASSA_MERCHANT_LOGIN,
14              hashAlgorithm: process.env.ROBOKASSA_HASH_ALGORITHM,
15              password1: process.env.ROBOKASSA_PASSWORD_1,
16              password2: process.env.ROBOKASSA_PASSWORD_2,
17              testPassword1: process.env.ROBOKASSA_TEST_PASSWORD_1,
18              testPassword2: process.env.ROBOKASSA_TEST_PASSWORD_2,
19              capture: false,  // по умолчанию true
20              isTest: true,    // по умолчанию false
21            },
22          }
23        ]
24      }
25    }
26  ]
27})

Добавьте следующие переменные окружения: идентификатор магазина merchantLogin, алгоритм подписи hashAlgorithm, секретные пароли password1, password2, а также тестовые пароли testPassword1, testPassword2:

.env
1ROBOKASSA_MERCHANT_LOGIN=test-shop
2ROBOKASSA_HASH_ALGORITHM=md5
3ROBOKASSA_PASSWORD_1=supersecret
4ROBOKASSA_PASSWORD_2=supersecret
5ROBOKASSA_TEST_PASSWORD_1=supersecret
6ROBOKASSA_TEST_PASSWORD_2=supersecret

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

В настройках магазина Robokassa укажите Метод отправки данных на Result URL - GET или POST, и задайте Result URL в формате:

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

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