Мибок: Касса для сайта (платежный модуль)

Содержание:

• Установка модуля
• Регистрация в ЮKassa
• Настройки
  • Настройки в личном кабинете ЮKassa
  • Настройки модуля во вкладке "ЮKassa (без модуля sale)"
  • Настройки модуля во вкладке "ЮKassa (c модулем sale)"
  • Настройка почтовых уведомлений
• Способы создания платежа
  • Форма оплаты
  • Создание платежа с использованием API
  • Создание платежа через обработчик платежной системы
• Принцип передачи информации о НДС в чеках
• Тестирование платежей
• Чеки зачета предоплаты
• Маркировка
• История платежей
• Детальная страница платежа и просмотр чеков
• Двухстадийные платежи
• Возврат
• Доступ к настройкам модуля и истории платежей

Установка модуля

1. Загрузите модуль
2. Нажмите кнопку "Установить"
3. После стандартной установки модуля перейдите в личный кабинет ЮKassa для предварительно настройки (если Вы это не делали ранее), а затем перейдите на страницу настроек модуля в админке Вашего сайта "Мибок → Мибок: Платежный модуль для сайта → Настройки оплаты".
   

   Обратите внимание, на всех редакциях Битрикс доступны вкладки настроек: "ЮKassa (без модуля sale)" и "Почтовые уведомления". А на редакциях "Малый бизнес" и "Бизнес" с установленным модулем "sale" также доступна вкладка "ЮKassa (c модулем sale)"

Регистрация в ЮKassa

Чтобы подключиться к ЮKassa нужно завести аккаунт.

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

  Внимание. Если вы самозанятый, сначала отправьте заявку на подключение с сайта ЮKassa и дождитесь, пока её одобрят (с вами свяжется менеджер). После этого можно регистрироваться в ЮKassa по инструкции.

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

Когда ЮKassa подпишет договор (это занимает от 1 до 3 рабочих дней), его можно будет скачать в личном кабинете. Если к этому времени вы уже выбрали готовое решение — можно перейти к настройкам модуля и принимать платежи.

Настройки в личном кабинете ЮKassa

1. Перейдите в личный кабинет ЮKassa на страницу "Интеграция — Готовые решения", выберете в списке систему "1С-Битрикс":
    
   
   

   После чего появится список доступных модулей из которого необходимо выбрать "Модуль от MIBok" и сохранить изменения:

   
   

2. Перейдите на страницу "Интеграция — Ключи API" и проверьте выводятся ли на ней секретный ключ. Если у Вас еще не выпущен "Секретный ключ для API", то выпустите его. Подробнее о работе с секретными ключами можно прочитать в инструкции.

3. Перейдите на страницу "Интеграция — HTTP-уведомления" и проверьте в поле "URL для уведомлений" адрес вида: https://адрес_вашего_сайта/bitrix/tools/mibok.pay/sale_ps_result.php или нет. При необходимости исправьте на правильный адрес.
   Кроме того проверьте установлены ли все галки на уведомления о событиях.  Обратите внимание, что без настроенных HTTP-уведомлений на Вашем сайте не будет обновляться информация о статусах платежей.

Настройки модуля во вкладке "ЮKassa (без модуля sale)"

Данный функционал можно использовать на любой редакции для организации приема платежей в 1 клик.
Перейдите на страницу "Мибок → Мибок: Платежный модуль для сайта → Настройки оплаты → вкладка ЮKassa (без модуля sale)". При отсутствии настроек эта вкладка выглядит следующим образом:

В поле "Введите shopId магазина из личного кабинета" Вам необходимо ввести полученный в ЮKassa shopID. Если у Вас их несколько, то каждый shopID, должен располагаться в новом поле. Далее необходимо нажать на кнопку "Сохранить", чтобы в новых появившихся полях заполнить всю необходимую информацию.

Для каждого добавленного shopID появятся следующие настройки:

• Секретный ключ. В данном поле необходимо указать секретный ключ, полученный в личном кабинете ЮKassa. Обратите внимание, что для тестирования выдается ключ с префиксом "test_"
• shopArticleId. Данный параметр является необязательным и при необходимости выдается при подключении к ЮKassa.
• Выбор способа оплаты. Возможные варианты: умный платеж, банковские карты, ЮMoney, Сбербанк Онлайн, Альфа-Клик, Тинькофф, QIWI Wallet, Webmoney, оплата наличными в терминале, оплата по частям. Рекомендуется выбирать вариант "Умный платеж", в этом случае выбор способа оплаты будет происходить покупателем непосредственно при оплате на стороне ЮKassa.
  Обратите внимание, что на тестовом аккаунте рабочими являются только следующие способы оплаты: умный платеж, банковские карты, ЮMoney. Все остальные способы при попытке оплатить будут выдавать ошибку.
