ЮMoney — это модуль для интеграции интернет-магазина с платёжными сервисами ЮMoney. **ЮKassa**: позволяет принимать платежи на расчетный счет и делать возвраты (по договору, для юрлиц и ИП). **ЮMoney**: позволяет принимать платежи на кошелёк ЮMoney (без заключения договора, для всех). За техническую поддержку и обновление модуля отвечает компания «ЮMoney».

1. Скачайте архив с модулем. [Для OpenCart 2.0.x — 2.1.x (zip, 975 КБ)](https://git.yoomoney.ru/projects/CMS/repos/cms-opencart2/raw/yoomoney.oc20x21x.ocmod.zip) [Для OpenCart 2.2.x (zip, 975 КБ)](https://git.yoomoney.ru/projects/CMS/repos/cms-opencart2/raw/yoomoney.oc22x.ocmod.zip) [Для OpenCart 2.3.x (zip, 998 КБ)](https://git.yoomoney.ru/projects/CMS/repos/cms-opencart2/raw/yoomoney.oc23x.ocmod.zip) [Для OpenCart 3.x (zip, 995 КБ)](https://git.yoomoney.ru/projects/CMS/repos/cms-opencart3/raw/yoomoney.oc3x.ocmod.zip) 2. В панели управления выберите пункт меню **Модули — Установка расширений**. ![](kassa/support/instructions-opencart2-01.png) 3. Нажмите **Загрузить** и выберите скачанный архив. Когда архив загрузится, нажмите **Продолжить**. 4. В панели управления выберите **Модули**, затем — **Модификаторы**. Нажмите **Обновить** — голубой квадрат в правом верхнем углу. Дождитесь надписи **«Действие успешно выполнено!»**. ![](kassa/support/instructions-opencart2-02.png) 5. В левом меню выберите **Модули — Модули/Расширения**. В разделе **Тип расширения** выберите **Оплата**. Откроется список платежных расширений. Найдите в нем **ЮMoney** и нажмите **Активировать** (зеленый квадрат справа). ![](kassa/support/instructions-opencart2-03.png) 6. Когда появится надпись «Настройки успешно обновлены», можно переходить к настройке модуля.

1. Скачайте архив модуля. Выберите тот архив, номер которого соответствует версии OpenCart (проверить версию можно в кабинете администратора внизу страницы). [[20х21х]](https://git.yoomoney.ru/projects/CMS/repos/cms-opencart2/raw/yoomoney.oc20x21x.ocmod.zip) [[22х]](https://git.yoomoney.ru/projects/CMS/repos/cms-opencart2/raw/yoomoney.oc22x.ocmod.zip) [[23х]](https://git.yoomoney.ru/projects/CMS/repos/cms-opencart2/raw/yoomoney.oc23x.ocmod.zip) [[3х]](https://git.yoomoney.ru/projects/CMS/repos/cms-opencart3/raw/yoomoney.oc3x.ocmod.zip) 2. Загрузите скачанный архив в раздел **Модули/Расширения — Установка Расширений**. 3. В разделе **Модули/Расширения** зайдите в **Модификаторы** и нажмите **Обновить**.

1. [Подключите ЮKassa](/yooid/signup/step/phone?origin=Checkout&returnUrl=https%3A%2F%2Fyookassa.ru%2Fjoinups) 2. Если магазин к модулю ещё не подключен, нажмите на **Подключить магазин**. ![](kassa/support/instructions-opencart2-35.png) Если магазин подключен и вы хотите его поменять или переподключить, нажмите **Сменить магазин**. ![](kassa/support/instructions-opencart2-36.png) 3. Откроется всплывающее окно. Если не открылось, возможно, браузер его заблокировал — разрешите открывать всплывающие окна на этом сайте. 4. Разрешите выдать доступ к ЮKassa. ![](kassa/support/instructions-opencart2-37.png) 5. Выберите магазин, который хотите подключить к модулю. 6. Введите код из смс → всплывающее окно закроется и появятся данные по подключенному магазину. Если вышла ошибка, перезагрузите страницу и войдите в ЮKassa ещё раз. ![](kassa/support/instructions-opencart2-38.png)

1. В панели управления сайтом нажмите **Модули — Модули/Расширения**. В списке **Выберите тип расширения** поставьте «Оплата». 2. Откроется список платежных расширений. Найдите в нем **ЮMoney** и нажмите **«Редактировать»** (синий квадрат с карандашиком справа). ![](kassa/support/instructions-opencart2-04.png) 3. Откройте вкладку ЮKassa. Поставьте галочку **Включить прием платежей через ЮKassa**. 4. Заполните поля **shopId** и **Секретный ключ**: оба параметра можно взять в личном кабинете ЮKassa. 5. Отметьте удобный сценарий выбора способа оплаты: * На стороне ЮKassa, * На стороне магазина. 6. **Если вы выбрали сценарий оплаты «на стороне магазина»**, поставьте галочки напротив тех способов оплаты, которые указаны в вашем договоре с ЮMoney. ![](kassa/support/instructions-opencart2-07.png) 7. В поле **Название платежного сервиса** напишите «ЮKassa (банковские карты, электронные деньги и др)». ![](kassa/support/instructions-opencart2-08.png) 8. **Если вы настраивали отправку чеков в налоговую через партнеров ЮKassa** (по 54-ФЗ), включите отправку данных для чека. Затем укажите, какую ставку НДС ставить в чеке. * **Ставка по умолчанию** будет в чеке для товаров, у которых вы не указывали НДС раньше, * **Ставки, которые уже есть в вашем магазине**, нужно сопоставить со ставками в ЮKassa. [Помощь ЮKassa: отправка чеков по 54-ФЗ](/docs/support/payments/tax-sync) ![](kassa/support/instructions-opencart2-09.png) 9. Чтобы фискальные документы соответствовали ФФД 1.05, настройте **Признак способа расчёта** и **Признак предмета расчёта**. ![](kassa/support/instructions-opencart2-10.png) **Признак способа расчёта (способ расчёта)** — это категория способа, которым вы принимаете оплату (оплата в кредит, предоплата, полный расчёт и т.д.) **Признак предмета расчёта (предмет расчёта)** — это категория товаров и услуг, которые вы продаёте (товар, услуга, ставка в игре и т.д.) В настройках модуля значения этих параметров задаются отдельно для товаров и для доставки. **Второй чек** Когда вы настроили всё для 54-ФЗ, можно перейти ко второму чеку. Если включить эту опцию, модуль будет формировать закрывающий чек. Это произойдёт автоматически, если в заказе есть позиции с полной предоплатой, и этот заказ перешёл в выбранный статус. Например, «Завершён». ![](kassa/support/instructions-opencart2-11.png) В истории заказа появится запись об отправке второго чека. 10. В поле «Статус заказа после оплаты» укажите статус, который будет присвоен заказу, который оплатили через ЮKassa. ![](kassa/support/instructions-opencart2-12.png) 11. По желанию включите «Выставление счетов по электронной почте» и настройте шаблон письма. После этого сможете одной кнопкой отправлять счета на оплату заказов, которые сделаны на вашем сайте.

С помощью модуля ЮKassa можно автоматически выставлять счета на оплату заказов, оставленных на вашем сайте. Заказчикам будут приходить электронные письма с суммой, кнопкой «Заплатить» и всеми способами оплаты, которые вы подключали.

**Шаг 1.** Настройте шаблон письма:

**Тема**

По умолчанию в теме стоит **«Оплата заказа %order_id%»**, где номер заказа (значение %order_id% ) подставляется автоматически. Этот текст можно менять. Если хотите добавить в тему название магазина, напишите вместо него %shop_name% (как на скриншоте ниже) — значение будет ставиться автоматически.

**Дополнительный текст**

Это текст, который будет в письме под суммой и кнопкой **«Заплатить»**. Напишите там важную для покупателей информацию: например, номер службы поддержки. Поле можно оставить пустым — тогда в письме будет только счет.

![](kassa/support/instructions-opencart2-13.png)

**Шаг 2.** Поставьте галочку **«Добавить к письму логотип магазина»** — с ним покупатель быстрее поймет, от кого пришло письмо. Сохраните настройки.

**Шаг 1.** В левом меню панели управления выберите раздел **«Продажи»**, затем — **«Заказы»**.

![](kassa/support/instructions-opencart2-14.png)

**Шаг 2.** Найдите нужный заказ (можно использовать фильтр сверху) и нажмите зеленую кнопку напротив его номера. В окне подтверждения нажмите **«ОК»**.

**Шаг 3.** Готово — счет отправлен на почту, которую покупатель указал при оформлении заказа.

Пример счета:

![](kassa/support/instructions-opencart2-14-1.png)

**Шаг 4.** Когда покупатель оплатит счет, статус этого заказа в списке изменится.

![](kassa/support/instructions-opencart2-17.png)

12. Когда закончите, прокрутите страницу наверх и нажмите **Сохранить** — синий квадрат с иконкой дискеты. Готово — можно проверять прием платежей.

1. В левом меню выберите **«Продажи»**, затем — **«Заказы»**. В списке заказов найдите нужный (если список большой, используйте фильтр сверху). ![](kassa/support/instructions-opencart2-19.png) 2. В поле **«Действия» (Action)** в строчке с заказом кликните по зеленому значку **«Управление заказом»**. ![](kassa/support/instructions-opencart2-20.png) 3. Укажите сумму возврата. Напишите причину, по которой возвращаете деньги — это ваше сообщение для клиента. 4. Нажмите **«Сделать возврат»**. Если всё в порядке, вы увидите сообщение **«Платеж успешно возвращен»**. Если возврат не прошел — сообщение об ошибке. ![](kassa/support/instructions-opencart2-21.png)

Если включена отложенная оплата, платеж банковской картой проходит в два этапа: 1. При оформлении заказа на сайте банк блокирует нужную сумму на карте клиента. 2. Магазин подтверждает платеж или возвращает деньги клиенту. В таком случае, если заказ отменится или товара не будет в наличии, магазин сможет легко вернуть деньги. Комиссии за такой возврат нет. **Как включить холдирование** 1. Перейдите в раздел **Модули / Расширения**. ![](kassa/support/instructions-opencart2-22.png) 2. Выберите в выпадающем списке тип расширения **«Оплата»**. ![](kassa/support/instructions-opencart2-23.png) 3. В списке расширений найдите модуль ЮMoney и нажмите кнопку **«Редактировать»**. ![](kassa/support/instructions-opencart2-24.png) 4. Откроются настройки модуля. Здесь нужно установить галочку напротив пункта **«Включить отложенную оплату»**, чтобы включить функцию. Когда функция включена, у заказов появляются новые статусы: «Ожидает подтверждения» и «Отменён». Статусы нужно настроить в форме, которая появится после включения отложенной оплаты. Потом не забудьте **сохранить настройки**. ![](kassa/support/instructions-opencart2-25.png) **Как подтвердить или отменить платёж** 1. Перейдите в раздел **Заказы**. ![](kassa/support/instructions-opencart2-26.png) 2. В списке заказов найдите тот, который ожидает подтверждения. У него будет кнопка **«Подтверждение платежа»**. Нажмите её, чтобы перейти в форму подтверждения или отмены платежа. ![](kassa/support/instructions-opencart2-27.png) 3. В этой форме отображается основная информация о платеже. Есть две кнопки: **«Подтвердить платёж»** и **«Отменить платёж»**. Для подтверждения платежа нажмите **«Подтвердить платёж»**. Чтобы отменить платёж, нажмите кнопку **«Отменить платёж»**. Действие происходит сразу после нажатия кнопки.

B2B-платежи в ЮKassa позволяют принимать на сайте оплату от юридических лиц. 1. После установки модуля ЮKassa найдите в списке платёжных модулей «ЮKassa: Сбербанк Бизнес Онлайн», и убедитесь, что он активирован. Если нет — нажмите кнопку «Активировать». ![](kassa/support/instructions-opencart2-29.png) 2. Чтобы B2B-платежи через Сбербанк Бизнес Онлайн работали, включите эту опцию в настройках модуля: ![](kassa/support/instructions-opencart2-30.png) 3. Укажите налоговую ставку, которая будет передаваться в Сбербанк Бизнес Онлайн, если в карточке товара не указана другая ставка. ![](kassa/support/instructions-opencart2-31.png) Внимание. При оплате через Сбербанк Бизнес Онлайн есть ограничение: в одном заказе могут быть только товары с одинаковой ставкой НДС. Если клиент положит в корзину товары с разными ставками — мы покажем ему сообщение, что оплатить их одним чеком не получится. 4. Сопоставьте ставки НДС в вашем магазине со ставками, которые будут передаваться в Сбербанк Бизнес Онлайн. ![](kassa/support/instructions-opencart2-32.png) 5. После настройки B2B-платежей не забудьте сохранить изменения. При оплате через Сбербанк Бизнес Онлайн информация о плательщике записывается в историю заказа.

С помощью этого модуля можно принимать платежи без договора, в кошелёк ЮMoney. 1. В панели управления сайтом нажмите **Модули — Модули/Расширения**. В списке **Выберите тип расширения** поставьте «Оплата». 2. Откроется список платежных расширений. Найдите в нем **ЮMoney** и нажмите **«Редактировать»** (синий квадрат с карандашиком справа). ![](kassa/support/instructions-opencart2-04.png) 3. Откройте вкладку **«ЮMoney»**. Поставьте галочку **«Включить прием платежей в кошелёк ЮMoney»**. ![](kassa/support/instructions-opencart2-33.png) 4. В поле **«Номер кошелька»** укажите номер кошелька ЮMoney, в который будут поступать деньги. 5. Значения **«ID приложения»** и **«Секретное слово»** нужно получить на сайте ЮMoney. Для этого [пройдите по ссылке](https://yoomoney.ru/transfer/myservices/http-notification) и заполните поля: * **«Название»** — это название вашего магазина. Его увидит пользователь. * **«Адрес сайта»** — это сайт, на котором вы будете принимать платежи. * **«Email для связи»** — ваша электронная почта. * **«Redirect URI»** — это RedirectURL в настройках модуля (просто скопируйте эту ссылку). * **«Логотип»** загружать необязательно, но с ним пользователи быстрее узнают ваш сервис. * **«Использовать проверку подлинности приложения»** — обязательно поставьте галочку. Когда заполните все поля на странице регистрации, нажмите **«Подтвердить»**. Сайт сгенерирует **ID** и **«Секретное слово»**: скопируйте их в настройки модуля. 6. В поле **Название платежного сервиса** напишите «ЮMoney (банковские карты, кошельки ЮMoney)». 7. В поле **Статус заказа после оплаты** укажите, какой статус присваивать заказам, которые оплатили через ЮMoney. ![](kassa/support/instructions-opencart2-34.png) 8. Остальные настройки заполняйте по желанию. Когда закончите, прокрутите страницу наверх и нажмите **Сохранить** — синий квадрат с иконкой дискеты. Готово, можно проверять прием платежей.