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

• Medusa v2.7.0 или новее
• Node.js v20 или новее
• Аккаунт Т-Бизнес с подключённым интернет-эквайрингом Т-Касса – зарегистрируйтесь или войдите

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

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

// ...
module.exports = defineConfig({
  // ...
  modules: [
    {
      resolve: "@medusajs/medusa/payment",
      options: {
        providers: [
          {
            resolve: "@gorgo/medusa-payment-tkassa/providers/payment-tkassa",
            id: "tkassa",
            options: {
              terminalKey: process.env.TKASSA_TERMINAL_KEY,
              password: process.env.TKASSA_PASSWORD,
              capture: true,
              useReceipt: true,
              ffdVersion: "1.05",
              taxation: "osn",
              taxItemDefault: "none",
              taxShippingDefault: "none"
            },
          }
        ]
      }
    }
  ]
})

Добавьте переменные окружения TerminalKey и Password из личного кабинета Т-Бизнес:

TKASSA_TERMINAL_KEY=123456789
TKASSA_PASSWORD=supersecret

Чтобы корректно обрабатывать платёжные уведомления от Т-Касса, настройте вебхуки в своём аккаунте T-Business следующим образом:

1. Перейдите в раздел Интернет-эквайринг → Магазины → Выберите свой магазин → Терминалы → Выберите Тестовый или Рабочий терминал → Нажмите Настройки, чтобы открыть окно настроек.

2. Установите отправку уведомлений По протоколу HTTP.

3. Укажите URL вида:

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

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

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