• Код валюты. Необходимо указать обязательно в формате ISO-4217. Для рубля будет код "RUB".
• URL страницы возврата. В данном поле необходимо указать относительный URL, на который вернется пользователь после оплаты (нажав на кнопку "Вернуться в магазин"). В данном поле Вы можете указать как ссылку на любую страницу Вашего сайта, так и ссылку на страницу, на которой расположен компонент модуля "mibok:pay.yandexkassa.return". В случае использования этого компонента относительная ссылка обязательно должна содержать макрос #HASH#, например, /payment/return.php#HASH#
  Обратите внимание, что если Вы будете использовать один и тот же магазин для разных сайтов, указанный относительный URL страницы возврата должен быть на всех этих сайтах.
• Описание транзакции в личном кабинете ЮKassa. В данном поле Вы можете, используя определенный набор макросов, сформировать описание каждой транзакции в удобном для Вас виде.
• ФИО плательщика (для реестра ЮKassa). В данном поле Вы можете, используя определенный набор макросов, установить данные плательщика, которые будут отображаться у покупателя в деталях платежа, а также в реестре ЮKassa.
• Номер заказа (для реестра ЮKassa). В данном поле Вы можете, используя определенный набор макросов, установить информацию о номере заказа, которая будет отображаться у покупателя в деталях платежа, а также в реестре ЮKassa.
  Обратите внимание, значение данного поля должно быть уникальным, иначе может возникнуть проблема с оплатой созданного платежа.
  
• Адрес для уведомлений. В данном поле Вы можете скопировать URL адреса уведомлений, на который будет приходить информация о состоянии платежа. Это поле редактировать не требуется, а значение из него Вы можете установить в настройках личного кабинета ЮKassa.
• Двухстадийный платеж. Установка данной галки необходима только в том случае, если Вы хотите принимать платежи в 2 стадии:
  • Холдирование (предавторизация): пользователь вносит оплату, и деньги замораживаются — например, на его банковской карте или в электронном кошельке (зависит от способа, которым он платит).
  • Списание: замороженные деньги списываются по вашему запросу.
  Обратите внимание, что если Вы выбрали двухстадийный платеж, Вам необходимо будет вручную подтверждать платежи. Подробнее о данном функционале написано в разделе Двухстадийные платежи.
• Передача данных для формирования чека. Установка данной галки необходима только в том случае, если у Вас настроена на стороне ЮKassa получение информации о составе корзины с последующей передачей в арендованную онлайн-кассу (на зеленой плашке перед выводом секретного ключа, отображается информация в каком режиме работает Ваш магазин).
  Обратите внимание, что если у Вас на стороне ЮKassa подключена передача данных в онлайн-кассу, а галка не установлена или наоборот, галка установлена, а на стороне ЮKassa такого подключения нет, платежи на Вашем сайте не будут проходить.
  
  Если данная галка установлена, то появляются дополнительные поля для настройки:
  
  • Формат фискальных документов (ФФД). Возможные варианты для выбора: Онлайн-касса, обновленная до ФФД 1.05; Онлайн-касса, обновленная до ФФД 1.2 или чеки от ЮKassa. Обязательно установите именно ту версию ФФД, которую использует Ваша онлайн-касса, иначе могут возникнуть проблемы с отправкой чеков.
  • Ставка НДС. Возможные варианты для выбора: Без НДС, НДС по ставке 0%, НДС по ставке 10%, НДС чека по ставке 20%.
  • Система налогообложения магазина. Возможные варианты для выбора: общая система налогообложения, упрощенная (УСН, доходы), упрощенная (УСН, доходы минус расходы), единый налог на вмененный доход (ЕНВД), единый сельскохозяйственный налог (ЕСН), патентная система налогообложения.
  • Признак предмета расчета. Возможные варианты для выбора: товар, подакцизный товар, работа, услуга, ставка в азартной игре, выигрыш в азартной игре, лотерейный билет, выигрыш в лотерею, результаты интеллектуальной деятельности, платеж, агентское вознаграждение, имущественные права, внереализационный доход, страховой сбор, торговый сбор, курортный сбор, несколько вариантов, другое.
  • Признак способа расчета. Возможные варианты для выбора: полная предоплата, частичная предоплата, аванс, полный расчет, частичный расчет и кредит, кредит, выплата по кредиту.
  • Мера количества предмета расчета. Возможные варианты для выбора: Штука, Грамм, Килограмм, Тонна, Сантиметр, Дециметр, Метр, Квадратный сантиметр, Квадратный дециметр, Квадратный метр, Миллилитр, Литр, Кубический метр, Килловат-час, Гигакалория, Сутки, Час, Минута, Секунда, Килобайт, Мегабайт, Гигабайт, Терабайт, Другое.
    Обратите внимание, данный параметр нужно передавать, начиная с ФФД 1.2.
  • Формат кода маркировки товаров. Возможные варианты выбора:
    
    • Код товара в том виде, в котором он был прочитан сканером (тег — 2000)
    • Нераспознанный код товара (тег — 1300)
    • Код товара в формате EAN-8 (тег — 1301)
    • Код товара в формате EAN-13 (тег — 1302)
    • Код товара в формате ITF-14 (тег — 1303)
    • Код товара в формате GS1.0 (тег — 1304)
    • Код товара в формате GS1.M (тег — 1305)
    • Код товара в формате короткого кода маркировки (тег — 1306)
    • Контрольно-идентификационный знак мехового изделия (тег — 1307)
    • Код товара в формате ЕГАИС-2.0 (тег — 1308)
    • Код товара в формате ЕГАИС-3.0 (тег — 1309)
    Данное поле необходимо обязательно настроить, если Вы продаете товары, подлежащие маркировке и используете версию ФФД 1.2. В большинстве случаев подойдет вариант: "Код товара в формате GS1.M", но точное значение рекомендуем уточнить у Вашего поставщика онлайн-кассы.
  • Очищать неразрешенные символы в полях чека. Возможные варианты:
    • не изменять - при выборе данного варианта все символы будут попадать в чек;
      
    • касса Первый ОФД - при выборе данного варианта, символы неразрешенные в Первом ОФД будут заменяться на знак "_".
      
