Платежные сервисы Яндекса для HostCMS

Инструкция по настройке

 

По этой инструкции можно настроить приём платежей через один из трех платёжных сервисов Яндекса — Яндекс.Кассу, Яндекс.Деньги или Яндекс.Платёжку.

Яндекс.Касса

Через Яндекс.Кассу доступны все популярные способы оплаты: банковские карты, электронные кошельки, наличные, интернет-банки, баланс мобильного и другие.

Это сервис для бизнеса: для работы с ним нужен договор, деньги будут поступать на расчетный счёт компании.

Подключить Кассу

Яндекс.Платёжка

Через Платёжку можно включить на сайте приём платежей с банковских карт и из электронных кошельков.

Это сервис для бизнеса: деньги будут приходить на расчётный счёт компании. Договор не нужен, но за работу формы нужно заплатить — 3 000 ₽ за 100 платежей.

Почитать про Платёжку

Яндекс.Деньги

Через Яндекс.Деньги можно включить на сайте приём платежей с банковских карт и из электронных кошельков. Деньги будут приходить в кошелёк на Яндексе, договор не нужен.

Создать кошелёк

 

Как настроить прием платежей через Яндекс.Кассу

Как настроить прием платежей через Яндекс.Деньги

Как настроить прием платежей через Яндекс.Платёжку

Как настроить прием платежей через Яндекс.Кассу

Чтобы настроить прием платежей по этой инструкции, нужно подключиться к Яндекс.Кассе и получить параметры shopId и Секретный ключ.

  • shopId появится в личном кабинете Кассы сам, когда вы подключитесь к сервису,
  • секретный ключ нужно самостоятельно выпустить и активировать в личном кабинете Кассы.

Когда у вас будут оба этих параметра, можно переходить к настройке приёма платежей по этой инструкции.

1. В панели управления сайтом откройте раздел Интернет-магазины, выберите ваш магазин и нажмите Справочники — Платёжные системы.

2. Наведите курсор на заголовок «Платёжная система» и нажмите Добавить.

3. Откроется страница настроек платежной системы.

Заполните поля на странице с помощью этой таблички.

НазваниеЯндекс.Касса
ВалютаРуб.
ОписаниеБанковские карты, электронные кошельки, интернет-банки и другие способы оплаты.
АктивностьПоставьте галочку
Обработчик

В это поле нужно вставить код из файла, который находится в архиве с модулем Яндекс.Кассы.

  1. Скачайте архив с модулем. В нём есть папка yandex-money и файл handlerXX.php.
  2. Папку yandex-money скопируйте в корневой каталог сайта на вашем хостинге.
  3. Код из файла handlerXX.php скопируйте в поле Обработчик и отредактируйте в нём следующие строчки по подсказкам из таблички.
protected $mode = self::

После двоеточий напишите MODE_KASSA. То есть, строчка должна выглядеть так:

protected $mode = self::MODE_KASSA

protected $ym_shopid = '000000';Вместо нулей подставьте свой shopId. Его можно скопировать в личном кабинете Яндекс.Кассы (он будет в левом верхнем углу каждой страницы).
protected $ym_password = 'abcde00000abcde00000';Между кавычек вместо abcde00000abcde00000 подставьте секретный ключ. Его нужно сгенерировать и активировать в личном кабинете Яндекс.Кассы.
protected $sendCheck = true;

Если вы подключали решение Яндекс.Кассы по 54-ФЗ, оставьте в строчке true.

Если вы не подключали решение Кассы, поставьте в строчке false.

Подробнее о решении Кассы для 54-ФЗ

protected $kassaTaxRateDefault = 0;

Оставьте эту строчку без изменений, если вы поставили false в предыдущей строчке (protected $sendCheck = false).

Отредактируйте эту строчку, если в предыдущей вы поставили true (protected $sendCheck = true): вместо нуля поставьте значение из списка, которое соответствует ставке НДС в вашем магазине. Например, если ваша ставка — 10%, вместо нуля нужно поставить 3.

  1. Без НДС
  2. 0%
  3. 10%
  4. 18%
  5. Расчётная ставка 10/110
  6. Расчётная ставка 18/118

Это будет ставка по умолчанию: она будет в чеке для товаров, у которых вы не указывали другой ставки.

