Содержание:


Описание модуля

Модуль позволяет производить оплату на сайте с использованием платежной системы Яндекс.Касса по новому протоколу API на любой редакции Битрикса. Поддерживает ФЗ-54 посредством передачи данных для чека в Яндекс.Кассу.

Поддерживаются следующие способы оплаты: умный платеж, банковские карты, Яндекс.Деньги, Сбербанк Онлайн, Альфа-Клик, Тинькофф, QIWI Wallet, Webmoney, оплата наличными в терминале, оплата по частям.

mibok.pay

Возможности:

  • Гибкие настройки
  • Поддержка оплаты на любой редакции Битрикс
  • Поддержка нескольких ShopID
  • Поддержка ФЗ-54 (передача данных чека в формате ФФД 1.05 через Яндекс.Кассу для дальнейшей передачи партнерам) и ФЗ-152 (возможность вывода блока с соглашением на обработку персональных данных)
  • Формирование чека зачета предоплаты
  • Подробная информация об отправленных чеках
  • Поддержка уведомлений о создании платежа, успешной оплате, отмене платежа.

Требования для работы модуля

  1. Активная лицензия CMS 1С-Битрикс.
  2. Наличие личного кабинета в Яндекс.Кассе. При его отсутствии Вам необходимо зарегистрироваться.
  3. Наличие на сайте сертификата безопасности SSL. Для его получения можете обратиться к нам.
  4. Битрикс версии не менее 17.6.0, php не менее 7.1
  5. Проверка сайта (Настройки -> Инструменты -> Проверка системы) не должна выявлять тип ошибок, связанных с работой с сокетами.
Обязательно проверьте свой сайт на соответствие всем техническим требованиям.

Способы приобретения модуля

  1. Купить модуль в Маркетплейс 1С-Битрикс.
  2. Обратиться в компанию "Мибок" или к любому партнеру 1С-Битрикс

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

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

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


Настройки в личном кабинете Яндекс.Кассы

Перейдите в личный кабинет Яндекс.Кассы на страницу "Настройки магазина":

Личный кабинет Яндекс.Кассы

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


Настройка оплаты для приема платежей в 1 клик

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

Яндекс.Касса (без модуля sale) без настроек

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

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