• Настройка Сбербанк Бизнес Онлайн. В случае подключения варианта платежа "Сбербанк Бизнес Онлайн", требуется активировать данную галку и внести дополнительные настройки:
  • Вид ставки НДС для Сбербанк Бизнес Онлайн. Варианты значения: Без НДС, Одна ставка у всех товаров.
  • Ставка НДС для Сбербанк Бизнес Онлайн. Варианты значения: 0%, 10%, 20%.

Примечание. Макрос #ANY_DATA#, доступный для настройки в полях "Описание транзакции в личном кабинете ЮKassa", "ФИО плательщика (для реестра ЮKassa)", "Номер заказа (для реестра ЮKassa)" можно задать только при создании платежа через методы API createPayment и createPaymentForMultiplePositions. В этот макрос Вы можете передать любую необходимую информацию.

Настройки модуля во вкладке "ЮKassa (c модулем sale)"

Данный функционал доступен только в редакциях "Малый бизнес" и "Бизнес" для оплаты товаров в интернет-магазине при оформлении заказа. Для настройки такого способа оплаты, Вам необходимо перейти на страницу добавления и настроек платежной системы "Магазин → Настройки → Платежные системы" самостоятельно или по ссылке со страницы "Мибок → Мибок: Платежный модуль для сайта → Настройки оплаты → вкладка ЮKassa (c модулем sale)":

Обратите внимание, что версия 1С-Битрикс у Вас должна быть 17.6.0 и выше.
Для корректной работы формирования чеков зачета предоплаты при данном способе платежа, обязательно заполните поля:

• Введите shopId магазина из личного кабинета. В данном поле необходимо ввести полученный в ЮKassa shopID (если их несколько, то каждый shopID должен располагаться в новом поле)
• При каком статусе заказа отправлять чек зачета предоплаты. В данном поле необходимо выбрать статус заказа, при котором будет отправляться чек зачета предоплаты. Отправка такого чека необходима если используется один из следующих способов расчета: полная предоплата, частичная предоплата, аванс. Подробнее о том что такое чек зачета предоплаты и в каких случаях он необходим можно найти в разделе Чеки зачета предоплаты. Рекомендуется выбирать финальный статус заказа "Выполнен" и не забывать переводить все действительно выполненные заказы в этот статус.
• При отсутствии маркировки товаров блокировать перевод заказа в статус, при котором отправляется чек зачета предоплаты. При установке данной галки, если в заказе будут товары, требующие указание маркировки, а в отгрузке маркировка не будет указана, то попытка перевода заказа в статус, отправляющий чек зачета предоплаты - будет неудачной.
• Устанавливать флаг проблемности заказа при отсутствии маркировки товаров. При установке данной галки, если в заказе будут товары, требующие указание маркировки, а в отгрузке маркировка не будет указана, то при попытке перевода заказа в статус, отправляющий чек зачета предоплаты, в заказе установится флаг "Проблема с заказом".
• Секретный ключ. В данном поле необходимо указать секретный ключ, полученный в личном кабинете ЮKassa. Обратите внимание, что для тестирования выдается ключ с префиксом "test_"
• Формат фискальных документов (ФФД). Возможные варианты для выбора: Онлайн-касса, обновленная до ФФД 1.05; Онлайн-касса, обновленная до ФФД 1.2 или чеки от ЮKassa. Обязательно установите именно ту версию ФФД, которую использует Ваша онлайн-касса, иначе могут возникнуть проблемы с отправкой чеков.
• Формат кода маркировки товаров. Возможные варианты выбора:
  • Код товара в том виде, в котором он был прочитан сканером (тег — 2000)
  • Нераспознанный код товара (тег — 1300)
  • Код товара в формате EAN-8 (тег — 1301)
  • Код товара в формате EAN-13 (тег — 1302)
  • Код товара в формате ITF-14 (тег — 1303)
  • Код товара в формате GS1.0 (тег — 1304)
  • Код товара в формате GS1.M (тег — 1305)
  • Код товара в формате короткого кода маркировки (тег — 1306)
  • Контрольно-идентификационный знак мехового изделия (тег — 1307)
  • Код товара в формате ЕГАИС-2.0 (тег — 1308)
  • Код товара в формате ЕГАИС-3.0 (тег — 1309)
  Данное поле необходимо обязательно настроить, если Вы продаете товары, подлежащие маркировке и используете версию ФФД 1.2. В большинстве случаев подойдет вариант: "Код товара в формате GS1.M", но точное значение рекомендуем уточнить у Вашего поставщика онлайн-кассы.
