Инструкция по интеграции Uniteller с магазином на 1С-Битрикс

Шаг 1: Настройки в системе Uniteller

Для подключения модуля «Платёжная система Uniteller» необходимо выполнить ряд настроек системы Uniteller. Для этого выполните следующие действия:

1. Зайдите в Личный кабинет платёжной системы Uniteller, находящийся по адресу: http://lk.uniteller.ru/. Данные ваших тестовой и «боевой» учётных записей для авторизации в Личном кабинете указаны в договоре с Uniteller.
2. По ссылке Главного меню «Точки продажи» перейдите на страницу работы с Точками продажи компании (интернет-магазинами). Центральную часть страницы «Точки продажи компании» занимает таблица с данными о подключённых интернет-магазинах.
3. Выберите строку с информацией о требуемом интернет-магазине.
4. В выбранной строке нажмите значок («Редактировать») — откроется страница «Редактирование точки продажи».
5. На странице «Редактирование точки продажи» заполните значения следующих полей:
   • В поле «URL магазина:» введите адрес сайта интернет-магазина.
   • В поле «E-Mail службы поддержки магазина:» введите адрес электронной почты интернет-магазина.
   • В поле «URL-адрес уведомления магазина:» введите значение «http://адрес_электронного_магазина/personal/ordercheck/result_rec.php» (где «адрес_электронного_магазина» — адрес сайта интернет-магазина).
6. Для сохранения сделанных изменений нажмите кнопку [ Сохранить ]. Изменения будут сохранены, и произойдёт переход на страницу работы с точками продажи.

Шаг 2: Настройки на стороне 1С-Битрикс

Для подключения модуля «Платёжная система Uniteller» необходимо выполнить ряд настроек в системе управления сайта интернет-магазина. Для этого выполните следующие действия:

