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

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

Коротко о модуле

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

НДС не облагается

Читать далее
Тип поставки
Электронная (ключ)
Платформа
О продукте

Рекомендации по применению

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

Описание

Предлагаем купить платёжный модуль для сайтов на 1С Битрикс. С поддержкой онлайн платежей через ЮKassa (ex-Яндекс.Кассу). Прямая поставка модуля от разработчика, интернет-агентства "Мибок".

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

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

mibok.pay

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

  • Гибкие настройки
  • Поддержка оплаты на любой редакции Битрикс
  • Поддержка нескольких ShopID
  • Поддержка различных способов оплаты: Умный платеж, Банковские карты (Visa, Mastercard, Maestro, Мир, JCB), ЮMoney, Альфа-Клик, Сбербанк Онлайн, Тинькофф, QIWI Wallet, Webmoney, наличные через терминалы, заплатить по частям, b2b платежи через Сбербанк Бизнес Онлайн, СБП (Система Быстрых Платежей).
  • Поддержка полных и частичных возвратов, двухстадийных платежей
  • Поддержка ФЗ-54 (передача данных чека в формате ФФД 1.05 через ЮKassa для дальнейшей передачи партнерам) и ФЗ-152 (возможность вывода блока с соглашением на обработку персональных данных)
  • Формирование чека зачета предоплаты
  • Подробная информация об отправленных чеках
  • Поддержка уведомлений о создании платежа, успешной оплате, отмене платежа.

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

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

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

С помощью калькулятора вы можете начать оформление заказа.

Вопрос-Ответ

Часто задаваемые вопросы

Здесь представлены ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ и ответы к ним. Так что просим Вас ознакомиться с этим небольшим списком прежде чем задавать вопрос, на который уже дан ответ.

Не нашли ответ на ваш вопрос?
Пишите, мы обязательно ответим


Инструкция

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

ЮKassa

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

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

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


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

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

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

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

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


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

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

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

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

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

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

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

ЮKassa (без модуля sale) без настроек

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

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

ЮKassa (без модуля sale) - настройка
  • Секретный ключ. В данном поле необходимо указать секретный ключ, полученный в личном кабинете Ю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. В данном поле Вы можете, используя определенный набор макросов сформировать описание каждой транзакции в удобном для Вас виде.
  • Адрес для уведомлений. В данном поле Вы можете скопировать URL адреса уведомлений, на который будет приходить информация о состоянии платежа. Это поле редактировать не требуется, а значение из него Вы можете установить в настройках личного кабинета ЮKassa.
  • Двухстадийный платеж. Установка данной галки необходима только в том случае, если Вы хотите принимать платежи в 2 стадии:
    • Холдирование (предавторизация): пользователь вносит оплату, и деньги замораживаются — например, на его банковской карте или в электронном кошельке (зависит от способа, которым он платит).
    • Списание: замороженные деньги списываются по вашему запросу.
    Обратите внимание, что если Вы выбрали двухстадийный платеж, Вам необходимо будет вручную подтверждать платежи. Подробнее о даннном функционале написано в разделе Двухстадийные платежи.
  • Передача данных для формирования чека. Установка данной галки необходима только в том случае, если у Вас настроена на стороне ЮKassa получение информации о составе корзины с последующей передачей в арендованную онлайн-кассу (на зеленой плашке перед выводом секретного ключа, отображается информация в каком режиме работает Ваш магазин).
    Обратите внимание, что если у Вас на стороне ЮKassa подключена передача данных в онлайн-кассу, а галка не установлена или наоборот, галка установлена, а на стороне ЮKassa такого подключения нет, платежи на Вашем сайте не будут проходить.
    ЮKassa (без модуля sale) - настройка
    Если данная галка установлена, то появляются дополнительные поля для настройки:
    • Ставка НДС. Возможные варианты для выбора: Без НДС, НДС по ставке 0%, НДС по ставке 10%, НДС чека по ставке 20%, НДС чека по расчетной ставке 10/110, НДС чека по расчетной ставке 20/120.
    • Система налогообложения магазина. Возможные варианты для выбора: общая система налогообложения, упрощенная (УСН, доходы), упрощенная (УСН, доходы минус расходы), единый налог на вмененный доход (ЕНВД), единый сельскохозяйственный налог (ЕСН), патентная система налогообложения.
    • Признак предмета расчета. Возможные варианты для выбора: товар, подакцизный товар, работа, услуга, ставка в азартной игре, выигрыш в азартной игре, лотерейный билет, выигрыш в лотерею, результаты интеллектуальной деятельности, платеж, агентское вознаграждение, имущественные права, внереализационный доход, страховой сбор, торговый сбор, курортный сбор, несколько вариантов, другое.
    • Признак способа расчета. Возможные варианты для выбора: полная предоплата, частичная предоплата, аванс, полный расчет, частичный расчет и кредит, кредит, выплата по кредиту.
    • Мера количества предмета расчета. Возможные варианты для выбора: Штука, Грамм, Килограмм, Тонна, Сантиметр, Дециметр, Метр, Квадратный сантиметр, Квадратный дециметр, Квадратный метр, Миллилитр, Литр, Кубический метр, Килловат-час, Гигакалория, Сутки, Час, Минута, Секунда, Килобайт, Мегабайт, Гигабайт, Терабайт, Другое.
      Обратите внимание, данный параметр нужно передавать, начиная с ФФД 1.2.
  • Настройка Сбербанк Бизнес Онлайн. В случае подключения варианта платежа "Сбербанк Бизнес Онлайн", требуется активировать данную галку и внести дополнительные настройки:
    • Вид ставки НДС для Сбербанк Бизнес Онлайн. Варианты значения: Без НДС, Одна ставка у всех товаров.
    • Ставка НДС для Сбербанк Бизнес Онлайн. Варианты значения: 0%, 10%, 20%.

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