• Очищать неразрешенные символы в полях чека. Возможные варианты:
  • не изменять - при выборе данного варианта все символы будут попадать в чек;
  • касса Первый ОФД - при выборе данного варианта, символы неразрешенные в Первом ОФД будут заменяться на знак "_".

Обратите внимание, если на сайте используются оба варианты оплаты (с использованием модуля sale и без использования), то поля ввода shopId и секретного ключа идентичны и влияют друг на друга в обеих вкладках.

Настройка почтовых уведомлений

Модуль предусматривает возможность устанавливать какие почтовые уведомления может получать администратор сайта и покупатель. Для данной настройки необходимо перейти на страницу "Мибок → Мибок: Платежный модуль для сайта → Настройки оплаты → вкладка Почтовые уведомления":

Для администратора сайта возможно получение следующих писем: создание платежа, успешная оплата, отмена оплаты, ошибка оплаты, ошибка отправки чека зачета предоплаты (в случае проблемы с товарами, подлежащих маркировке).
При необходимости отредактировать вид почтового шаблона зайдите на страницу "Настройки → Настройки продукта → Почтовые и СМС события → Почтовые шаблоны" и найдите почтовый шаблон с типом события "[MIBOK_PAY_YANDEX_ADMIN] Mibok.Pay Почтовые уведомления для ЮKassa (для администратора)"

Для покупателя возможно получение следующих писем: создание платежа, успешная оплата, отмена оплаты.
При необходимости отредактировать вид почтового шаблона зайдите на страницу "Настройки → Настройки продукта → Почтовые и СМС события → Почтовые шаблоны" и найдите почтовый шаблон с типом события "[MIBOK_PAY_YANDEX_USER] Mibok.Pay Почтовые уведомления для ЮKassa (для покупателя)".
Обратите внимание, если при передаче данных в платежную систему отсутствует информация о E-mail'е покупателя, письмо получить он не сможет. Поэтому настоятельно рекомендуем в компоненте mibok:pay.yandexkassa.payment и/или платежной системе настроить передачу E-mail покупателя.

Способы создания платежа

На данный момент модуль предоставляет возможность создать платеж одним из следующих способов:

1. Форма оплаты. Данный способ оплаты доступен на любой редакции 1С-Битрикс.
   Для запуска платежей необходимо настроить модуль во вкладке "ЮKassa (без модуля sale)" (о настройках модуля можно прочитать здесь), а затем разместить компонент с формой оплаты (о настройке компонента можно прочитать здесь).
2. API. Данный способ оплаты доступен на любой редакции 1С-Битрикс.
   Для запуска платежей необходимо настроить модуль во вкладке "ЮKassa (без модуля sale)" (о настройках модуля можно прочитать здесьздесь).
3. Обработчик платежной системы. Данный способ оплаты доступен только для редакций, поддерживающих платформу e-commerce (интернет-магазин): Малый бизнес, Бизнем, Интернет-магазин + CRM.
   Для запуска платежей необходимо настроить модуль во вкладке "ЮKassa (c модулем sale)" (о настройках модуля можно прочитать здесь), а затем создать обработчик платежной системы (о создании и настройки обработчика можно прочитать здесь).

Форма оплаты

После того как Вы настроили все необходимые параметры ЮKassa, Вам необходимо в публичной части сайта в нужном Вам месте разместить компонент "Форма оплаты" (mibok:pay.yandexkassa.payment) со следующими настройками:

• Выберите ShopID магазина в ЮKassa. Выбрав ShopID из сохраненных Вами ранее на странице "Мибок → Мибок: Платежный модуль для сайта → Настройки оплаты → вкладка ЮKassa (без модуля sale)".
• Источник данных о товаре. На данный момент предусмотрены следующие варианты:
  - Данные о товаре и сумме покупатель не сможет отредактировать. Этот вариант не позволяет покупателю отредактировать информацию о покупке, а значит он может совершить платеж только за фиксированную стоимость.
  - Редактируемые покупателем поля формы. Этот вариант позволяет покупателю отредактировать информацию о покупке и ее стоимости. Такой вариант удобен, например, для сайтов со сбором пожертвований.
