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

• Medusa v2.7.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
# or
npm install @gorgo/medusa-payment-tkassa

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

# ...
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"
            },
          }
        ]
      }
    }
  ]
})

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

TKASSA_TERMINAL_KEY=123456789
TKASSA_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.