Модуль позволит с легкостью добавить на ваш сайт оплату банковскими картами и онлайн-фискализацию интернет-платежей в рамках соблюдения закона 54-ФЗ через платежный сервис CloudPayments.
Для корректной работы модуля необходима регистрация в сервисе.
О процессинге:
CloudPayments — это конструктор IT-решений для участников рынка электронной коммерции.
Партнеры получают самый полный набор ключевых технических опций, позволяющих создать клиентоориентированную систему оплаты на сайте или в мобильном приложении.
Мы позволяем партнерам принимать платежи не только в рублях, но и других валютах мира.
Документация CloudPaymentsДанные для тестирования
<b>Установка через bitrix marketplace<br /></b><br />Нажмите "установить", укажите url сайта, вас перебросит на сайт. <br />После чего нужно авторизоваться под админом, и скачать и установить модуль.<br /><br /><br /><br /><b>Настройка модуля<br /></b><br /><ol><li>Сначала нужно создать новую платежную систему. Перейдите «Магазин» -> “Платежные системы» /bitrix/admin/sale_pay_system.php?lang=ru<br /><li>Нажмите кнопку «Добавить платежную систему»<br /><li>В качестве обработчика выберите CloudPayments (cloudpayment).Далее введите:- название- описание и прочие поля заполните по своему усмотрению.Нажмите «Применить», чтобы появились настройки самой платежной системы.<br /><li>Далее перейдите в раздел «<a href="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img3.png" target="_blank" >Настройка обработчика ПС</a>»<br /><li>Заполните: «Public ID», «Пароль для API», и выберите «<a href="https://github.com/cloudpayments/CMS-Bitrix-CP/blob/master/images/img0.png" target="_blank" >Тип схемы проведения платежей</a>»<br /></ol>Остальные параметры заполните на свое усмотрение.<br /><br /><br /><br /><b>Описание параметров модуля:<br /></b><br /><ul><li><b>Success URL</b> - url на который будет переадресован пользователь после успешной оплаты заказа.<br /><li><b>Fail URL </b>- url на который будет переадресован пользователь после неудачно оплаты заказа.<br /><li><b>Язык виджета</b> - список доступных языков виджета оплаты заказа, который появляется когда пользователь нажимает кнопку "оплатить".<br /><li><b>Использовать функционал онлайн касс</b> - при использование модуля онлайн касс, установив данный параметр, клиенту на почту будет приходить чек оплаты.<br /><li><b>Тип схемы проведения платежей</b> - выбор схемы оплата платежной системы. Одностадийная оплата, или двухстадийна. При двухстадийной оплате требуется подтверждение оплаты заказа в административной части.<br /><li><b>Статус возврата платежа</b> - в этом пункте выбирается какой статус заказа, отвечает за возврат платежа. Т.е. выбрав указанный в этом пункте статус, в заказе, будет выполнена функция возврата платежа через API cloudpayments.<br /><li><b>Статус авторизации платежа (двухстадийные платежи) </b>- в этом пункте выбирнается какой статус заказа, будет установлен после оплаты пользователем при двухстадийной схеме платежей. Статус отмена авторизованного платежа (двухстадийные платежи) - в этом пункте выбирается какой статус заказа, нужно выбрать в заказе, чтобы произвести отмену оплаты при двухстадийной схеме платежей, в момент когда оплата не подтверждена, а только авторизована. Подробнее о двухстадийной схеме оплат, можно прочитать у нас на <a href="https://cloudpayments.ru/wiki/integration/products/widget#schemes" target="_blank" >сайте</a>.<br /><li><b>Выберите НДС на доставку,</b> если необходимо - в данном разделе можно установить размер ндс, с привязкой к добавленным на сайте службам доставки.<br /></ul><b><br /></b><br /><b>Настройка вебхуков:<br /></b>Для корректной работы модуля, а именно подтверждения оплаты, подтверждения авторизации и прочих действий, нужно прописать правильные url в настройках вебхуков CloudPayments:<br /><ol><li>Авторизуйтесь в личном <a href="https://merchant.cloudpayments.ru/Account/Login" target="_blank" >кабинете</a><br /><li>Перейдите в "Сайты"<br /><img src="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img4.png" border="0" width="254" height="557" data-bx-image="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img4.png" data-bx-onload="Y" /><br /><li>Добавьте свой сайт (если еще не добавили) и перейдите в настройки<br /><img src="https://github.com/cloudpayments/CMS-Bitrix-CP/blob/master/images/img5.png?raw=true" border="0" width="515" height="289" data-bx-image="https://github.com/cloudpayments/CMS-Bitrix-CP/blob/master/images/img5.png?raw=true" data-bx-onload="Y" /><br /><li>Далее нажмите "настройка"<br /><img src="https://github.com/cloudpayments/CMS-Bitrix-CP/blob/master/images/img6.png?raw=true" border="0" width="800" height="218" data-bx-image="https://github.com/cloudpayments/CMS-Bitrix-CP/blob/master/images/img6.png?raw=true" data-bx-onload="Y" /><br /><li><p>Напротив каждого хука скопируйте линк ниже для соответствующей настройки:</p><ul><li>(Check) <span class="bx-inline-tag" bx-tag-value="SITE_URL#/bitrix/tools/sale_ps_result">#SITE_URL#/bitrix/tools/sale_ps_result</span>.php?action=check<br /><li>(Fail) <span class="bx-inline-tag" bx-tag-value="SITE_URL#/bitrix/tools/sale_ps_result">#SITE_URL#/bitrix/tools/sale_ps_result</span>.php?action=fail<br /><li>(Pay) <span class="bx-inline-tag" bx-tag-value="SITE_URL#/bitrix/tools/sale_ps_result">#SITE_URL#/bitrix/tools/sale_ps_result</span>.php?action=pay<br /><li>(Confirm) <span class="bx-inline-tag" bx-tag-value="SITE_URL#bitrix/tools/sale_ps_result">#SITE_URL#bitrix/tools/sale_ps_result</span>.php?action=confirm<br /><li>(Refund) <span class="bx-inline-tag" bx-tag-value="SITE_URL#/bitrix/tools/sale_ps_result">#SITE_URL#/bitrix/tools/sale_ps_result</span>.php?action=refund<br /></ol></ul><p>Где <span class="bx-inline-tag" bx-tag-value="SITE_URL#">#SITE_URL#</span> - адрес сайта. Например: <a href="https://domain.ru/" target="_blank" >https://domain.ru</a></p><p></p><b><br /></b><br /><b>Двухстадийная оплата</b><br /><p>Двухстадийная оплата подразумевает использование двух команд: отдельно на авторизацию, отдельно на списание. После успешной авторизации, сумма операции будет блокирована на счету держателя, то есть он не сможет ей воспользоваться. Далее у ТСП есть до 30 дней в зависимости от типа карты для подтверждения операции, после чего произойдет списание денег. Если операцию не подтвердить в течение этого времени — она будет автоматически отменена. Подтверждать можно как всю сумму авторизации, так и часть.</p><p>Как правило, двухстадийная схема используется для получения депозита с плательщика, например, в прокатных компаниях или отелях.</p><p>В зависимости от настройки, система может автоматически выполнять подтверждение двустадийных платежей через указанное количество дней.</p><p>Для того чтобы включить двухстадийную оплату нужно зайти в настройки модуля и в "Тип схемы проведения платежей" выбрать "Двухстадийная оплата". После чего платежная система будет работать по следующей схеме:</p><ol><li>Клиент оплачивает на сайте заказа<br /><li>Заказ переходит в статус "Авторизован" и в данный момент оплата считается "авторизованной" и требует подтверждения администратором в административной части.<br /><li>Для этого переходим в редактирования соответствующего заказа. И меняем текущий статус заказа на новый. Выбранный в этом пункте настроек модуля<img src="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img7.png" border="0" width="800" height="36" data-bx-image="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img7.png" data-bx-onload="Y" /><br /><li>После того как будет получен ответ от cloudpayments (если вы настроили вебхук confirm), об успешном подтверждении, заказ будет считаться оплаченым. И статус заказа перейдет в "оплачен, формируется к отправке".<br /></ol><b><br /></b><br /><b>Двухстадийная оплата - отмена авторизованного платежа<br /></b><br />Чтобы отменить оплаченный заказ. Нужно перейти в редактирование заказа и в статусе заказа выбрать статус выбранный в настройках модуля.<br /><img src="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img8.png" border="0" width="800" height="38" data-bx-image="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img8.png" data-bx-onload="Y" /><br />После чего будет отправлен void запрос на отмену оплаты.<br /><br /><b>Возврат оплаченного заказа</b><br /><p>Чтобы вернуть (отменить) оплаченный заказ. Нужно перейти в редактирование заказа и в статусе заказа выбрать выбранный статус в настройках модуля: </p><p><img src="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img9.png" border="0" width="660" height="35" data-bx-image="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img9.png" data-bx-onload="Y" /></p>После чего будет отправлен refund запрос на возрат оплаты. Также возрат оплаты будет произведена автоматически, если будет отменен или удален заказ в ЛК сайта или в редактирование заказа.<br />Если вы не можете ограничить доступ к управлению заказами, и при этом вам не нужна функция возврата из ЛК Битрикса, то можно ее отключить (воизбежание ошибочных возратов). Для этого откройте файл include.php и закоментируйте строчку №268 (можно поменять url на local.domain).<br /><img src="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img9-1.png" border="0" width="800" height="378" data-bx-image="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img9-1.png" data-bx-onload="Y" /><br /><br /><b>Заказы в статусе "возврат"<br /></b><br />Если заказа в статусе возврат, кнопки оплатить виджета не будет, а вместо нее будет выводиться фраза:<br /><img src="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img12.png" border="0" width="800" height="378" data-bx-image="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img12.png" data-bx-onload="Y" /><br /><br /><br />можно изменить тут /bitrix/php_interface/include/sale_payment/cloudpayment/template/lang/ru/template.php В личном кабинете пользователя может выводиться кнопка "оплатить" компонента, но при нажатие кнопки будет выводиться фраза описанная выше. Кнопку оплаты битрикса можно удалить в шаблоне списка заказов sale.personal.order.list в случае если используется стандартный компонент битрикса.<br /><br /><b><br /></b><br /><b>Прочие настройки<br /></b><br />При двухстадийной схеме оплаты, и использование дефолтного личного кабинета пользователя на сайте. Может возникнуть ситуация, что заказа оплачен пользователем (авторизована оплата), но не подтверждена администратором сайта. И фактически битрикс такой заказ считает не оплаченым, и выводит в личном кабинете кнопку оплаты. Пример.<br /><img src="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img10.png" border="0" width="800" height="389" data-bx-image="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img10.png" data-bx-onload="Y" /><br />Виджет модуля Cloudpayments конечно такой заказа повторно оплатить не даст, и при нажатие оплаты выведет текст, что заказ уже оплачен и требует подтверждения. <br /><img src="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img11.png" border="0" width="800" height="412" data-bx-image="https://github.com/cloudpayments/CMS-Bitrix-CP/raw/master/images/img11.png" data-bx-onload="Y" /><br /><p>Данный текст можно поменять тут /bitrix/php_interface/include/sale_payment/cloudpayment/template/lang/ru/template.php</p><p>Кнопку оплаты битрикса можно удалить в шаблоне списка заказов sale.personal.order.list в случае если используется стандартный компонент битрикса.</p><b><p></p></b>
Техподдержка осуществляется по email <a href="mailto:support@cloudpayments.ru" target="_blank" >support@cloudpayments.ru</a>