• Содержание заказа. В данном поле указывается информация о содержимом заказа (товара), который будет приобретать покупатель.
• Сумма заказа. В данном поле указывается сумма заказа, которую будет оплачивать покупатель.
• Подпись валюты. В данном поле указывается в произвольном виде подпись валюты, в которой будет оплачивать покупку покупатель.
• Согласие пользователя. В данном блоке настраивается вывод блока с соглашением на обработку персональных данных (сам текст соглашения и галочка о принятии), в соответствии с 152-ФЗ.

• Информация о покупателе. В данном блоке выводятся поля, которые перед оплатой должен заполнить покупатель. Рекомендуем Вам, чтобы пользователь заполнял как минимум поля: Имя и E-mail.
• Подписи к полям и кнопкам. В данном блоке настраиваются подписи к следующим полям:
  - Подпись кнопки оплаты
  - Название поля о товаре
  - Название поля о сумме заказа
  

Создание платежа с использованием API

При условии настройки оплаты для приема платежей в 1 клик, Вы можете создавать оплаты, используя API. Для этого предусмотрено 2 метода: createPayment и createPaymentForMultiplePositions.
В случае необходимости создавать оплату всего с 1 товаром и в количестве 1 штука, рекомендуем воспользоваться методом createPayment, для этого Вам необходимо сделать следующий запрос:

$shopID = '<Идентификатор магазина>'; //shopID из ЛК ЮKassa
$obKassa = new \Mibok\Pay\Yookassa($shopID, '<Адрес сайта>', SITE_DIR);
$params = array(
    'FIO' => 'Иванов Иван Иванович',
    'EMAIL' => 'yandex@yandex.ru',
    'ITEM' => 'Тестовый товар',
    'SUM' => '1.00',
    'payment_method_data' => 'bank_card',
    'USER_ID' => 1,

    // Опционально; доступно, начиная с версии модуля 1.6.2:
    'ANY_DATA' => 'Любые данные (строка)',
    'vat_code' => '3',
    'payment_subject' => 'job',
    'measure' => 'ton',

    // Доступно, начиная с версии модуля 1.7.0; необходим, если Вас товар подлежит маркировке:
    'marking' => '330460406000590021N4N57RTCBUZTQ\u001d2403054002410161218\u001d1424010191ffd0\u001g92tIAF/YVpU4roQS3M/m4z78yFq0nc/WsSmLeX6QkF/YVWwy5IMYAeiQ91Xa2m/fFSJcOkb2N+uUUtfr4n0mOX0Q==',
    'code_field_marking' => 'mark_code_raw',
);
$res = $obKassa->createPayment($params);

В случае необходимости создавать платеж с несколькими товарами, Вам необходимо воспользоваться методом createPaymentForMultiplePositions, для этого Вам необходимо сделать следующий запрос:

$shopID = '<Идентификатор магазина>'; //shopID из ЛК ЮKassa
$obKassa = new \Mibok\Pay\Yookassa($shopID, '<Адрес сайта>', SITE_DIR);
$params = array(
    'FIO' => 'Иванов Иван Иванович',
    'EMAIL' => 'yandex@yandex.ru',
    'ITEMS' => [
        [
            'QUANTITY' => 5,
            'PRICE' => 10,
            'NAME' =>
            'Товар 1',

             // Опционально; доступно, начиная с версии модуля 1.6.2:
            'vat_code' => '3',
            'payment_subject' => 'job',
            'measure' => 'ton',

             // Доступно, начиная с версии модуля 1.7.0; необходим, если Вас товар подлежит маркировке:
             'marking' => '330460406000590021N4N57RTCBUZTQ\u001d2403054002410161218\u001d1424010191ffd0\u001g92tIAF/YVpU4roQS3M/m4z78yFq0nc/WsSmLeX6QkF/YVWwy5IMYAeiQ91Xa2m/fFSJcOkb2N+uUUtfr4n0mOX0Q==',
             'code_field_marking' => 'mark_code_raw',
        ],
        [
            'QUANTITY' => 6.23,
            'PRICE' => 15, 
            'NAME' =>
            'Товар 2'
        ]
    ],
    'payment_method_data' => 'bank_card',
    'USER_ID' => 1,

    // Опционально; доступно, начиная с версии модуля 1.6.2:
    'ANY_DATA' => 'Любые данные (строка)'
);
$res = $obKassa->createPaymentForMultiplePositions($params);

Все элементы массива $params обязательные, кроме:

