Draft:X-Cart:ROBOKASSA

ROBOKASSA для X-Cart: Общие сведения

Владельцы лицензий русскоязычных версий X-Cart 4.6.1 и 4.6.2 имеют возможность организовать прием платежей на сайте своего магазина на X-Cart через известный агрегатор платежей ROBOKASSA.

ROBOKASSA - это сервис, позволяющий принимать платежи от клиентов с помощью банковских карт, в любой электронной валюте, с помощью сервисов мобильная коммерция (МТС, Мегафон, Билайн), платежи через интернет-банк ведущих Банков РФ, платежи через банкоматы, через терминалы мгновенной оплаты, а также с помощью приложения для iPhone.

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

Необходимым условием работы модуля является подключение магазина к сервису ROBOKASSA.

Подключение магазина к сервису ROBOKASSA

Для подключения Вашего магазина на X-Cart к ROBOKASSA, выполните следующие шаги:

1. Убедитесь, что сайт вашего магазина на X-Cart соответствует требованиям ROBOKASSA.
2. Зарегистрируйтесь на сайте ROBOKASSA:
   
   
   Примечание: Процесс регистрации физических и юридических лиц различается; актуальную информацию об особенностях подключения и необходимости предоставления документов для физических и юридических лиц можно найти на сайте robokassa.ru
   .
   При заполнении формы регистрации обязательно укажите реально существующий, действующий адрес электронной почты: на этот адрес будет выслано письмо c идентификационными данными для доступа в Ваш Личный кабинет в системе ROBOKASSA. Вы можете изменить пароль, полученный по почте, в Личном кабинете в разделе Настройки -> Мой доступ, закладка «Настройка Доступа».
3. После регистрации Вы будете перенаправлены на страницу с формой «Вход в личный кабинет клиента»:
   
   
   (Вы всегда можете попасть на эту страницу переходом по ссылке «Личный кабинет магазина» с любой страницы сайта robokassa.ru).
   Авторизуйтесь, используя данные, указанные Вами при регистрации, а также пароль, полученный по электронной почте.
4. После входа в Личный кабинет, рекомендуется сразу заполнить в разделе «Настройки» такие пункты, как:
   • «Мой доступ» (Здесь необходимо указать Ваши данные и контактную информацию);
   • «Расчётные счета» (Здесь необходимо указать платёжные реквизиты, на которые должны поступать Ваши денежные средства);
   • Если Вы подключаетесь как юридическое лицо, необходимо также заполнить пункт «Данные юридического лица».
5. Основной задачей после входа в Личный кабинет является создание Магазина. В разделе Управление -> Мои магазины добавьте и настройте Ваш магазин. Для этого необходимо выбрать [+] Добавить новый:
   
   
   и на открывшейся странице заполнить все необходимые поля:
   
   
   Значение для поля «Идентификатор магазина» необходимо придумать. Будьте внимательны: в дальнейшем при редактировании данных магазина изменить это значение будет нельзя. Данное значение будет использоваться в качестве логина Вашего магазина в обменном пункте ROBOKASSA и понадобится Вам для настройки платежного модуля ROBOKASSA на стороне X-Cart.
6. После заполнения всех необходимых для создания магазина данных, выберите Сохранить. Если всё заполнено корректно, Вы будете перенаправлены на страницу редактирования технических настроек магазина:
   
   
   На этой странице необходимо указать данные для технического взаимодействия сервиса ROBOKASSA и Вашего магазина X-Cart:
   
   • Значения для полей «Пароль #1» и «Пароль #2"» необходимо придумать. Данные значения понадобятся Вам также для настройки платежного модуля ROBOKASSA в Вашем магазине X-Cart.
   • Значения для полей «Result Url», «Success Url» и «Fail Url» необходимо скопировать со страницы настройки платежного модуля ROBOKASSA в Вашем магазине X-Cart (Удобнее всего будет открыть интерфейс Администратора X-Cart в новом окне или отдельной вкладке браузера, перейти на страницу настройки платежного модуля ROBOKASSA и перенести значения адресов Result Url, Success Url и Fail Url оттуда в настройки магазина в Вашем Личном кабинете).
   • В качестве метода отсылки данных для всех случаев необходимо указать POST.
7. После заполнения всех необходимых технических данных, выберите Сохранить.
8. Если в Вашей работе возникнет необходимость предоставления доступа к Вашему Личному кабинету сотрудникам Вашей организации, разработчикам или сторонним специалистам, то у Вас есть возможность создать им отдельный логин и пароль для входа, с указанными Вами ограничениями. Это можно сделать в разделе Управление -> Сотрудники и доступ.
9. По завершении настройки подключения к ROBOKASSA в Личном кабинете, выполните шаги по включению и настройке платежного модуля ROBOKASSA в Вашем магазине на X-Cart. См. пункты Включение и отключение способа оплаты через ROBOKASSA в X-Cart и Настройка платежного модуля ROBOKASSA в X-Cart ниже.
10. После выполнения всех вышеописанных действий, Вы можете направить в адрес ROBOKASSA запрос на Активацию магазина для приёма платежей. Запрос на Активацию отправляется со страницы «Настройки» соответствующего магазина в Вашем Личном кабинете в системе ROBOKASSA, по кнопке Запрос на активацию.
    
    
    Примечание 1: Если Вами не заполнены какие-то важные разделы, информация из которых необходима для работы, то в настройках магазина будет присутствовать информация об этом, а кнопка Запрос на активацию отображаться не будет.
    Примечание 2: После активации магазина изменение любых его данных, а также использование тестового сервера ROBOKASSA, будет невозможно.