Яндекс.Касса (без модуля sale) - настройка
  • Секретный ключ. В данном поле необходимо указать секретный ключ, полученный в личном кабинете Яндекс.Кассы. Обратите внимание, что для тестирования выдается ключ с префиксом "test_"
  • shopArticleId. Данный параметр является необязательным и при необходимости выдается при подключении к Яндекс.Кассе.
  • Выбор способа оплаты. Возможные варианты: умный платеж, банковские карты, Яндекс.Деньги, Сбербанк Онлайн, Альфа-Клик, Тинькофф, QIWI Wallet, Webmoney, оплата наличными в терминале, оплата по частям. Рекомендуется выбирать вариант "Умный платеж", в этом случае выбор способа оплаты будет происходить покупателем непосредственно при оплате на стороне Яндекс.Кассы.
    Обратите внимание, что на тестовом аккаунте рабочими являются только следующие способы оплаты: умный платеж, банковские карты, Яндекс.Деньги. Все остальные способы при попытке оплатить будут выдавать ошибку.
  • Код валюты. Необходимо указать обязательно в формате ISO-4217. Для рубля будет код "RUB".
  • URL страницы возврата. В данном поле необходимо указать относительный URL, на который вернется пользователь после оплаты (нажав на кнопку "Вернуться в магазин"). В данном поле Вы можете указать как ссылку на любую страницу Вашего сайта, так и ссылку на страницу, на которой расположен компонент модуля "mibok:pay.yandexkassa.return". В случае использования этого компонента относительная ссылка обязательно должна содержать макрос #HASH#, например, /payment/return.php#HASH#
    Обратите внимание, что если Вы будете использовать один и тот же магазин для разных сайтов, указанный относительный URL страницы возврата должен быть на всех этих сайтах.
  • Описание транзакции в личном кабинете Яндекс.Кассы. В данном поле Вы можете, используя определенный набор макросов сформировать описание каждой транзакции в удобном для Вас виде.
  • Передача данных для формирования чека. Установка данной галки необходима только в том случае, если у Вас настроена на стороне Яндекс.Кассы получение информации о составе корзины с последующей передачей в арендованную онлайн-кассу.
    Обратите внимание, что если у Вас на стороне Яндекс.Кассы подключена передача данных в онлайн-кассу, а галка не установлена или наоборот, галка установлена, а на стороне Яндекс. Кассы такого подключения нет, платежи на Вашем сайте не будут проходить.
    Если данная галка установлена, то появляются дополнительные поля для настройки:
    • Ставка НДС. Возможные варианты для выбора: Без НДС, НДС по ставке 0%, НДС по ставке 10%, НДС чека по ставке 20%, НДС чека по расчетной ставке 10/110, НДС чека по расчетной ставке 20/120.
    • Система налогообложения магазина. Возможные варианты для выбора: общая система налогообложения, упрощенная (УСН, доходы), упрощенная (УСН, доходы минус расходы), единый налог на вмененный доход (ЕНВД), единый сельскохозяйственный налог (ЕСН), патентная система налогообложения.
    • Признак предмета расчета. Возможные варианты для выбора: товар, подакцизный товар, работа, услуга, ставка в азартной игре, выигрыш в азартной игре, лотерейный билет, выигрыш в лотерею, результаты интеллектуальной деятельности, платеж, агентское вознаграждение, имущественные права, внереализационный доход, страховой сбор, торговый сбор, курортный сбор, несколько вариантов, другое.
    • Признак способа расчета. Возможные варианты для выбора: полная предоплата, частичная предоплата, аванс, полный расчет, частичный расчет и кредит, кредит, выплата по кредиту.

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

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

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

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

Яндекс.Касса (c модулем sale) 1.1 small

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

  • Введите shopId магазина из личного кабинета. В данном поле необходимо ввести полученный в Яндекс.Кассе shopID (если их несколько, то каждый shopID должен располагаться в новом поле)
  • Секретный ключ. В данном поле необходимо указать секретный ключ, полученный в личном кабинете Яндекс.Кассы. Обратите внимание, что для тестирования выдается ключ с префиксом "test_"
  • При каком статусе заказа отправлять чек зачета предоплаты. В данном поле необходимо выбрать статус заказа, при котором будет отправляться чек зачета предполаты. Отправка такого чека необходима если используется один из следующих способов расчета: полная предоплата, частичная предоплата, аванс. Подробнее о том что такое чек зачета предоплаты и в каких случаях он необходим можно найти в разделе Чеки зачета предоплаты. Рекомендуется выбирать финальный статус заказа "Выполнен" и не забывать переводить все действительно выполненные заказы в этот статус.

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

После перехода на страницу списка платежных систем нажмите на кнопку "Добавить платежную систему" и на открывшейся странице выберите пользовательский обработчик "Яндекс.Касса с поддержкой 54-ФЗ (mibokyandexkassa):"

Настройка платежной системы Яндекс.Касса (часть 1)

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

Для выбора типа платежной системы доступны следующие варианты: умный платеж, банковские карты, Яндекс.Деньги, Сбербанк Онлайн, Альфа-Клик, Тинькофф, QIWI Wallet, Webmoney, оплата наличными в терминале, оплата по частям. Рекомендуется выбирать вариант "Умный платеж", в этом случае выбор способа оплаты будет происходить покупателем непосредственно при оплате на стороне Яндекс.Кассы.
Обратите внимание, что на тестовом аккаунте рабочими являются только следующие способы оплаты: умный платеж, банковские карты, Яндекс.Деньги. Все остальные способы при попытке оплатить будут выдавать ошибку.

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

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