• USER_ID  - В данном параметре можно передавать ID авторизованного пользователя.
• ANY_DATA - В данном параметре можно передавать данные для макроса #ANY_DATA#
• vat_code - В данном параметре можно передавать данные кода ставки НДС. Если передано значение, то настройка "Ставка НДС" на странице "Мибок → Мибок: Платежный модуль для сайта → Настройки оплаты → вкладка ЮKassa (без модуля sale)" будет проигнорирована. Список кодов доступен по ссылке.
• payment_subject -  В данном параметре можно передавать признак предмета расчета. Если передано значение, то настройка "Признак предмета расчета" на странице "Мибок → Мибок: Платежный модуль для сайта → Настройки оплаты → вкладка ЮKassa (без модуля sale)" будет проигнорирована. Список кодов доступен по ссылке.
• measure - В данном параметре можно передавать меру количества предмета расчета. Если передано значение, то настройка "Мера количества предмета расчета" на странице "Мибок → Мибок: Платежный модуль для сайта → Настройки оплаты → вкладка ЮKassa (без модуля sale)" будет проигнорирована. Список кодов доступен по ссылке.
• marking -  В данном параметре нужно передавать маркировку товара (если товар ей подлежит) в формате, который соответствует настройке "Формат фискальных документов (ФФД)" и "Формат кода маркировки товаров" на странице "Мибок → Мибок: Платежный модуль для сайта → Настройки оплаты → вкладка ЮKassa (без модуля sale)".
• code_field_marking - В данном параметре можно передавать формат кода маркировки товаров. Если передано значение, то настройка "Формат кода маркировки товаров" на странице "Мибок → Мибок: Платежный модуль для сайта → Настройки оплаты → вкладка ЮKassa (без модуля sale)" будет проигнорирована. Список кодов доступен по ссылке.

Для payment_method_data существуют следующие варианты:

• bank_card - банковская карта
• yoo_money- ЮMoney
• sberbank - SberPay (ex-СберБанк Онлайн)
• tinkoff_bank - T-Pay (в приложении Т-Банка)
• sbp - СБП (Система быстрых платежей)
• b2b_sberbank - СберБанк Бизнес Онлайн
• sber_loan - «Покупки в кредит» от СберБанка
• cash - Наличные
  

Вся остальная необходимая информация для формирования оплаты, в том числе отправка чека берется из настроек модуля.

Переменная $res при успешном создании оплаты получает массив вида:

(
    [status] => success
    [url] => https://yoomoney.ru/payments/checkout/confirmation?orderId=...
)

Именно на пришедший url нужно перенаправить покупателя для совершения оплаты на стороне ЮKassa.

Переменная $res при ошибке создании оплаты получает массив вида:

(
    [status] => error
    [url] => 'К сожалению, произошла ошибка и временно возможность оплаты не доступна.Приносим свои извинения'
)

Настройка оплаты через обработчик платежной системы

Для настройки такого способа оплаты, Вам необходимо перейти на страницу добавления и настроек платежной системы "Магазин → Настройки → Платежные системы" самостоятельно или по ссылке со страницы "Мибок → Мибок: Платежный модуль для сайта → Настройки оплаты → вкладка ЮKassa (c модулем sale)". Нажмите на кнопку "Добавить платежную систему" и на открывшейся странице выберите пользовательский обработчик "ЮKassa с поддержкой 54-ФЗ (mibokyandexkassa):"

Настройка данной платежной системы похожа на настройку платежной системы, поставляемой из коробки Битрикса, поэтому прежде всего рекомендуем Вам ознакомиться с обучающим уроком на сайте 1С-Битрикс.

Для выбора типа платежной системы доступны следующие варианты: умный платеж, банковские карты, ЮMoney, SberPay (ex-Сбербанк Онлайн), T-Pay (ex-Тинькофф),  наличные, "покупки в кредит" от Сбербанка, b2b платежи через Сбербанк Бизнес Онлайн, СБП (Система Быстрых Платежей). Рекомендуется выбирать вариант "Умный платеж", в этом случае выбор способа оплаты будет происходить покупателем непосредственно при оплате на стороне ЮKassa.
Обратите внимание, что на тестовом аккаунте рабочими являются только следующие способы оплаты: умный платеж, банковские карты, ЮMoney. Все остальные способы при попытке оплатить будут выдавать ошибку.

При настройке общих данных платежной системы, Вам необходимо убрать 2 галочки "Разрешить печать чеков" и "Открывать в новом окне".

Настройка обработчика платежной системы похожа на настройку оплаты для случая без использования модуля sale, которая описана выше:

• Автоматически оплачивать заказ при получении успешного статуса оплаты. При установленной галке как только на сайт будет поступать информация об успешной оплате, заказ автоматически будет оплачиваться.
• Автоматический редирект на форму оплаты. При установленной галке при переходже покупателя на страницу успешно оформленного заказа, будет привходиться редирект на страницу оплаты в ЮKassa.
  
