Tkassa

TKassa Payments for Medusa

A Medusa plugin that provides TKassa payments.

Prerequisites

• Medusa server v2.7.0 or later
• Node.js v20 or later
• TKassa account

Installation

123
yarn add @gorgo/medusa-payment-tkassa
# or
npm install @gorgo/medusa-payment-tkassa

Configuration

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

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

Add environment variables with your shop identifier Copy to clipboardTerminalKey and secret Copy to clipboardPassword:

12
TKASSA_TERMINAL_KEY=123456789
TKASSA_PASSWORD=supersecret

Under terminal settings in your TBank account, set notifications to “Via HTTP protocol” and supply a callback URL in the following format:

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

Storefront Integration

Make the necessary changes to your Medusa storefront. You can refer to the modifications made in the Medusa Next.js Starter Template, which are located in the Copy to clipboardexamples/medusa-storefront directory.

To view the specific changes, visit the comparison page, open the "Files changed" tab, and explore the differences under the Copy to clipboardexamples/payment-tkassa/medusa-storefront directory. Or run diff in the terminal:

123
git clone https://github.com/gorgojs/medusa-plugins
cd medusa-plugins
git diff @gorgo/medusa-payment-tkassa@0.0.1...main -- examples/payment-tkassa/medusa-storefront

Development

Find documentation on bootstrapping a development environment here.

💬 Support & Community on Telegram

Join the Medusa Telegram community chat to discuss features, get support, and connect with developers building on Medusa.

License

Licensed under the MIT License.