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

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

yarn add @gorgo/medusa-payment-robokassa
# или
npm install @gorgo/medusa-payment-robokassa

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

// ...
module.exports = defineConfig({
  // ...
  modules: [
    {
      resolve: "@medusajs/medusa/payment",
      options: {
        providers: [
          {
            resolve: "@gorgo/medusa-payment-robokassa/providers/payment-robokassa",
            id: "robokassa",
            options: {
              merchantLogin: process.env.ROBOKASSA_MERCHANT_LOGIN,
              hashAlgorithm: process.env.ROBOKASSA_HASH_ALGORITHM,
              password1: process.env.ROBOKASSA_PASSWORD_1,
              password2: process.env.ROBOKASSA_PASSWORD_2,
              testPassword1: process.env.ROBOKASSA_TEST_PASSWORD_1,
              testPassword2: process.env.ROBOKASSA_TEST_PASSWORD_2,
              capture: false,  // по умолчанию true
              isTest: true,    // по умолчанию false
            },
          }
        ]
      }
    }
  ]
})

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

ROBOKASSA_MERCHANT_LOGIN=test-shop
ROBOKASSA_HASH_ALGORITHM=md5
ROBOKASSA_PASSWORD_1=supersecret
ROBOKASSA_PASSWORD_2=supersecret
ROBOKASSA_TEST_PASSWORD_1=supersecret
ROBOKASSA_TEST_PASSWORD_2=supersecret

Важно! Значение ROBOKASSA_HASH_ALGORITHM должно совпадать с настройкой в аккаунте Робокасса и быть одним из: md5, sha1, sha256, sha384, sha512 или ripemd160 (обратите внимание: для ripemd160 возможны ошибки на стороне провайдера).

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

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

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

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