• shopId. Необходимо ввести полученный в ЮKassa shopID.
• Секретный ключ. В данном поле необходимо указать секретный ключ, полученный в личном кабинете ЮKassa. Обратите внимание, что для тестирования выдается ключ с префиксом "test_"
• shopArticleId. Данный параметр является необязательным и при необходимости выдается при подключении к ЮKassa.
• Описание транзакции. В данном поле Вы можете, используя определенный набор макросов, сформировать описание каждой транзакции в удобном для Вас виде.
• ФИО плательщика (для реестра ЮKassa). Выбирается из каких параметров будет браться информация о плательщике, которая будет отображаться у покупателя в деталях платежа, а также в реестре ЮKassa.
• Номер заказа (для реестра ЮKassa). Выбирается из каких параметров будет браться информация о номере заказа, которая будет отображаться у покупателя в деталях платежа, а также в реестре ЮKassa.
• URL страницы возврата. В данном поле необходимо указать полный путь, на который вернется пользователь после оплаты (нажав на кнопку "Вернуться в магазин"). В данном поле Вы можете указать как ссылку на любую страницу Вашего сайта, так и ссылку на страницу, на которой расположен компонент модуля "mibok:pay.yandexkassa.return". В случае использования этого компонента ссылка обязательно должна содержать макрос #HASH#, например, https://адрес_вашего_сайта/payment/return.php#HASH#
  Кроме того предусмотрен также следующий набор макросов: #PAYMENT_ID# - ID оплаты; #ORDER_ID# - ID заказа; #PAYMENT_NUMBER# - номер оплаты; #ORDER_NUMBER# - номер заказа
• Адрес для уведомлений. В данном поле Вы можете скопировать URL адреса уведомлений, на который будет приходить информация о состоянии платежа. Это поле редактировать не требуется, а значение из него Вы можете установить в настройках личного кабинета ЮKassa.
• Двухстадийный платеж. Установка данной галки необходима только в том случае, если Вы хотите принимать платежи в 2 стадии:
  • Холдирование (предавторизация): пользователь вносит оплату, и деньги замораживаются — например, на его банковской карте или в электронном кошельке (зависит от способа, которым он платит).
  • Списание: замороженные деньги списываются по вашему запросу.
  Обратите внимание, что если Вы выбрали двухстадийный платеж, Вам необходимо будет вручную подтверждать платежи. Подробнее о данном функционале написано в разделе Двухстадийные платежи.
• Отправлять чеки в онлайн-кассу. Установка данной галки необходима только в том случае, если у Вас настроена на стороне ЮKassa получение информации о составе корзины с последующей передачей в арендованную онлайн-кассу.
  Обратите внимание, что если у Вас на стороне ЮKassa подключена передача данных в онлайн-кассу, а галка не установлена или наоборот, галка установлена, а на стороне ЮKassa такого подключения нет, платежи на Вашем сайте не будут проходить.
  Если данная галка установлена, то обязательно необходимо сделать следующие настройки:
  
  • Название покупателя. Выбирается из каких параметров будет браться информация о покупателе (ФИО или название компании).
  • E-mail покупателя. Выбирается из каких параметров будет браться информация о E-mail покупателя.
  • Телефон покупателя. Выбирается из каких параметров будет браться информация о телефоне покупателя.
  • ИНН покупателя. Выбирается из каких параметров будет браться информация о ИНН покупателя.
  • Система налогообложения магазина. Возможные варианты для выбора: общая система налогообложения, упрощенная (УСН, доходы), упрощенная (УСН, доходы минус расходы), единый налог на вмененный доход (ЕНВД), единый сельскохозяйственный налог (ЕСН), патентная система налогообложения.
  • Признак способа расчета. Возможные варианты для выбора: полная предоплата, частичная предоплата, аванс, полный расчет, частичный расчет и кредит, кредит, выплата по кредиту.
  • НДС на товары и НДС на доставку. Возможные варианты для выбора: Без НДС, НДС по ставке 0%, НДС по ставке 10%, НДС чека по ставке 20%.
  • Признак предмета расчета товара и Признак предмета расчета доставки. Возможные варианты для выбора: товар, подакцизный товар, работа, услуга, ставка в азартной игре, выигрыш в азартной игре, лотерейный билет, выигрыш в лотерею, результаты интеллектуальной деятельности, платеж, агентское вознаграждение, имущественные права, внереализационный доход, страховой сбор, торговый сбор, курортный сбор, несколько вариантов, другое.
  • Мера количества предмета расчета товаров и Мера количества предмета расчета доставки. Возможные варианты для выбора: Штука, Грамм, Килограмм, Тонна, Сантиметр, Дециметр, Метр, Квадратный сантиметр, Квадратный дециметр, Квадратный метр, Миллилитр, Литр, Кубический метр, Килловат-час, Гигакалория, Сутки, Час, Минута, Секунда, Килобайт, Мегабайт, Гигабайт, Терабайт, Другое. Обратите внимание, данный параметр нужно передавать, начиная с ФФД 1.2.
    
    Кроме того поле Мера количества предмета расчета товаров может иметь вариант: "Брать из информации в товаре (единица измерения)". В случае, выбора этого варианта, Вам необходимо в обязательном порядке настроить соответствие единиц измерения между ЮKassa и 1С-Битрикс. Для этого Вам необходимо, перейти на страницу "Мибок → Мибок: Платежный модуль для сайта → Настройки оплаты → вкладка Единицы измерения (для модуля sale)" и настроить соответствие между единицами измерения ЮKassa (левая колонка) и существующими единицами измерения на Вашем сайте (правая колонка с выпадающими списками). О том как отредактировать или создать единицы измерения, можете прочитать в документации 1С-Битрикс.
    
