Платежные сервисы ЮMoney для HostCMS
 
Инструкция по настройке
По этой инструкции можно настроить приём платежей через один из платёжных сервисов ЮMoney — ЮKassa или ЮMoney.
ЮKassa
Через ЮKassa доступны все популярные способы оплаты: банковские карты, электронные кошельки, наличные, интернет-банки, баланс мобильного и другие.
Это сервис для бизнеса: для работы с ним нужен договор, деньги будут поступать на расчетный счёт компании.
ЮMoney
Через ЮMoney можно включить на сайте приём платежей с банковских карт и из электронных кошельков. ЮMoney будут приходить в кошелёк ЮMoney, договор не нужен.
 
Как настроить прием платежей через ЮKassa
Чтобы настроить прием платежей по этой инструкции, нужно подключиться к ЮKassa и получить параметры
shopId
и
Секретный ключ
.
  • shopId
    появится в личном кабинете ЮKassa сам, когда вы подключитесь к сервису,
  • секретный ключ
    нужно самостоятельно выпустить и активировать в личном кабинете ЮKassa.
Когда у вас будут оба этих параметра, можно переходить к настройке приёма платежей по этой инструкции.
  1. В панели управления сайтом откройте раздел Интернет-магазины, выберите ваш магазин и нажмите Справочники — Платёжные системы.
  2. Наведите курсор на заголовок «Платёжная система» и нажмите Добавить.
  3. Откроется страница настроек платежной системы.
    Заполните поля на странице с помощью этой таблички.
    НазваниеЮKassa
    ВалютаРуб.
    ОписаниеБанковские карты, электронные кошельки, интернет-банки и другие способы оплаты.
    АктивностьПоставьте галочку
    Обработчик
    В это поле нужно вставить код из файла, который находится в архиве с модулем ЮKassa.
    1. Скачайте архив с модулем. В нём есть папка yoomoney и файл handlerXX.php.
    2. Папку yoomoney скопируйте в корневой каталог сайта на вашем хостинге.
    3. Код из файла handlerXX.php скопируйте в поле Обработчик и отредактируйте в нём следующие строчки по подсказкам из таблички.
    protected $mode = self::
    После двоеточий напишите
    MODE_KASSA
    . То есть, строчка должна выглядеть так:
    protected $mode = self::MODE_KASSA
    protected $ym_shopid = '000000';
    Вместо нулей подставьте свой
    shopId
    . Его можно скопировать в личном кабинете ЮKassa (он будет в левом верхнем углу каждой страницы).
    protected $ym_password = 'abcde00000abcde00000';
    Между кавычек вместо abcde00000abcde00000 подставьте секретный ключ. Его нужно сгенерировать и активировать в личном кабинете ЮKassa.
    protected $sendCheck = true;
    Если вы подключали решение ЮKassa по 54-ФЗ, оставьте в строчке true.
    Если вы не подключали решение ЮKassa, поставьте в строчке false.
    protected $kassaTaxRateDefault = 0;
    Оставьте эту строчку без изменений, если вы поставили false в предыдущей строчке (
    protected $sendCheck = false
    ).
    Отредактируйте эту строчку, если в предыдущей вы поставили true (
    protected $sendCheck = true
    ): вместо нуля поставьте значение из списка, которое соответствует ставке НДС в вашем магазине. Например, если ваша ставка — 10%, вместо нуля нужно поставить 3.
    1. Без НДС
    2. 0%
    3. 10%
    4. 20%
    5. Расчётная ставка 10/110
    6. Расчётная ставка 20/120
      Это будет ставка по умолчанию: она будет в чеке для товаров, у которых вы не указывали другой ставки.
    protected $kassaTaxRates = array (2 => 0, 5 => 0, 19 => 0, 20 => 0, 21 => 0, );
    Если вы поставили false в строчке
    protected $sendCheck = false
    , оставьте эти строчки без изменений.
    Если вы поставили true в строчке
    protected $sendCheck = true
    , нужно соотнести идентификаторы ставок НДС на вашем сайте (столбик слева) с идентификаторами ставок НДС в ЮKassa (столбик справа).
    Идентификаторы ставок в ЮKassa:
    1. Без НДС
    2. 0%
    3. 10%
    4. 20%
    5. Расчётная ставка 10/110
    6. Расчётная ставка 20/120
    protected $sendChangeStatusEmail = true;
    Если вы хотите получать два письма об оплате (при изменении статуса заказа и при подтверждении оплаты от ЮKassa), оставьте в строке true.
    Если вы хотите получать только одно письмо (после подтверждения оплаты), поставьте в строчке false.
  4. Сохраните настройки и перейдите в раздел Интернет-магазины — Справочники — Платежные системы. Скопируйте число, которое будет написано рядом со словами «ЮKassa».
  5. Вернитесь в настройки платежной системы (два раза кликните по названию «ЮKassa») и вставьте скопированное число вместо XX в поле «Обработчик». Конкретно — в эту строчку:
    class Shop_Payment_System_HandlerXX extends Shop_Payment_System_Handler
    Для примера представим, что вы скопировали и вставили в Обработчик число 12. Тогда строчка будет выглядеть так:
    class Shop_Payment_System_Handler12 extends Shop_Payment_System_Handler
    Внимание. 12 — это пример, у вас будет другое число.
  6. Сохраните настройки еще раз. Готово, можно проверять прием платежей.
 