Настройка платежной системы Яндекс.Касса (часть 2)
  • Автоматически оплачивать заказ при получении успешного статуса оплаты. При установленной галке как только на сайт будет поступать информация об успешной оплате, заказ автоматически будет оплачиваться.
  • shopId. Необходимо ввести полученный в Яндекс.Кассе shopID.
  • Секретный ключ. В данном поле необходимо указать секретный ключ, полученный в личном кабинете Яндекс.Кассы. Обратите внимание, что для тестирования выдается ключ с префиксом "test_"
  • shopArticleId. Данный параметр является необязательным и при необходимости выдается при подключении к Яндекс.Кассе.
  • Описание транзакции. В данном поле Вы можете, используя определенный набор макросов сформировать описание каждой транзакции в удобном для Вас виде.
  • URL страницы возврата. В данном поле необходимо указать полный путь, на который вернется пользователь после оплаты (нажав на кнопку "Вернуться в магазин"). В данном поле Вы можете указать как ссылку на любую страницу Вашего сайта, так и ссылку на страницу, на которой расположен компонент модуля "mibok:pay.yandexkassa.return". В случае использования этого компонента ссылка обязательно должна содержать макрос #HASH#, например, https://адрес_вашего_сайта/payment/return.php#HASH#
    Обратите внимание, что если Вы будете использовать один и тот же магазин для разных сайтов, указанный относительный URL страницы возврата должен быть на всех этих сайтах.
  • Отправлять чеки в онлайн-кассу. Установка данной галки необходима только в том случае, если у Вас настроена на стороне Яндекс.Кассы получение информации о составе корзины с последующей передачей в арендованную онлайн-кассу.
    Обратите внимание, что если у Вас на стороне Яндекс.Кассы подключена передача данных в онлайн-кассу, а галка не установлена или наоборот, галка установлена, а на стороне Яндекс. Кассы такого подключения нет, платежи на Вашем сайте не будут проходить.
    Если данная галка установлена, то обязательно необходимо сделать следующие настройки:
    • Название покупателя. Выбирается из каких параметров будет браться информация о покупателе (ФИО или название компании).
    • E-mail покупателя. Выбирается из каких параметров будет браться информация о E-mail покупателя.
    • Телефон покупателя. Выбирается из каких параметров будет браться информация о телефоне покупателя.
    • ИНН покупателя. Выбирается из каких параметров будет браться информация о ИНН покупателя.
    • Система налогообложения магазина. Возможные варианты для выбора: общая система налогообложения, упрощенная (УСН, доходы), упрощенная (УСН, доходы минус расходы), единый налог на вмененный доход (ЕНВД), единый сельскохозяйственный налог (ЕСН), патентная система налогообложения.
    • Признак способа расчета. Возможные варианты для выбора: полная предоплата, частичная предоплата, аванс, полный расчет, частичный расчет и кредит, кредит, выплата по кредиту.
    • НДС на товары и НДС на доставку. Возможные варианты для выбора: Без НДС, НДС по ставке 0%, НДС по ставке 10%, НДС чека по ставке 20%, НДС чека по расчетной ставке 10/110, НДС чека по расчетной ставке 20/120.
    • Признак предмета расчета товара и Признак предмета расчета доставки. Возможные варианты для выбора: товар, подакцизный товар, работа, услуга, ставка в азартной игре, выигрыш в азартной игре, лотерейный билет, выигрыш в лотерею, результаты интеллектуальной деятельности, платеж, агентское вознаграждение, имущественные права, внереализационный доход, страховой сбор, торговый сбор, курортный сбор, несколько вариантов, другое.

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

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

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

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

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


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

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

  • "Умный платеж" (выбор способа оплаты на странице Яндекс.Кассы)
  • Оплата банковской картой
  • Оплата из кошелька в Яндекс.Деньгах.

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

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

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

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


История платежей

Администратору сайта доступен интерфейс для просмотра истории платежей, который находится на странице "Мибок → Мибок: Платежный модуль для сайта → История платежей":

