View source for Draft:X-Cart:ROBOKASSA

==ROBOKASSA для X-Cart: Общие сведения==
Владельцы лицензий [http://www.x-cart.ru русскоязычных версий] X-Cart 4.6.1 и 4.6.2 имеют возможность организовать прием платежей на сайте своего магазина на X-Cart через известный агрегатор платежей [http://www.robokassa.ru ROBOKASSA].

ROBOKASSA - это сервис, позволяющий принимать платежи от клиентов с помощью [http://robokassa.ru/ru/Creditcards.aspx банковских карт], в любой [http://robokassa.ru/ru/Currencies.aspx электронной валюте], с помощью сервисов [http://robokassa.ru/ru/Sms.aspx мобильная коммерция] (МТС, Мегафон, Билайн), платежи через [http://robokassa.ru/ru/E-invoicing.aspx интернет-банк] ведущих Банков РФ, платежи через банкоматы, через [http://robokassa.ru/ru/Terminals.aspx терминалы мгновенной оплаты], а также с помощью [http://robokassa.ru/ru/iRobokassa.aspx приложения для iPhone].

В русскоязычных версиях X-Cart 4.6.1 и 4.6.2 интеграция с сервисом ROBOKASSA выполнена в форме платежного модуля. Данный платежный модуль может быть активирован и настроен через секцию «Способы оплаты» ('''Настройки -> Способы оплаты''') в интерфейсе Администратора X-Cart.

Необходимым условием работы модуля является подключение магазина к сервису ROBOKASSA.
 
==Подключение магазина к сервису ROBOKASSA==
Для подключения Вашего магазина на X-Cart к ROBOKASSA, выполните следующие шаги:
# Убедитесь, что сайт вашего магазина на X-Cart соответствует [http://robokassa.ru/ru/Requirements.aspx требованиям] ROBOKASSA.
# [https://partner.robokassa.ru/Reg/Register?culture=ru Зарегистрируйтесь] на сайте ROBOKASSA:<br />[[File:new_client_registration.png|border]]<br />{{Note1|'''Примечание:''' Процесс регистрации физических и юридических лиц различается; актуальную информацию об особенностях подключения и необходимости предоставления документов для физических и юридических лиц можно найти на сайте [http://robokassa.ru/ru/Contract.aspx robokassa.ru]}}.<br />При заполнении формы регистрации обязательно укажите реально существующий, действующий адрес электронной почты: на этот адрес будет выслано письмо c идентификационными данными для доступа в Ваш Личный кабинет в системе ROBOKASSA. Вы можете изменить пароль, полученный по почте, в Личном кабинете в разделе [http://partner.robokassa.ru/Workers/My Настройки -> Мой доступ], закладка «Настройка Доступа».
# После регистрации Вы будете перенаправлены на страницу с формой «Вход в личный кабинет клиента»:<br />[[File:Cabinet_login.png|border]]<br />(Вы всегда можете попасть на эту страницу переходом по ссылке «Личный кабинет магазина» с любой страницы сайта robokassa.ru).<br />Авторизуйтесь, используя данные, указанные Вами при регистрации, а также пароль, полученный по электронной почте.
# После входа в Личный кабинет, рекомендуется сразу заполнить в разделе «Настройки» такие пункты, как:
#* «Мой доступ» (Здесь необходимо указать Ваши данные и контактную информацию);
#* «Расчётные счета» (Здесь необходимо указать платёжные реквизиты, на которые должны поступать Ваши денежные средства);
#* Если Вы подключаетесь как юридическое лицо, необходимо также заполнить пункт «Данные юридического лица».
# Основной задачей после входа в Личный кабинет является создание Магазина. В разделе [https://partner.robokassa.ru/Shops Управление -> Мои магазины] добавьте и настройте Ваш магазин. Для этого необходимо выбрать '''[+] Добавить новый''':<br />[[File:Stores.png|border]]<br />и на открывшейся странице заполнить все необходимые поля:<br />[[File:Store_settings.png|border]]<br />Значение для поля «Идентификатор магазина» необходимо придумать. Будьте внимательны: в дальнейшем при редактировании данных магазина изменить это значение будет нельзя. Данное значение будет использоваться в качестве логина Вашего магазина в обменном пункте ROBOKASSA и понадобится Вам для настройки платежного модуля ROBOKASSA на стороне X-Cart.
# После заполнения всех необходимых для создания магазина данных, выберите '''Сохранить'''. Если всё заполнено корректно, Вы будете перенаправлены на страницу редактирования технических настроек магазина:<br />[[File:Tech_settings.png|border]]<br />На этой странице необходимо указать данные для технического взаимодействия сервиса ROBOKASSA и Вашего магазина X-Cart:<br />
#* Значения для полей «Пароль #1» и «Пароль #2"» необходимо придумать. Данные значения понадобятся Вам также для настройки платежного модуля ROBOKASSA в Вашем магазине X-Cart.
#* Значения для полей «Result Url», «Success Url» и «Fail Url» необходимо скопировать со страницы настройки платежного модуля ROBOKASSA в Вашем магазине X-Cart (Удобнее всего будет открыть интерфейс Администратора X-Cart в новом окне или отдельной вкладке браузера, перейти на [[страницу настройки платежного модуля ROBOKASSA]] и перенести значения адресов Result Url, Success Url и Fail Url оттуда в настройки магазина в Вашем Личном кабинете).
#* В качестве метода отсылки данных для всех случаев необходимо указать POST.
# После заполнения всех необходимых технических данных, выберите '''Сохранить'''.
# Если в Вашей работе возникнет необходимость предоставления доступа к Вашему Личному кабинету сотрудникам Вашей организации, разработчикам или сторонним специалистам, то у Вас есть возможность создать им отдельный логин и пароль для входа, с указанными Вами ограничениями. Это можно сделать в разделе [https://partner.robokassa.ru/Workers Управление -> Сотрудники и доступ].
# По завершении настройки подключения к ROBOKASSA в Личном кабинете, выполните шаги по включению и настройке платежного модуля ROBOKASSA в Вашем магазине на X-Cart. См. пункты [[#EnableDisableRobokassa|Включение и отключение способа оплаты через ROBOKASSA в X-Cart]] и [[#ConfigureRobokassa|Настройка платежного модуля ROBOKASSA в X-Cart]] ниже.
# После выполнения всех вышеописанных действий, Вы можете направить в адрес ROBOKASSA запрос на Активацию магазина для приёма платежей. Запрос на Активацию отправляется со страницы «Настройки» соответствующего магазина в Вашем Личном кабинете в системе ROBOKASSA, по кнопке '''Запрос на активацию'''.<br />[[File:Activation_request.png|border]]<br />{{Note1|'''Примечание:''' Если Вами не заполнены какие-то важные разделы, информация из которых необходима для работы, то в настройках магазина будет присутствовать информация об этом, а кнопка '''Запрос на активацию''' отображаться не будет.}}

==Включение и отключение способа оплаты через ROBOKASSA в X-Cart==
<div id="EnableDisableRobokassa"></div>Включение возможности приема платежей с использованием сервиса ROBOKASSA в X-Cart осуществляется путем добавления и активации соответствующего способа оплаты в интерфейсе Администратора Вашего магазина. При этом для начала использования ROBOKASSA необходимо выполнить следующие шаги:
# [[#AddRobokassa|Добавить]] способ оплаты ROBOKASSA в список способов оплаты Вашего магазина.
# [[#ConfigureRobokassa|Настроить]] платежный модуль ROBOKASSA.
# [[#ActivateRobokassa|Активировать]] способа оплаты ROBOKASSA в Вашем магазине.
Для временного отключения способа оплаты через ROBOKASSA для Ваших покупателей, необходимо его [[#DeactivateRobokassa|деактивировать]]. 

===Добавление способа оплаты ROBOKASSA===
<div id="AddRobokassa"></div>Чтобы включить способ оплаты товаров в Вашем магазине с использованием сервиса ROBOKASSA, выполните следующие шаги:
# Войдите в интерфейс Администратора X-Cart и перейдите в нем на страницу «Способы оплаты» ('''Настройки -> Способы оплаты'''):<br />[[File:Go_to_payment_methods.png|border]]
# На странице «Способы оплаты» откройте закладку «Платежные шлюзы»:<br />[[File:Go_to_payment_gateways.png|border]]
# На открывшейся странице удостоверьтесь, что в поле «Ваша страна» выбрано ''Российская Федерация'':<br />[[File:RF_country.png|border]]<br />а из выпадающего списка в поле «Платежные шлюзы» выберите платежную систему ROBOKASSA:[[File:Select_robokassa.png|border]]
# Выберите '''Добавить''':<br />[[File:Add_robokassa.png|border]]<br />Способ оплаты ROBOKASSA будет добавлен в список на странице «Способы оплаты»:<br />[[File:Robokassa_method_added.png]]<br />Теперь Вы можете [[#ConfigureRobokassa|настроить]] соответствующий платежный модуль и [[#ActivateRobokassa|активировать]] данный способ оплаты, чтобы сделать его доступным для Ваших покупателей.

===Настройка платежного модуля ROBOKASSA в X-Cart===
<div id="ConfigureRobokassa"></div>Для настройки платежного модуля ROBOKASSA в Вашем магазине на X-Cart, выполните следующие шаги:

#* sMerchantPass1: Значение поля «Пароль #1» со страницы технических настроек соответствующего магазина в Вашем личном кабинете в системе Робокасса.
#* sMerchantPass2: Значение поля «Пароль #2» со страницы технических настроек соответствующего магазина в Вашем личном кабинете в системе Робокасса.

===Активация способа оплаты ROBOKASSA===
<div id="ActivateRobokassa"></div>

===Деактивация способа оплаты ROBOKASSA===
<div id="DeactivateRobokassa"></div>