• Настройка Сбербанк Бизнес Онлайн. В случае подключения варианта платежа "Сбербанк Бизнес Онлайн", требуется внести дополнительные настройки:
  • Вид ставки НДС для Сбербанк Бизнес Онлайн. Варианты значения: Без НДС, Одна ставка у всех товаров.
  • Ставка НДС для Сбербанк Бизнес Онлайн. Варианты значения: 0%, 10%, 20%.
• Объединение позиций в заказе. В некоторых случаях может потребоваться объединить все товары в 1 товар, ввиду наличия ограничений на количество товаров в одном чеке, которые есть у некоторых онлайн-касс. Такая ситуация может возникать, например, при продаже таких товаров, как семена, которых обычно очень много в одном заказе. В случае наличия такой ситуации, Вы можете объединить все товары корзины покупателя в один объединенный товар, в итоге у Вас в чеке будет всего 2 товара: объединенный и доставка. Для активации объединения позиций в заказе необходимо установить соответствующую галку "Объединять позиции в заказе", а также настроить следующие параметры:
  • Имя для объединенных позиций. В данном поле необходимо задать шаблон имени объединенного товара. Доступно использование следующих макросов: #PAYMENT_ID# - ID оплаты; #ORDER_ID# - ID заказа; #PAYMENT_NUMBER# - номер оплаты; #ORDER_NUMBER# - номер заказа.
  • НДС на товары. Данная настройка аналогична настройке "НДС на товары" в блоке "Настройки отправки чеков". Обратите внимание, что НДС будет устанавливаться одна общая.
  • Мера количества предмета расчета товаров. Данная настройка аналогична настройке "Мера количества предмета расчета товаров" в блоке "Настройки отправки чеков".
  
  

Принцип передачи информации о НДС в чеках

В случае, если в настройках модуля и/или платежной системы была выбрана ставки НДС 10% или 20% и при этом признак способа расчета: полная предоплата, частичная предоплата или аванс, в первый чек (о покупке) будет передана информация о ставке НДС 10/110 (если в настройках выбрано НДС 10%) или 20/120 (если в настройках выбрано НДС 20%). Во втором чеке (о доставке/чек зачета предоплаты ) будет информация об НДС, исходя из настроек, то есть 10% или 20%.

Тестирование платежей

Перед приемом платежей рекомендуется проверить интеграцию в тестовом магазине ЮKassa. Тестовый магазин появится в личном кабинете ЮKassa после того, как вы укажете ИНН и заполните технические настройки. Он имеет свой идентификатор и секретный ключ с префиксом test_.
Подробнее о тестировании Вы можете прочитать в инструкции ЮKassa. При тестировании доступны следующие способы оплаты:

• "Умный платеж" (выбор способа оплаты на странице ЮKassa)
  
• Оплата банковской картой
• Оплата из кошелька в ЮMoney.

Чеки зачета предоплаты

С 1 июля 2019 года владельцы онлайн-касс должны пробивать чеки на зачет (или возврат) предоплаты или аванса. Формирование чека зачета предоплаты необходимо в тех случаях, когда товар или услуга оплачивается заранее (способы расчета: полная предоплата, частичная предоплата, аванс). Например, в интернет-магазине покупатель оплатил товар, но доставили ему его спустя время.

Для платежей, осуществленных без использования модуля интернет-магазина, такие чеки можно выбивать только вручную. Для платежей, осуществленных через платежную систему (с использованием модуля интернет-магазина), чеки зачета предоплаты можно формировать как вручную, так и автоматически.

Для автоматического формирования чека зачета предоплаты перейдите на страницу настроек и заполните необходимые поля.
Для ручного формирования чека, перейдите на детальную страницу платежа.
Обратие внимание, что функционал чеков зачета предоплаты доступен только в случаях, если Вы воспользовались сервисом отправки чеков через ЮKassa.

Маркировка

В соответствии с Федеральным законом № 487-ФЗ (от 31 декабря 2017 года) товары подлежат обязательной маркировке, согласно утвержденному перечню. О том как работать с маркировкой в интернет-магазине, можете прочитать в документации 1С-Битрикс.
Модуль предоставляет возможность отправить маркировку при создании платежа на API модуля, и при отправке чека зачета предоплаты (для платежей, совершенных через обработчик платежной системы).

Для cоздания платежа с использованием API модуля во вкладке "ЮKassa (без модуля sale)" необходимо настроить следующие поля (подробно настройках написано <a href="#setting_nosale">здесь</a>):

• Формат фискальных документов (ФФД)
• Формат кода маркировки товаров (в случае версии ФФД 1.2)