Как настроить прием платежей через ЮMoney
Чтобы настроить прием платежей по этой инструкции, вам нужен кошелёк ЮMoney. Создать кошелёк
  1. В панели управления сайтом откройте раздел Интернет-магазины, выберите ваш магазин и нажмите Справочники — Платёжные системы.
  2. Наведите курсор на заголовок «Платёжная система» и нажмите Добавить.
  3. Откроется страница настроек платежной системы.
    Заполните поля на странице с помощью этой таблички.
    НазваниеЮKassa
    ВалютаРуб.
    ОписаниеБанковские карты и кошельки ЮMoney
    Обработчик
    В это поле нужно вставить код из файла, который находится в архиве с модулем ЮKassa.
    1. Скачайте архив с модулем. В нём есть папка yoomoney и файл handlerXX.php.
    2. Папку yoomoney скопируйте в корневой каталог сайта на вашем хостинге.
    3. Код из файла handlerXX.php скопируйте в поле Обработчик и отредактируйте в нём следующие строчки по подсказкам из таблички.
    protected $mode = self::
    После двоеточий напишите
    MODE_MONEY
    . То есть, строчка должна выглядеть так:
    protected $mode = self::MODE_MONEY
    protected $ym_account = '';
    Между кавычками напишите номер кошелька, в который хотите получать деньги. То есть, строчка должна выглядеть так:
    protected $ym_account = '1234567890';
    Где
    1234567890
    — это номер вашего кошелька.
    protected $ym_hash_secret = 'abcde00000abcde00000';
    Между кавычек вставьте Секретное слово. Его нужно получить на сайте ЮMoney:
    1. Перейдите на страницу уведомлений на сайте ЮMoney.
    2. В поле сверху вставьте этот адрес: http://example.ru/shop/cart/ (вместо example.ru поставьте адрес вашего сайта)
    3. Поставьте галочку Отправлять уведомления и нажмите Сохранить внизу страницы.
    4. Когда страница обновится, нажмите Показать секрет. Сайт покажет комбинацию из 20 букв и цифр: вставьте её между кавычек в поле Обработчик.
  4. Сохраните настройки и перейдите в раздел Интернет-магазины — Справочники — Платежные системы. Скопируйте число, которое будет написано рядом со словами «ЮMoney».
  5. Вернитесь в настройки платежной системы (два раза кликните по названию «ЮMoney») и вставьте скопированное число вместо XX в поле «Обработчик» в строчку:
    class Shop_Payment_System_HandlerXX extends Shop_Payment_System_Handler
    Для примера представим, что вы скопировали и вставили в Обработчик число 12. Тогда строчка будет выглядеть так:
    class Shop_Payment_System_Handler12 extends Shop_Payment_System_Handler
    Внимание. 12 — это пример, у вас будет другое число.
  6. Сохраните настройки еще раз. Готово, можно проверять прием платежей.