protected $kassaTaxRates = array(
2 => 0,
5 => 0,
19 => 0,
20 => 0,
21 => 0,
); 

Если вы поставили false в строчке protected $sendCheck = false, оставьте эти строчки без изменений.

Если вы поставили true в строчке protected $sendCheck = true, нужно соотнести идентификаторы ставок НДС на вашем сайте (столбик слева) с идентификаторами ставок НДС в Яндекс.Кассе (столбик справа).

Идентификаторы ставок в Кассе:

  1. Без НДС
  2. 0%
  3. 10%
  4. 18%
  5. Расчётная ставка 10/110
  6. Расчётная ставка 18/118
protected $sendChangeStatusEmail = true;

Если вы хотите получать два письма об оплате (при изменении статуса заказа и при подтверждении оплаты от Яндекс.Кассы), оставьте в строке true.

Если вы хотите получать только одно письмо (после подтверждения оплаты), поставьте в строчке false.

4. Сохраните настройки и перейдите в раздел Интернет-магазины — Справочники — Платежные системы. Скопируйте число, которое будет написано рядом со словами «Яндекс.Касса».

5. Вернитесь в настройки платежной системы (два раза кликните по названию «Яндекс.Касса») и вставьте скопированное число вместо XX в поле «Обработчик». Конкретно — в эту строчку:

class Shop_Payment_System_HandlerXX extends Shop_Payment_System_Handler

Для примера представим, что вы скопировали и вставили в Обработчик число 12. Тогда строчка будет выглядеть так:

class Shop_Payment_System_Handler12 extends Shop_Payment_System_Handler

Внимание. 12 — это пример, у вас будет другое число.

6. Сохраните настройки еще раз. Готово, можно проверять прием платежей.

Как настроить прием платежей через Яндекс.Деньги

Чтобы настроить прием платежей по этой инструкции, вам нужен кошелек на Яндексе. Создать кошелёк

1. В панели управления сайтом откройте раздел Интернет-магазины, выберите ваш магазин и нажмите Справочники — Платёжные системы.

2. Наведите курсор на заголовок «Платёжная система» и нажмите Добавить.

3. Откроется страница настроек платежной системы.

Заполните поля на странице с помощью этой таблички.

НазваниеЯндекс.Касса
ВалютаРуб.
ОписаниеБанковские карты и кошельки Яндекс.Денег
Обработчик

В это поле нужно вставить код из файла, который находится в архиве с модулем Яндекс.Кассы.

  1. Скачайте архив с модулем. В нём есть папка yandex-money и файл handlerXX.php.
  2. Папку yandex-money скопируйте в корневой каталог сайта на вашем хостинге.
  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';

Между кавычек вставьте Секретное слово. Его нужно получить на сайте Яндекс.Денег:

  1. Перейдите на страницу уведомлений на сайте Яндекс.Денег.
  2. В поле сверху вставьте этот адрес: http://example.ru/shop/cart/ (вместо example.ru поставьте адрес вашего сайта)
  3. Поставьте галочку Отправлять уведомления и нажмите Сохранить внизу страницы.
  4. Когда страница обновится, нажмите Показать секрет. Сайт покажет комбинацию из 20 букв и цифр: вставьте её между кавычек в поле Обработчик.

4. Сохраните настройки и перейдите в раздел Интернет-магазины — Справочники — Платежные системы. Скопируйте число, которое будет написано рядом со словами «Яндекс.Деньги».

5. Вернитесь в настройки платежной системы (два раза кликните по названию «Яндекс.Деньги») и вставьте скопированное число вместо XX в поле «Обработчик» в строчку:

class Shop_Payment_System_HandlerXX extends Shop_Payment_System_Handler

Для примера представим, что вы скопировали и вставили в Обработчик число 12. Тогда строчка будет выглядеть так:

class Shop_Payment_System_Handler12 extends Shop_Payment_System_Handler

Внимание. 12 — это пример, у вас будет другое число.

6. Сохраните настройки еще раз. Готово, можно проверять прием платежей.

Как настроить прием платежей через Яндекс.Платёжку

Настройка приема платежей через Платежку состоит из трех этапов:

  1. На сайте Платежки получите настройки платежной формы.
  2. Вставьте форму к себе на сайт.
  3. Заплатите за работу формы.

Как создать платежную форму