Настройки компонента Форма оплаты (часть 1)
  • Выберите ShopID магазина в ЮKassa. Выбрав ShopID из сохраненных Вами ранее на странице "Мибок → Мибок: Платежный модуль для сайта → Настройки оплаты → вкладка ЮKassa (без модуля sale)".
  • Источник данных о товаре. На данный момент предусмотрены следующие варианты:
    - Данные о товаре и сумме покупатель не сможет отредактировать. Этот вариант не позволяет покупателю отредактировать информацию о покупке, а значит он может совершить платеж только нза фиксированную стоимость.
    - Редактируемые покупателем поля формы. Этот вариант позволяет покупателю отредактировать информацию о покупке и ее стоимости. Такой вариант удобен, например, для сайтов со сбором пожертвований.
  • Содержание заказа. В данном поле указывается информация о содержимом заказа (товара), который будет приобретать покупатель.
  • Сумма заказа. В данном поле указывается сумма заказа, которую будет оплачивать покупатель.
  • Подпись валюты. В данном поле указывается в произвольном виде подпись валюты, в которой будет оплачивать покупку покупатель.
  • Согласие пользователя. В данном блоке настраивается вывод блока с соглашением на обработку персональных данных (сам текст соглашения и галочка о принятии), в соответствии с 152-ФЗ.
Настройки компонента Форма оплаты (часть 2)
  • Информация о покупателе. В данном блоке выводятся поля, которые перед оплатой должен заполнить покупатель. Рекомендуем Вам, чтобы пользователь заполнял как минимум поля: Имя и 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
);
$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'],
        ['QUANTITY' => 6.23, 'PRICE' => 15, 'NAME' => 'Товар 2']
    ],
    'payment_method_data' => 'bank_card',
    'USER_ID' => 1
);
$res = $obKassa->createPaymentForMultiplePositions($params);

Все элементы массива $params обязательные, кроме USER_ID, в данном параметре по желанию Вы можете передавать ID авторизованного пользователя.
Для payment_method_data существуют следующие варианты:

  • bank_card - банковская карта
  • yoomoney - ЮMoney
  • alfabank - Альфа-Клик
  • sberbank - Сбербанк Онлайн
  • tinkoff_bank - Тинькофф
  • qiwi - QIWI-кошелек
  • webmoney - Webmoney

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

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

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

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

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

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

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

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

ЮKassa (c модулем sale), версия 1.1

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

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

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

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

Настройка платежной системы ЮKassa (часть 1)

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

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

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

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