Включение и отключение способа оплаты через ROBOKASSA в X-Cart

Включение возможности приема платежей с использованием сервиса ROBOKASSA в X-Cart осуществляется путем добавления и активации соответствующего способа оплаты в интерфейсе Администратора Вашего магазина. При этом для начала использования ROBOKASSA необходимо выполнить следующие шаги:

1. Добавить способ оплаты ROBOKASSA в список способов оплаты Вашего магазина.
2. Настроить платежный модуль ROBOKASSA.
3. Активировать способа оплаты ROBOKASSA в Вашем магазине.

Для временного отключения способа оплаты через ROBOKASSA для Ваших покупателей, необходимо его деактивировать.

Добавление способа оплаты ROBOKASSA

Чтобы включить способ оплаты товаров в Вашем магазине с использованием сервиса ROBOKASSA, выполните следующие шаги:

1. Войдите в интерфейс Администратора X-Cart и перейдите в нем на страницу «Способы оплаты» (Настройки -> Способы оплаты):
   
   
   
2. На странице «Способы оплаты» откройте закладку «Платежные шлюзы»:
   
   
   
3. На открывшейся странице удостоверьтесь, что в поле «Ваша страна» выбрано Российская Федерация:
   
   
   а из выпадающего списка в поле «Платежные шлюзы» выберите платежную систему ROBOKASSA:
   
   
   
4. Выберите Добавить:
   
   
   Способ оплаты ROBOKASSA будет добавлен в список на странице «Способы оплаты»:
   
   
   Теперь Вы можете настроить соответствующий платежный модуль и активировать данный способ оплаты, чтобы сделать его доступным для Ваших покупателей.

Настройка платежного модуля ROBOKASSA в X-Cart

Для настройки платежного модуля ROBOKASSA в Вашем магазине на X-Cart, выполните следующие шаги:

1. В интерфейсе Администратора X-Cart в списке способов оплаты Вашего магазина (Настройки -> Способы оплаты) найдите способ оплаты, соответствующий приему оплаты через ROBOKASSA, и перейдите на страницу настройки соответствующего платежного модуля по ссылке Настроить:
   
   
   
2. На открывшейся странице, задайте все необходимые настройки для обеспечения технического взаимодействия Вашего магазина с сервисом ROBOKASSA:
   
   
   
   • Пароль продавца: Идентификатор магазина, заданный Вами при создании соответствующего магазина в Вашем личном кабинете в системе ROBOKASSA (Данный идентификатор можно видеть на странице редактирования технических настроек магазина).
   • sMerchantPass1: Пароль #1 со страницы технических настроек соответствующего магазина в Вашем личном кабинете в системе ROBOKASSA.
   • sMerchantPass2: Пароль #2 со страницы технических настроек соответствующего магазина в Вашем личном кабинете в системе ROBOKASSA.
   • Язык: Язык, на котором должна отображаться страница, где покупатель будет осуществлять ввод своих платежных данных.
   • Валюта: Данная настройка определяет метод оплаты, который будет выбран по умолчанию на странице оплаты через ROBOKASSA.
   • Префикс заказа: Префикс для идентификации заказа, оплачиваемого через ROBOKASSA, в системе. В X-Cart данный префикс может отображаться перед номером заказа в примечаниях к заказу и в тексте ошибок.
   • Тестовый/Реальный режимы: Режим работы платежного модуля ROBOKASSA (Тестовый - режим для работы с использованием тестового сервера ROBOKASSA; может быть использован только до активации магазина. Реальный - режим, в котором возможен прием платежей).
     
     Примечание: Значения адресов Result Url, Success Url и Fail Url, указанные на странице настройки платежного модуля ROBOKASSA в X-Cart, необходимо скопировать и перенести в настройки соответствующего магазина в Вашем Личном кабинете в системе ROBOKASSA.
3. Для сохранения настроек, выберите Обновить в нижней части страницы.

Активация способа оплаты ROBOKASSA

Для активации способа оплаты ROBOKASSA в Вашем магазине, выполните следующие шаги:

1. В интерфейсе Администратора X-Cart в списке способов оплаты Вашего магазина (Настройки -> Способы оплаты) найдите способ оплаты, соответствующий приему оплаты через ROBOKASSA, и выберите кнопку-флажок в крайней левой колонке напротив его названия.
2. Нажмите на кнопку Применить в нижней части страницы.
   Способ оплаты ROBOKASSA будет активирован.

Деактивация способа оплаты ROBOKASSA

Для деактивации способа оплаты ROBOKASSA в Вашем магазине, выполните следующие шаги:

1. В интерфейсе Администратора X-Cart в списке способов оплаты Вашего магазина (Настройки -> Способы оплаты) найдите способ оплаты, соответствующий приему оплаты через ROBOKASSA, и снимите флажок в крайней левой колонке напротив его названия.
2. Нажмите на кнопку Применить в нижней части страницы.
   Способ оплаты ROBOKASSA будет деактивирован.