Модуль позволит с легкостью добавить на ваш сайт оплату банковскими картами через платежный сервис CloudPayments. Для корректной работы модуля необходима регистрация в сервисе.
- Одностадийная схема оплаты;
- Двухстадийная схема оплаты;
- Частичная оплата заказа;
- Изменение оплаченного заказа и прием доплаты согласно изменению;
- Отмена, подтверждение и возврат платежей из ЛК CMS;
- Поддержка онлайн-касс (ФЗ-54);
- Отправка чеков по email;
- Отправка чеков по SMS;
- Оплата через ссылку по счёту;
- Настройка НДС для службы доставки;
Подходящие редакции - «Малый бизнес», «Бизнес», «Корпоративный портал», «Энтерпрайз» версии 17 и выше;
Перейдите на страничку модуля в marketplace, нажмите "установить", укажите url сайта, вас перебросит на сайт.
После чего нужно авторизоваться под админом, и скачать и установить модуль.
- Скопируйте архив с github. На ftp создаем папку
/bitrix/modules/cloudpayments.cloudpayment - В папку скопируйте все содержимое из архивной папки
\cloudpayments.cloudpayment\.last_version\ - Итого в папке
/bitrix/modules/cloudpayments.cloudpaymentдолжны быть следующие файлы
- Далее перейдите в раздел установки решений c marketplace в админке
/bitrix/admin/partner_modules.php?lang=ru
И нажмите напротив скопированного модуля - "установить".
- Чтобы модуль корректно работал, нужно внести ряд изменений в настройки модуля, а также настроить работу вебхуков в личном кабинете.
Настройки модуля и настройки вебхуков описаны ниже.
Внимание. Если у вас сайт использует кодировку utf-8, то пересохраните все файлы модуля текстовым редактором, например notepad, в кодировке utf-8. В противном случае настройки модуля будут нечитабельны.
- Сначала нужно создать новую платежную систему. Перейдите «Магазин» -> “Платежные системы»
/bitrix/admin/sale_pay_system.php?lang=ru - Нажмите кнопку «Добавить платежную систему»
- В качестве обработчика выбираем CloudPayments (cloudpayment).
Далее введите:
- название;
- описание и прочие поля заполните по своему усмотрению. Нажмите «Применить», чтобы появились настройки самой платежной системы.
- Далее перейдите в раздел «Настройка обработчика ПС»
Заполните:
- «Public ID»;
- «Пароль для API», и выберите «Тип схемы проведения платежей».
Остальные параметры заполните на свое усмотрение.
- Success URL - url на который будет переадресован пользователь после успешной оплаты заказа.
- Fail URL - url на который будет переадресован пользователь после неудачно оплаты заказа.
- Язык виджета - список доступных языков виджета оплаты заказа, который появляется когда пользователь нажимает кнопку "оплатить".
- Использовать функционал онлайн касс - при использование модуля онлайн касс, установив данный параметр, клиенту на почту будет приходить чек оплаты.
- Тип схемы проведения платежей - выбор схемы оплата платежной системы. Одностадийная оплата, или двухстадийна. При двухстадийной оплате требуется подтверждение оплаты заказа в административной части.
- Статус возврата платежа - в этом пункте выбирается какой статус заказа отвечает за возврат платежа. Т.е. выбрав указанный в этом пункте статус, в заказе, будет выполнена функция возврата платежа через API cloudpayments.
- Статус авторизации платежа (двухстадийные платежи) - в этом пункте выбирается какой статус заказа будет установлен после оплаты пользователем при двухстадийной схеме платежей.
- Статус отмена авторизованного платежа (двухстадийные платежи) - в этом пункте выбирается какой статус заказа нужно выбрать в заказе, чтобы произвести отмену оплаты при двухстадийной схеме платежей, в момент когда оплата не подтверждена, а только авторизована. Подробнее о двухстадийной схеме оплат, можно прочитать у нас на сайте.
- Выберите НДС на доставку, если необходимо - в данном разделе можно установить размер ндс, с привязкой к добавленным на сайте службам доставки.
- Авторизуйтесь в личном кабинете;
- Перейдите в "Сайты"
- Добавьте свой сайт(если еще не добавили), и перейдите в настройки
- Далее, нажимите настройки
Напротив каждого хука копируйте линк ниже для соответсвующего вебхука:
- Check
http://domain.ru/bitrix/tools/sale_ps_result.php?action=check - Fail
http://domain.ru/bitrix/tools/sale_ps_result.php?action=fail - Pay
http://domain.ru/bitrix/tools/sale_ps_result.php?action=pay - Confirm
http://domain.ru/bitrix/tools/sale_ps_result.php?action=confirm - Refund
http://domain.ru/bitrix/tools/sale_ps_result.php?action=refund
Где domain.ru - адрес сайта.
Двухстадийная оплата подразумевает использование двух команд: отдельно на авторизацию, отдельно на списание. После успешной авторизации, сумма операции будет блокирована на счету держателя, то есть он не сможет ей воспользоваться. Далее у ТСП есть до 30 дней в зависимости от типа карты для подтверждения операции, после чего произойдет списание денег. Если операцию не подтвердить в течение этого времени — она будет автоматически отменена. Подтверждать можно как всю сумму авторизации, так и часть.
Как правило, двухстадийная схема используется для получения депозита с плательщика, например, в прокатных компаниях или отелях.
В зависимости от настройки, система может автоматически выполнять подтверждение двустадийных платежей через указанное количество дней.
Для того чтобы включить двухстадийную оплату нужно зайти в настройки модуля и в "Тип схемы проведения платежей" выбрать "Двухстадийная оплата". После чего платежная система будет работать по следующей схеме:
- Клиент оплачивает на сайте заказ.
- Заказ переходит в статус "Авторизован" и в данный момент оплата считается "авторизованной" и требует подтверждения администратором в административной части.
- Для этого переходим в редактирования соответствующего заказа. И меняем текущий статус заказа на новый. Выбранный в этом пункте настроек модуля.
- После того как будет получен ответ от cloudpayments (если вы настроили вебхук confirm), об успешном подтверждении, заказ будет считаться оплаченым. И статус заказа перейдет в "оплачен, формируется к отправке".
Чтобы отменить авторизованную, но не подтвержденную оплату. Нужно перейти в редактирование заказа и в статусе заказа выбрать статус выбранный в настройках модуля
После чего будет отправлен void запрос на отмену оплаты.
Чтобы вернуть оплаченный заказ. Нужно перейти в редактирование заказа и в статусе заказа выбрать выбранный статус в настройках модуля:
После чего будет отправлен refund запрос на возрат оплаты. Также возрат оплаты будет произведена автоматически, если будет отменен или удален заказ в ЛК сайта или в редактирование заказа.
Если вы не можете ограничить доступ к управлению заказами, и при этом вам не нужна функция возврата из ЛК Битрикса, то можно ее отключить (воизбежание ошибочных возратов). Для этого откройте файл include.php и замените в строчке №268 url на local.domain.
Если заказ в статусе возврат, кнопки оплатить виджета не будет,а вместо нее будет выводиться фраза
Текст можно изменить тут:
/bitrix/php_interface/include/sale_payment/cloudpayment/template/lang/ru/template.php
В личном кабинете пользователя может выводиться кнопка "оплатить" компонента, но при нажатие кнопки будет выводиться фраза описанная выше.
Кнопку оплаты битрикса можно удалить в шаблоне списка заказов
sale.personal.order.list в случае если используется стандартный компонент битрикса.
При двухстадийной схеме оплаты, и использование дефолтного личного кабинета пользователя на сайте. Может возникнуть ситуация, что заказа оплачен пользователем (авторизована оплата), но не подтверждена администратором сайта. И фактически битрикс такой заказ считает неоплаченым, и выводит в личном кабинете кнопку оплаты. Пример:
Виджет модуля Cloudpayments конечно такой заказа повторно оплатить не даст, и при нажатие оплаты. Выведет текст, что заказ уже оплачен и требует подтверждения:
Данный текст можно поменять тут:
/bitrix/php_interface/include/sale_payment/cloudpayment/template/lang/ru/template.php
Кнопку оплаты битрикса можно удалить в шаблоне списка заказов sale.personal.order.list в случае если используется стандартный компонент битрикса.