medusa-payment-yookassa/README.md

YooKassa payment provider for Medusa

> ⚠️ **This package is deprecated and no longer maintained.**  
> It has moved to [`@gorgo/medusa-payment-yookassa`](https://www.npmjs.com/package/@gorgo/medusa-payment-yookassa) - please install the new package to keep receiving updates and fixes.

<p align="center">
  <a href="https://www.medusajs.com">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/9a99f9e8-f80e-4411-9bed-6e2032b1ab1c">
      <source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/9a99f9e8-f80e-4411-9bed-6e2032b1ab1c">
      <img alt="Medusa logo" src="https://github.com/user-attachments/assets/9a99f9e8-f80e-4411-9bed-6e2032b1ab1c" height="120">
    </picture>
  </a>
  
</p>

<h1 align="center">
YooKassa Payments for Medusa
</h1>

<p align="center">
  A Medusa plugin that provides YooKassa payments.
  <br/>
  <a href="https://docs.gorgojs.com/medusa-plugins/yookassa">Documentation ↗</a>
  <br/>
  <a href="https://github.com/sergkoudi/medusa-payment-yookassa/blob/HEAD/packages/medusa-payment-yookassa/README.ru.md">Читать README на русском ↗</a>
</p>

<br/>

<p align="center">
  <a href="https://medusajs.com">
    <img src="https://img.shields.io/badge/Medusa-^2.12.4-blue?logo=medusa" alt="Medusa" />
  </a>
  <a href="https://medusajs.com">
    <img src="https://img.shields.io/badge/Tested_with_Medusa-v2.13.4-green?logo=checkmarx" alt="Medusa" />
  </a>
</p>

<p align="center">
  <a href="https://t.me/gorgojs_chat">
    <img src="https://img.shields.io/badge/Telegram-Support_Chat-0088cc?logo=telegram&style=social" alt="Telegram Support Chat" />
  </a>
</p>

<p align="center">
  <a href="https://t.me/medusajs_chat">
    <img src="https://img.shields.io/badge/Telegram-Medusa.js_Dev_Community_Chat-0088cc?logo=telegram&style=social" alt="Medusa.js Chat on Telegram" />
  </a>
</p>

## Features

- 🔗  **Seamless integration** with the YooKassa payment system
- 🧾  **Receipt generation** compliant with Federal Law No. 54, supporting FFD 1.05 and 1.2 formats
- 1️⃣  **One-step** (autocapture) and  **2️⃣  two-step** (authorization/hold) payment flows
- 🔄  **Full refund** and **order cancellation** support
- 🔔  **Webhook support** for real-time payment status updates
- 🛡  **Webhook verification** for enhanced security
- 🔍  **Detailed logging** for debugging

## 💬  YooKassa Plugin Support Chat

Got questions or ideas for new plugin features?  
Join the Telegram chat – [@medusajs_yookassa](https://t.me/medusajs_yookassa)

## 👥  Medusa.js Community Chat

Connect with other Medusa developers on Telegram – [@medusajs_chat](https://t.me/medusajs_chat)

## Requirements

- Medusa v2.12.4 or later
- Node.js v20 or later
- A YooKassa account – [sign in or create one](https://yookassa.ru/joinups/?source=ks)

## Installation

```bash
yarn add medusa-payment-yookassa
# or
npm install medusa-payment-yookassa
```

## 📘  Documentation

The complete installation, configuration, and usage guide for this plugin is available on the [Gorgo documentation website](https://docs.gorgojs.com/medusa-plugins/yookassa).

## License

Licensed under the [MIT License](LICENSE).