Getting Started with T-Kassa Payment for Medusa

In this document, you’ll learn how to install and configure the T-Kassa payment provider by T-Bank for Medusa.

• Medusa v2.14.0 or later
• Node.js v20 or later
• A T-Business account with T-Kassa internet acquiring – sign in or create one

yarn add @gorgo/medusa-payment-tkassa

Add the provider configuration in your medusa-config.js file of the Medusa admin application:

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-tkassa/providers/payment-tkassa",
11            id: "tkassa",
12            options: {
13              terminalKey: process.env.TKASSA_TERMINAL_KEY,
14              password: process.env.TKASSA_PASSWORD,
15              capture: true,
16              useReceipt: true,
17              ffdVersion: "1.05",
18              taxation: "osn",
19              taxItemDefault: "none",
20              taxShippingDefault: "none"
21            },
22          }
23        ]
24      }
25    }
26  ]
27})

Add environment variables with your shop identifier TerminalKey and secret Password from your T-Business account:

.env
1TKASSA_TERMINAL_KEY=123456789
2TKASSA_PASSWORD=supersecret

To properly handle payment notifications from T-Kassa, configure webhooks in your T-Business account as following:

1. Navigate to Internet acquiring → Shops → Choose your shop → Terminals → Choose Testing or Working Terminal → Click Settings to open the setting window

2. Choose to send Notifications Via HTTP protocol

3. Add a URL like:

   https://$YOUR_MEDUSA_DOMAIN/hooks/payment/tkassa_tkassa

   Change {YOUR_MEDUSA_DOMAIN} with your medusa store domain.