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

80 9

1.2.7 (09.12.2025)	Добавлены новые поля для настройек кассового чека
1.2.6 (09.12.2025)	Исправления ошибки при формировании описания в оплате из-за кодировки
1.2.5 (09.12.2025)	Изменения в обработке ставки НДС и дополнительные поля для чеков
1.2.4 (24.10.2025)	Исправление мелких багов
1.2.3 (31.07.2025)	Исправление мелких багов
1.2.2 (09.07.2025)	Обновление настроек платежного виджета
1.2.1 (23.04.2025)	Внесены минорные правки
1.2.0 (28.03.2025)	Внесены минорные правки
1.1.9 (06.12.2024)	Внесены минорные правки
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»,  и выберите «Тип схемы проведения платежей»
   

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



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

Виджет – это окно для оплаты, которое появляется когда пользователь нажимает кнопку "оплатить".
Параметры установки

• Public ID - Public ID сайта из личного кабинета.
  
• Пароль для API - API Secret сайта из личного кабинета.
  

Параметры поведения виджета

• Success URL - url на который будет переадресован пользователь после успешной оплаты заказа. Если выбрано значение по-умолчанию - плательщик будет перенаправлен на страницу успешно оплаченного заказа
  
• Fail URL - url на который будет переадресован пользователь после неудачной оплаты заказа. Если выбрано значение по-умолчанию - плательщик останется на странице сформированного заказа
  

Параметры платежа

• Тип схемы проведения платежей - выбор схемы оплаты платежной системы: одностадийная оплата, или двухстадийная. При двухстадийной оплате требуется подтверждение оплаты заказа в личном кабинете. Подробнее о двухстадийной схеме оплаты, можно прочитать у нас на сайте.
  
• Статус возврата платежа - в этом пункте выбирается какой статус заказа, отвечает за возврат платежа. Т.е. при переводе заказа в указанный в этом пункте статус будет выполнена функция возврата платежа через API cloudpayments.
  
• Статус авторизации платежа (двухстадийные платежи) - в этом пункте выбирается, какой статус заказа будет установлен после оплаты пользователем при двухстадийной схеме платежей. Подробнее о двухстадийной схеме оплаты, можно прочитать у нас на сайте.
  
• Статус отмена авторизованного платежа (двухстадийные платежи) - в этом пункте выбирается, какой статус заказа нужно выбрать в заказе, чтобы произвести отмену авторизованного платежа при двухстадийной схеме платежей. Подробнее о двухстадийной схеме оплаты, можно прочитать у нас на сайте.
  

Визуальные параметры

• Дизайн виджета - выбор визуальной темы виджета: темная (modern) / светлая (classic). По умолчанию используется светлая тема
  
• Язык виджета - список доступных языков виджета. По умолчанию используется русский язык
  
• Отображение email на форме оплаты - настройка позволяет выбрать опции отображения поля на форме оплаты. По умолчанию - опционально, т.е. поле необязательно и доступно для заполнения клиентом. E-mail используется для отправки квитанций об оплате
  
• Выберите порядок расположения методов оплаты - настройка позволяющая задать порядок подключенных методов оплаты на форме оплаты. Необходимо запросить возможность использования этого параметра в поддержке CloudPayments
  
• Количество отображаемых методов на форме оплаты - количество методов оплаты которые будут отображены на форме оплаты. Остальные методы будут раскрываться кнопкой “Другие”. Необходимо запросить возможность использования этого параметра в поддержке CloudPayments
  
• Выберите методы которые необходимо отключить - настройка позволяющая выбрать какие платежные методы не стоит отображать на форме оплаты. Достаточно выбрать только те методы, которые были подключены для вашего сайта
  

Параметры формирования чеков

• Использовать функционал онлайн касс -  при включении данного параметра будет проходить чек оплаты через кассовый модуль CloudKassir, если он у вас установлен. Необходимо установить параметр, чтобы избежать задвоения чеков
  
• ИНН организации - ИНН. Необходимо заполнить для формирования второго чека.
  
• Тип системы налогообложения - Варианты систем налогообложения юридических лиц и индивидуальных предпринимателей, которые используются при формировании кассовых чеков
  
• НДС из настроек модуля - если вкл., то значение НДС берется из настроек модуля; если выкл, то значение НДС берется из настроек в системе.
  
• Ставка НДС - значения ставки НДС.
  
• Ставка НДС для доставки - если необходимо - в данном разделе можно установить размер НДС с привязкой к добавленным на сайте службам доставки.
  
• Признак расчета в сети интернет - Этот признак подтверждает дистанционную оплату без прямого контакта продавца и покупателя. Без него не будет сформирован онлайн-чек.
  
• Часовая зона - выбор часового пояса. По умолчанию выбрано московское время UTC+3.
  

Настройка вебхуков:
Для корректной работы модуля, а именно подтверждения оплаты, подтверждения авторизации и прочих действий, нужно прописать правильные 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