1. На сайте Платежки заполните шаблон формы: в поле Название товара или услуги напишите «Оплата заказа». Поле Сумма заполнять не нужно, добавлять другие товары или дополнительные поля тоже не нужно — все уже учтено в вашей CMS.

Как выглядит шаблон формы

2. Нажмите Продолжить и на открывшейся странице заполните анкету компании. Нужно указать:

  • юридическое название и ИНН вашей компании,
  • реквизиты счета,
  • электронную почту: на нее будут приходить сообщения о платежах,
  • сайт, на котором вы планируете принимать платежи через Платежку.
Как выглядит анкета компании

3. Нажмите Создать форму. Реквизиты, сайт и другие данные, которые вы указали, отправятся на проверку. Она займет пару минут.

4. Если всё в порядке, вам придет электронное письмо с параметрами формы и реквизитами для лицензионного платежа.

Как выглядит письмо

Как вставить форму к себе на сайт

1. В панели управления сайтом нажмите Интернет-магазины, выберите ваш магазин и в появившемся окне нажмите Справочники — Платежные системы.

2. Наведите курсор на заголовок «Платежная система» и нажмите Добавить.

3. Заполните поля:

  • название: напишите «Яндекс.Платежка»,
  • валюта: поставьте «руб.»,
  • описание: напишите «Банковские карты и кошельки Яндекс.Денег»,
  • активность: поставьте галочку.

4. В это поле нужно вставить код из файла, который находится в архиве с модулем Яндекс.Кассы. В архиве есть папка yandex-money и файл handlerXX.php. Папку yandex-money скопируйте в корневой каталог сайта на вашем хостинге. Код из файла handlerXX.php скопируйте в поле Обработчик и отредактируйте в нём следующие строчки по подсказкам из таблички.

protected $mode = self::

После двоеточий напишите MODE_BILLING. То есть, строчка должна выглядеть так:

protected $mode = self::MODE_BILLING

protected $billingId = ''

Между кавычками напишите ID формы: этот параметр нужно скопировать из письма Платежки (оно пришло, когда вы собрали форму).

То есть, строчка должна выглядеть так:

protected $billingId = '1111111111'

Где 1111111111 — это ваш ID формы.

protected $billingPurpose = 'Номер заказа %order_id% Оплата через Яндекс.Платежку';Если нужно, отредактируйте текст между кавычками.Эта строчка отвечает за назначение платежа.
protected $billingChangeStatus = 0;После = (вместо 0) поставьте идентификатор статуса заказа в вашей системе, который будет присвоен заказу, для оплаты которого выбрали Платежку. Статус должен показать, что результат платежа неизвестен: заплатил клиент или нет, можно узнать только из уведомления в электронной почте.

6. Сохраните настройки и перейдите в раздел Интернет-магазины — Справочники — Платежные системы. Скопируйте число, которое будет написано рядом со словами «Яндекс.Платежка».

7. Вернитесь в настройки платежной системы (два раза кликните по названию «Яндекс.Платежка») и вставьте скопированное число вместо XX в поле «Обработчик» в строчку:

class Shop_Payment_System_HandlerXX extends Shop_Payment_System_Handler

Для примера представим, что вы скопировали и вставили в Обработчик число 12. Тогда строчка будет выглядеть так:

class Shop_Payment_System_Handler12 extends Shop_Payment_System_Handler

Внимание. 12 — это пример, у вас будет другое число.

8. Сохраните настройки еще раз. Осталось только оплатить работу формы — и можно принимать платежи.

Как будет выглядеть форма на вашем сайте

Как оплатить работу формы

  1. Откройте письмо с кодом формы и реквизитами для лицензионного платежа.
  2. Заплатите 3000 рублей по реквизитам с расчетного счета, на который будете принимать платежи (иначе платеж не зачтется).
  3. Как только деньги придут, мы активируем форму и пришлем вам письмо. Срок зависит от вашего банка, максимум — 3 дня.
  4. Сделайте тестовый платеж на небольшую сумму: проверьте, что форма работает, а деньги приходят на ваш счет.

Готово, можно принимать платежи.

Внимание. Один лицензионный платеж действует на все формы, которые вы соберете для своей компании (проверяем по ИНН, который вы указываете при создании формы). Ограничения по количеству и размеру платежей тоже действуют на все формы сразу.