Настройка платежной системы ЮKassa (часть 2)
  • Автоматически оплачивать заказ при получении успешного статуса оплаты. При установленной галке как только на сайт будет поступать информация об успешной оплате, заказ автоматически будет оплачиваться.
  • shopId. Необходимо ввести полученный в ЮKassa shopID.
  • Секретный ключ. В данном поле необходимо указать секретный ключ, полученный в личном кабинете ЮKassa. Обратите внимание, что для тестирования выдается ключ с префиксом "test_"
  • shopArticleId. Данный параметр является необязательным и при необходимости выдается при подключении к Ю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 такого подключения нет, платежи на Вашем сайте не будут проходить.
    Если данная галка установлена, то обязательно необходимо сделать следующие настройки:
    Настройка платежной системы ЮKassa (часть 3)
    • Название покупателя. Выбирается из каких параметров будет браться информация о покупателе (ФИО или название компании).
    • E-mail покупателя. Выбирается из каких параметров будет браться информация о E-mail покупателя.
    • Телефон покупателя. Выбирается из каких параметров будет браться информация о телефоне покупателя.
    • ИНН покупателя. Выбирается из каких параметров будет браться информация о ИНН покупателя.
    • Система налогообложения магазина. Возможные варианты для выбора: общая система налогообложения, упрощенная (УСН, доходы), упрощенная (УСН, доходы минус расходы), единый налог на вмененный доход (ЕНВД), единый сельскохозяйственный налог (ЕСН), патентная система налогообложения.
    • Признак способа расчета. Возможные варианты для выбора: полная предоплата, частичная предоплата, аванс, полный расчет, частичный расчет и кредит, кредит, выплата по кредиту.
    • НДС на товары и НДС на доставку. Возможные варианты для выбора: Без НДС, НДС по ставке 0%, НДС по ставке 10%, НДС чека по ставке 20%, НДС чека по расчетной ставке 10/110, НДС чека по расчетной ставке 20/120.
    • Признак предмета расчета товара и Признак предмета расчета доставки. Возможные варианты для выбора: товар, подакцизный товар, работа, услуга, ставка в азартной игре, выигрыш в азартной игре, лотерейный билет, выигрыш в лотерею, результаты интеллектуальной деятельности, платеж, агентское вознаграждение, имущественные права, внереализационный доход, страховой сбор, торговый сбор, курортный сбор, несколько вариантов, другое.
    • Мера количества предмета расчета товаров и Мера количества предмета расчета доставки. Возможные варианты для выбора: Штука, Грамм, Килограмм, Тонна, Сантиметр, Дециметр, Метр, Квадратный сантиметр, Квадратный дециметр, Квадратный метр, Миллилитр, Литр, Кубический метр, Килловат-час, Гигакалория, Сутки, Час, Минута, Секунда, Килобайт, Мегабайт, Гигабайт, Терабайт, Другое. Обратите внимание, данный параметр нужно передавать, начиная с ФФД 1.2.

      Кроме того поле Мера количества предмета расчета товаров может иметь вариант: "Брать из информации в товаре (единица измерения)". В случае, выбора этого варианта, Вам необходимо в обязательном порядке настроить соответствие единиц измерения между ЮKassa и 1С-Битрикс. Для этого Вам необходимо, перейти на страницу "Мибок → Мибок: Платежный модуль для сайта → Настройки оплаты → вкладка Единицы измерения (для модуля sale)" и настроить соответствие между единицами измерения ЮKassa (левая колонка) и существующими единицами измерения на Вашем сайте (правая колонка с выпадающими списками). О том как отредактировать или создать единицы измерения, можете прочитать в документации 1С-Битрикс.
      Единицы измерения (для модуля sale)
  • Настройка Сбербанк Бизнес Онлайн. В случае подключения варианта платежа "Сбербанк Бизнес Онлайн", требуется внести дополнительные настройки:
    • Вид ставки НДС для Сбербанк Бизнес Онлайн. Варианты значения: Без НДС, Одна ставка у всех товаров.
    • Ставка НДС для Сбербанк Бизнес Онлайн. Варианты значения: 0%, 10%, 20%.
  • Объединение позиций в заказе. В некоторых случаях может потребоваться объединить все товары в 1 товар, ввиду наличия ограничений на количество товаров в одном чеке, которые есть у некоторых онлайн-касс. Такая ситуация может возникать, например, при продаже таких товаров, как семена, которых обычно очень много в одном заказе. В случае наличия такой ситуации, Вы можете объединить все товары корзины покупателя в один объединенный товар, в итоге у Вас в чеке будет всего 2 товара: объединенный и доставка. Для активации объединения позиций в заказе необходимо установить соответствующую галку "Объединять позиции в заказе", а также настроить следующие параметры:
    • Имя для объединенных позиций. В данном поле необходимо задать шаблон имени объединенного товара. Доступно использование следующих макросов: #PAYMENT_ID# - ID оплаты; #ORDER_ID# - ID заказа; #PAYMENT_NUMBER# - номер оплаты; #ORDER_NUMBER# - номер заказа.
    • НДС на товары. Данная настройка аналогична настройке "НДС на товары" в блоке "Настройки отправки чеков". Обратите внимание, что НДС будет устанавливаться одна общая.
    • Мера количества предмета расчета товаров. Данная настройка аналогична настройке "Мера количества предмета расчета товаров" в блоке "Настройки отправки чеков".

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

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

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

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

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


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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

