Платежный модуль CloudPayments

60 6

1.1.8 (11.07.2024)	Внесены минорные правки
1.1.7 (05.07.2024)	Внесены минорные правки
1.1.6 (17.10.2023)	Внесены минорные правки
1.1.5 (30.01.2024)	Изменено получение данных о покупателе
1.1.4 (17.10.2023)	Внесены минорные правки
1.1.3 (12.10.2023)	Исправления работы запросов и добавление выбора страны
1.1.2 (11.09.2023)	Исправление работы проверки принадлежности запроса и обработки товаров без НДС
1.1.1 (22.08.2023)	Исправления работы запросов и добавление выбора страны
1.1.0 (10.08.2023)	Внедрение классов ядра D7 в структуру модуля
1.0.11 (17.04.2023)	Минорные обновления
1.0.10 (31.03.2023)	Поддержка PHP 8 Обновлена локализация виджета Добавлены дополнительные параметры фискализации
1.0.9 (10.07.2020)	Техническое обновление модуля Добавлена возможность отправлять счет на оплату по смс/email Добавление выбора стиля виджета оплаты в настройках модуля (skin) Добавлен функционал второго чека
1.0.8 (18.07.2018)	Добавили чек возврата при изменение состава заказа и повторной оплате. Также добавлена возможность частичной оплаты. Для этого в настройках платежной системы нужно выбрать нужный статус для частичной оплаты.
1.0.7 (27.04.2018)	Добавили выбор статуса оплаты в настройках
1.0.6 (11.04.2018)	Добавили передачу GET параметра с id заказа в success и fail page
1.0.5 (21.03.2018)	Фикс для работы с заказами, у которых не указана платежная система
1.0.4 (16.03.2018)	Исправление ошибок связанных с синхронизацией заказов с 1с
1.0.3 (13.03.2018)	Исправление ошибок
1.0.2 (06.03.2018)	Обновление модуля. - Добавлены возможности замены системных статусов для двухстадийной схемы и отмены оплаты заказа. - Добавлена возможность смена локализации виджета оплаты - Добавлена возможность задать НДС службам доставки - Добавлена возможность задать Success и Fail url Также осуществлен ряд доработок модуля.

Установка через bitrix marketplace

Нажмите  "установить", укажите url сайта, вас перебросит на сайт.  
После чего нужно авторизоваться под админом, и скачать и установить модуль.



Настройка модуля

1. Сначала нужно создать новую платежную систему. Перейдите «Магазин» -> “Платежные системы» /bitrix/admin/sale_pay_system.php?lang=ru
   
2. Нажмите кнопку «Добавить платежную систему»
   
3. В качестве обработчика выберите CloudPayments (cloudpayment).Далее введите:- название- описание и прочие поля заполните по своему усмотрению.Нажмите «Применить», чтобы появились настройки самой платежной системы.
   
4. Далее перейдите в раздел «Настройка обработчика ПС»
   
5. Заполните: «Public ID», «Пароль для API»,  и выберите «Тип схемы проведения платежей»
   

Остальные параметры заполните на свое усмотрение.



Описание параметров модуля:

• Success URL - url на который будет переадресован пользователь после успешной оплаты заказа.
  
• Fail URL - url на который будет переадресован пользователь после неудачно оплаты заказа.
  
• Язык виджета - список доступных языков виджета оплаты заказа, который появляется когда пользователь нажимает кнопку "оплатить".
  
• Использовать функционал онлайн касс - при использование модуля онлайн касс, установив данный параметр, клиенту на почту будет приходить чек оплаты.
  
• Тип схемы проведения платежей - выбор схемы оплата платежной системы. Одностадийная оплата, или двухстадийна. При двухстадийной оплате требуется подтверждение оплаты заказа в административной части.
  
• Статус возврата платежа - в этом пункте выбирается какой статус заказа, отвечает за возврат платежа. Т.е. выбрав указанный в этом пункте статус, в заказе, будет выполнена функция возврата платежа через API cloudpayments.
  
• Статус авторизации платежа (двухстадийные платежи) - в этом пункте выбирнается какой статус заказа, будет установлен после оплаты пользователем при двухстадийной схеме платежей. Статус отмена авторизованного платежа (двухстадийные платежи) - в этом пункте выбирается какой статус заказа, нужно выбрать в заказе, чтобы произвести отмену оплаты при двухстадийной схеме платежей, в момент когда оплата не подтверждена, а только авторизована. Подробнее о двухстадийной схеме оплат, можно прочитать у нас на сайте.
  
• Выберите НДС на доставку, если необходимо - в данном разделе можно установить размер ндс, с привязкой к добавленным на сайте службам доставки.
  

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

1. Авторизуйтесь в личном кабинете
   
2. Перейдите в "Сайты"
   
   
3. Добавьте свой сайт (если еще не добавили) и перейдите в настройки
   
   
4. Далее нажмите "настройка"
   
   

5. Напротив каждого хука скопируйте линк ниже для соответствующей настройки:

   • (Check) #SITE_URL#/bitrix/tools/sale_ps_result.php?action=check
     
   • (Fail) #SITE_URL#/bitrix/tools/sale_ps_result.php?action=fail
     
   • (Pay) #SITE_URL#/bitrix/tools/sale_ps_result.php?action=pay
     
   • (Confirm) #SITE_URL#bitrix/tools/sale_ps_result.php?action=confirm
     
   • (Refund) #SITE_URL#/bitrix/tools/sale_ps_result.php?action=refund
     

Где #SITE_URL# - адрес сайта. Например: http://domain.ru

Двухстадийная оплата

Двухстадийная оплата подразумевает использование двух команд: отдельно на авторизацию, отдельно на списание. После успешной авторизации, сумма операции будет блокирована на счету держателя, то есть он не сможет ей воспользоваться. Далее у ТСП есть до 30 дней в зависимости от типа карты для подтверждения операции, после чего произойдет списание денег. Если операцию не подтвердить в течение этого времени — она будет автоматически отменена. Подтверждать можно как всю сумму авторизации, так и часть.

Как правило, двухстадийная схема используется для получения депозита с плательщика, например, в прокатных компаниях или отелях.

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

Для того чтобы включить двухстадийную оплату нужно зайти в настройки модуля и в "Тип схемы проведения платежей" выбрать "Двухстадийная оплата". После чего платежная система будет работать по следующей схеме:

1. Клиент оплачивает на сайте заказа
   
2. Заказ переходит в статус "Авторизован" и в данный момент оплата считается "авторизованной" и требует подтверждения администратором в административной части.
   
3. Для этого переходим в редактирования соответствующего заказа. И меняем текущий статус заказа на новый. Выбранный в этом пункте настроек модуля
   
4. После того как будет получен ответ от 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 в случае если используется стандартный компонент битрикса.

Техподдержка осуществляется по email support@cloudpayments.ru