1. Зайдите под учётной записью с правами администратора на сайт и перейдите в раздел «Администрирование».
2. Перейдите в раздел: «Настройки / Настройки продукта / Сайты / Список сайтов».
3. В списке сайтов выберите нужный интернет-магазин и дважды щёлкните по нему мышкой. Заполните следующие поля: В поле «URL сервера (без http://)» введите актуальный URL интернет-магазина (без http://). В поле «E-Mail адрес по умолчанию» введите актуальный адрес электронной почты интернет-магазина.
4. Сохраните изменения.

Шаг 3: Настройка модуля

Для настройки модуля «Платёжная система Uniteller» выполните следующие действия:

1. Убедитесь в том, что вы авторизованы на сайте CMS «1С-Bitrix» под учётной записью с правами администратора.
2. Перейти в раздел «Магазин / Настройки магазина / Платежные системы».
3. Над таблицей с перечнем платёжных систем нажмите кнопку [ Добавить платежную систему ] и в раскрывающемся списке выберите сайт, для которого требуется добавить платёжную систему. Откроется раздел добавления новой платёжной системы.
4. Перейдите во вкладку «Платежная система».
5. Заполнить следующие поля: Поле «Валюта» — валюта платёжной системы. Инструкция по установке и настройки модуля «Платёжная система Uniteller» для интернет-магазинов на базе CMS «1С-Bitrix» http://www.uniteller.ru, +7 (495) 987-19-60 5 Поле «Название» — введите слово «Uniteller» (Обращаем ваше внимание на то, что в поле «Название» допустимо только значение «Uniteller», любое другое значение приводит к ошибкам в оформлении платежа и работе приложения.). Флажок «Активность» — ставим «галочку». Поле «Сортировка» — введите значение «1». Поле «Описание» — краткое описание платёжной системы.
6. Перейдите на вкладку «Физическое лицо». В поле «Применяется для данного типа плательщика» поставьте галочку, чтобы выбранная платёжная система работала с «Физическими лицами».
7. В поле «Название» введите название обработчика платёжной системы. Это название будет отображаться покупателю на странице оформления заказа в секции «Платежная система» как один из вариантов оплаты. По умолчанию можно указать название «Uniteller».
8. В поле «Обработчик» выберите из раскрывающегося списка Uniteller — откроются следующие дополнительные поля, которые необходимо заполнить:
   • Поле «Описание платежной системы» — необходимо заполнить.
   • В поле «Код магазина» введите значение параметра Uniteller Point ID (идентификатор точки продажи в системе Uniteller), указанное на странице «Точки продажи» Личного кабинета системы Uniteller в строке с информацией о соответствующей точке продажи, столбец «Uniteller Point ID».
   • В поле «Логин» введите значение поля Login со страницы «Параметры авторизации» Личного кабинета Uniteller.
   • В поле «Пароль» введите значение поля Password со страницы «Параметры авторизации» Личного кабинета Uniteller.
   • В поле «Латинское наименование точки приема, присвоенное Uniteller» введите название интернет-магазина в латинской транслитерации или на английском языке (по вашему выбору). Это название используется при генерации чека.
   • В поле «Адрес при успешной оплате (URL_RETURN_OK)» введите тот url, на который хотите перенаправить покупателя после успешной оплаты (не путать с url для автоматического уведомления об оплате, на который обращается сервер Uniteller чтобы проставить пометку Оплаты заказа).
   • В поле «Адрес при ошибке оплаты (URL_RETURN_NO)» введите тот url, на который хотите перенаправить покупателя в случае неуспешной оплаты
9. Перейдите на вкладку «Юридическое лицо» и повторите все действия по аналогии с вкладкой «Физическое лицо».
10. Для сохранения изменений нажмите кнопку [Сохранить]. В списке появится платёжная система Uniteller

Фискализация (поддержка системы Онлайн-касса)

Модуль поддерживает обновленное API Uniteller с фискализацией.
Для использования нового API с фискализацией необходимо в настройках обработчика установить соответствующую опцию "Использовать форму оплаты с фискализацией" в значение Y.

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

  Также в чек будет передаваться ставка НДС по каждому товару из заказа. Cтавка НДС передается та ставка НДС, что указана в настройках каталога товаров по каждому товару.

Обновления от 01.01.2019

Uniteller добавили в чек 2 обязательных параметра - Payattr и Lineattr.

Payattr. Признак способа расчета

Возможные значения:
1 - Полная предварительная оплата до момента передачи предмета расчёта
2 - Частичная предварительная оплата до момента передачи предмета расчёта
3 - Аванс
4 - Полная оплата, в том числе с учётом аванса (предварительной оплаты) в момент
передачи предмета расчёта
5 - Частичная оплата предмета расчёта в момент его передачи с по-следующей
оплатой в кредит
6 - Передача предмета расчёта без его оплаты в момент его передачи с
последующей оплатой в кредит
7 - Оплата предмета расчёта после его передачи с оплатой в кредит (оплата кредита)

  Значение по-умолчанию в модуле - 1.

Lineattr. Признак предмета расчета

Возможные значения:
1 - о реализуемом товаре, за исключением подакцизного товара (наименование и иные сведения, описывающие товар)
2 - о реализуемом подакцизном товаре (наименование и иные сведения, описывающие товар)
3 - о выполняемой работе (наименование и иные сведения, описывающие работу)
4 - об оказываемой услуге (наименование и иные сведения, описывающие услугу)
5 - о приеме ставок при осуществлении деятельности по проведению азартных игр
6 - о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр
7 - о приеме денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей
8 - о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотерей
9 - о предоставлении прав на использование результатов интеллектуальной деятельности или средств индивидуализации
10 - об авансе, задатке, предоплате, кредите, взносе в счет оплаты, пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчета
11 - о вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом
12 - о предмете расчета, состоящем из предметов, каждому из которых может быть присвоено значение от «1» до «11»
13 - о предмете расчета, не относящемуся к предметам расчета, которым может быть присвоено значение от «1» до «12» и от «14» до «18»
14 - о передаче имущественных прав
15 - о внереализационном доходе
16 - о суммах расходов, уменьшающих сумму налога (авансовых платежей) в соответствии с пунктом 3.1 статьи 346.21 Налогового кодекса Российской Федерации
17 - о суммах уплаченного торгового сбора

Значение по-умолчанию в модуле - 1.

Кнопка оплаты

Если кнопка оплаты после оформления заказа не появляется, обратите внимание на опцию "открывать в новом окне" в настройках платежной системы.

Возврат средств (чек)

Зайдите в личный кабинет Uniteller. На странице «Заказы» с помощью фильтров найдите
нужный вам заказ и перейдите на страницу детальной информации о заказе.

На детальной странице нажимите кнопку [Возврат средств].


После этого отобразится форма возврата заказа, содержащей данные чека возврата,
сформированные на основании чека прихода. При
необходимости, скорректируйте содержание чека и нажимает кнопку [Выполнить возврат средств]

Тестовые платежи

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

Для тестирования следует использовать только данные следующих тестовых платёжных карт:
− Номер карты — 4000000000002487 (или следующие номера карт:
 • 4000000000002420
 • 4000000000002438
 • 5000000000002443
 • 5000000000002450
 • 2200060300746821 («Мир»)
− Срок действия — 01/23
− Имя держателя карты — UNITELLER TEST
− CVV — 123

Сумма тестового платежа должна быть в пределах 10,00–100,00 руб. (включительно).

Как посмотреть код/текст ошибки на сайте Uniteller

Теги: uniteller, uniteller.ru, платежная система, интеграция с платежной системой