С версии 1.4.2 в модуль добавлена новая кнопка "Актуализировать чеки", при нажатии на которую отправляется запрос в ЮKassa на получение всех чеков (в том числе обновление статусов чеков) по данном платежу и возвратам (при их наличии): Актуализировать чеки


Двухстадийные платежи

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

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

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


Возврат

При успешной оплате платежная система отправляет информацию на сайт возможно ли для данного платежа совершить возврат средств.
Возможность возврата средств

Если возврат возможен, то у платежей со статусом "успешно завершен" становится доступна кнопка "Сделать возврат", при нажатии на которую появляется модальное окно с выбором типа возврата: полный или частичный.

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

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

Доступ к настройкам модуля и истории платежей

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

  • [D] закрыт - запрет на доступ, установлен по умолчанию для всех групп пользователей, кроме администратора;
  • [R] просмотр всех данных модуля - при установке данного доступа выбранная группа пользователей сможет просматривать настройки модуля (без возмоджности редактирования), просматривать историю платежей (без возможности сделать возврат, подтвердить платеж, отправить чек зачета предоплаты) и соответствующих чеков (с возможностью актуализировать чеки при необходимости);
  • [W] запись - данный доступ автоматически установлен для административной группы пользователей, при установке данного доступа выбранная группа пользователей получает доступ ко всем настройкам модуля, с возможностью их редактировать, а также совершать возврат, подтверждать платеж, отправлять чек зачета предоплаты в истории платежей.

Обратите внимание, что настройки доступа к модулю не влияют на настройки доступа к настройкам обработчиков платежных систем (для редакций с модулем sale).
Подробнее о настройке прав доступа Вы можете прочитать в курсе 1С-Битрикс.

Список изменений

Список изменений

Версия 1.6.1 (07.03.2023)

Внимание! После данного обновления обязательно проверьте прием платежей на Вашем сайте.

  • Улучшена поддержка параметра tax_system_code (система налогообложения магазина) для всех видов чеков для онлайн-кассы Атол Онлайн, обновленной до ФФД 1.2
  • Улучшен функционал формировании чека в случае объединения всех товаров корзины в одну позицию
  • Улучшен функционал полного и частичного возврата
  • Отключена платежная система QIWI
  • Прочие улучшения и устранения ошибок

Версия 1.6.0 (01.11.2023)

Внимание! В данной версии прекращена поддержка сайтов с версией PHP ниже 8.0.
Перед обновлением рекомендуем сделать резервную копию сайта.
После обновления обязательно проверьте прием платежей на Вашем сайте.

  • Добавлена поддержка параметра для чека items.measure (мера количества предмета расчета) для ФФД 1.2
  • Доработан валидатор email-адреса в компоненте оплаты mibok:pay.yandexkassa.payment
  • Добавлен метод createPaymentForMultiplePositions для создания платежа с массивом товаров
  • Исправлена проблема повторной оплаты заказа
  • Улучшена поддержка дробных значений количества товара (в том числе при частичном возврате, частичном подтверждении платежа)
  • Прочие улучшения и устранения ошибок

Версия 1.5.3 (16.06.2023)

Исправлена ошибка, возникающая при формировании чека в случае объединения всех товаров корзины в одну позицию

Версия 1.5.2 (24.04.2023)

Исправлен ряд ошибок, в том числе проблема на некоторых установках с получением уведомлений от ЮKassa

Версия 1.5.1 (14.03.2023)

Исправлен ряд ошибок, в том числе проблема в настройках платежной системы с определением значения НДС из информации в товаре/доставке

Версия 1.5.0 (31.01.2023)

