Начало работы с Т-Касса для Medusa (v2.0.0-beta)

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

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

yarn add @gorgo/medusa-integration @gorgo/medusa-payment-tkassa@beta

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

medusa-config.js
1# ...
2const TKASSA_INTEGRATION_ID = "tkassa-1"
3
4module.exports = defineConfig({
5  # ...
6  plugins: [
7    # ...
8    {
9      resolve: "@gorgo/medusa-integration",
10      options: {
11        encryptionKey: process.env.INTEGRATION_ENCRYPTION_KEY,
12        providers: [
13          {
14            resolve: "@gorgo/medusa-payment-tkassa/providers/integration-tkassa",
15            id: TKASSA_INTEGRATION_ID,
16            options: {},
17          },
18        ],
19      },
20    },
21    {
22      resolve: "@gorgo/medusa-payment-tkassa",
23      options: {},
24    },
25  ],
26  modules: [
27    # ...
28    {
29      resolve: "@medusajs/medusa/payment",
30      options: {
31        providers: [
32          {
33            resolve: "@gorgo/medusa-payment-tkassa/providers/payment-tkassa",
34            id: "tkassa",
35            options: {
36              id: TKASSA_INTEGRATION_ID
37            }
38          },
39        ],
40      },
41    },
42  ],
43})

Добавьте переменную окружения с секретным ключом шифрования:

.env
INTEGRATION_ENCRYPTION_KEY=supersecret

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

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

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

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

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

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