История платежей

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

  • Инициатор платежа. Возможные значения: платежная система, модуль оплаты. Указывает через какой способ оплаты был соверше платеж через платежную системы интернет-магазина (редакции "Малый бизнес" и "Бизнес") или модуль, работающий на любой редакции.
  • Статус. Возможные значения: ожидает оплаты; оплачен, ожидание списания; успешно завершен; отменен; ошибка оплаты.
    Статус "ошибка оплаты" может появиться, если Вы неправильно настроили оплату на своем сайта (например, установили опцию отправки информации для чеков без соответствующей настройки на стороне Яндекс.Кассы) или в случае, если на стороне Яндекс.Кассы произошел какой-то сбой (например, в данный момент недоступен сервис платежей).
  • ID оплаты в Яндексе. ID платежа, назначенный в Яндекс.Кассе, по нему можно отследить необходимую информацию о платеже в личном кабинете Яндекс.Кассы.
  • ID заказа на сайте. Данное значение устанавливается только если осуществлялась оплата заказа через платежную систему интернет-магазин.

Детальная страница платежа и просмотр чеков

На детальную страницу платежа можно перейти 2 способами: двойным кликом по строке таблицы истории платежей, соответствующей необходимого платежу или при вызове контекстного меню, нажав на кнопку "Посмотреть".

В открывшейся детальной странице платежа всегда доступна вкладка "Данные о платеже":

Детальная страница платежа
В данной вкладке собрана вся полная информация о совершенном платеже:
  • Статус платежа
  • Оплачен/не оплачен
  • Служебная информация от платежной системы (ID заказа в плат. системе, ключ идемпотентности и т.д.)
  • Информация о заказе (сумма, валюта, товары, описание платежа, ссылка на оплату)
  • Информация о покупателе (ФИО, Email, телефон, ИНН, ID пользователя, если покупатель был авторизован на сайте)
  • Информация о чеке зачета предоплаты (нужно ли отправлять чек, и был ли он уже отправлен). Данный блок отображается только, если платеже требуется отправка данного вида чека. Подробнее можно прочитать здесь.

Если используется отправка чеков в Яндекс.Кассу, то также доступна вкладка "Чеки" для просмотра информации о всех отправленных чеках по данному платежу. Чеки сгруппированы на блоки, на случай если платежу требуется отправка нескольких чеков.
Например, при совершенной успешной оплате, в данной вкладке отображается информация об отправленном чеке: Информация о чеке

Здесь отображается вся служебная информация о чеке, которую передает Яндекс.Касса сайту.

Если по данному платежу необходимо отправить чек зачета предоплаты, то помимо соответствуюещей информации во вкладке "Данные о платеде", сверху страницы появляется кнопка "Отправить чек зачета предоплаты" при нажатии на которую, осуществляется отправка всех необходимых данных в Яндекс.Кассу, после чего вкладка с информацией о чеках отображается следующим образом:
Информация о нескольких чеках
После того как чек зачета предоплаты был отправлен в Яндекс.Кассу, соответствующая кнопка пропадает, т.е. отправить чек можно всего 1 раз.
Обратите внимание, если у Вас осуществляется оплата через платежную систему и оформление заказа с использованием модуля sale, рекомендуется отправлять чеки зачета предоплаты в автоматическом режиме.

Если статус доставки чека в онлайн-кассу установлен как "ожидает доставки", то о чеке не выводится часть служебной информации (данные от фискального накопителя) и напротив статуса чека отображается кнопка "Обновить статус". При нажатии на эту кнопку отправляется запрос в Яндекс.Кассу и если информация об отправке чека в онлайн-кассу появляется, то обновляется статус и выводится вся полученная служебная информация о чеке:
Информация о чеке после обновления статуса
Обратите внимание, что на данный момент получение информации о чеке происходит только в ручном режиме.


Цена 2 000
Попробовать решение
Вернуться в список продуктов