Внимание! После данного обновления обязательно проверьте прием платежей на Вашем сайте.

  • Улучшена поддержка PHP 8
  • Добавлен СБП как отдельный вид платежа
  • Доработана детальная страница истории платежа, в том числе добавлена кнопка "Обновить статус" для платежей со статусами: процесс отмены, процесс подтверждения оплаты
  • Убрано дублирование создание платежей при оплате на странице оформления заказа
  • Внесена корректировка обработки весовых товаров

Версия 1.4.6 (12.04.2022)

В настройках платежной системы добавлены макросы (ID оплаты, ID заказа) для формирования URL страницы возврата после оплаты

Версия 1.4.5 (14.03.2022)

  • Корректировка округления стоимости товара при возврате и доверительном платеже
  • Корректировка вывода списка чеков
  • Исправление работы функционала логирования ошибок платежной системы (в случае их наличия) на странице заказа

Версия 1.4.4 (04.10.2021)

Добавлена поддержка ограничений прав доступа к страницам модуля в административном разделе сайта (поддерживаемые права: [D] закрыт, [R] просмотр всех данных модуля, [W] запись). Для назначения прав другим пользователям воспользуйтесь инструкцией.

Версия 1.4.3 (03.05.2021)

Исправлен ряд ошибок, в том числе проблема с оплатой товаров с длинными названиями

Версия 1.4.2 (25.12.2020)

Внимание! После данного обновления обязательно проверьте прием платежей на Вашем сайте.

  • Внесены изменения в платёжном протоколе для поддержки перехода на адреса Юкасса
  • Исправлен ряд ошибок

Версия 1.4.1 (28.09.2020)

Исправлена ошибка оплаты (для сайтов с модулем sale)

Версия 1.4.0 (22.09.2020)

Исправлена поддержка b2b платежей через Сбербанк Бизнес Онлайн

Версия 1.3.0 (23.01.2020)

Внимание! После данного обновления обязательно проверьте прием платежей на Вашем сайте.

  • Добавлен функционал двухстадийных платежей с полным и частичным списанием
  • Добавлен функционал полного и частичного возврата

Версия 1.2.0 (18.11.2019)

Внимание! После данного обновления обязательно проверьте прием платежей на Вашем сайте

  • Добавлены новые настройки модуля и платежной системы
  • Исправлены ошибки, в том числе в истории платежей

Версия 1.1.0 (15.10.2019)

  • Добавлена детальная страница просмотра информации об оплате и соответствующих чеках
  • Добавлен функционал отправки чека зачета предоплаты
Отзывы

Отзывы

Уваров Владимир
01.10.2020
Отзыв на платежный модуль "Мибок: Касса для сайта"
Установил модуль Мибок уже на второй сайт.
На первом сайте (редакция Стандарт)  модуль отработал 4 месяца. Проблем нет.
Модуль достаточно прост в установке и настройке и особенно может быть необходим сейчас, при переходе на новый протокол API, для администраторов, не имеющих достаточных навыков в программировании по интеграции с Яндекс.Касса.
Очень важна доступная возможность самостоятельно настроить дизайн платежной формы на своем сайте через CSS.
Рассматривал и другие модули с похожим функционалом, но для второго сайта всё равно выбрал модуль Мибок.
Имея опыт общения с техподдержкой различных интернет-сервисов, хочу отметить доброжелательность и конструктивность в общении со стороны техподдержки модуля Мибок.
Я доволен.
Судоргин Михаил
04.03.2020
Установил модуль на сайт с редакцией Стандарт
и получил полноценный интернет-магазин всего за 2000 рублей.
пока не могу скинуть ссылку, т.к. установил на клоне, где веду отладку решений, попозже.

Что понравилось:
1. Модуль простой в установке и наладке.
2. Техподдержка. Очень доброжелательная и компетентная

Что хотелось бы доработать или изменить:
1. Вся база заказов и оплат хранится в отдельной таблице SQL. А хотелось бы видеть её как инфоблок, чтобы можно было с помощью стандартных компонентов Битрикса выводить информацию клиенту.
КРАСКИ КУБАНИ
06.11.2019
Легко установился и очень легко настроить!
Обновлял версию битрикса с 17го на 18.0.2 с установленным модулем Мибок - в итоге Модуль работает без проблем! Битрикс 18.2

Оставьте свой отзыв

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

Оцените по 5-ти бальной шкале
Не заполнены обязательные поля
Скриншоты

Скриншоты