«Аппекс» — интеграция — различия между версиями

Материал из wiki.Sletat.ru
Перейти к: навигация, поиск
(→‎В этом разделе описаны параметры, которые нужно настроить в Личном кабинете Слетать.ру.)
 
(не показано 14 промежуточных версий этого же участника)
Строка 1: Строка 1:
−
[[Category:Подключение платежных провайдеров]]
 
−
== Точка продаж ==
 
−
После заключения договора на предоставление эквайринговых услуг от компании Uniteller вы должны получить логин и пароль для входа в личный кабинет Uniteller. После входа в личный кабинет Uniteller по адресу http://lk.uniteller.ru/ вам должна быть доступна следующая страница:
 
  
−
[[File:ut-1.png|center|frame]]
+
== Заключение договора ==
 +
В этом разделе описан процесс заключения договора с платёжным провайдером Аппекс.
  
−
Обратите внимание на раздел «Параметры Авторизации». Выберите этот раздел, там вам будут доступны настройки «Логин» и «Пароль», значения которых необходимо перенести в настройки платежного провайдера в личном кабинете Слетать.Ру.
+
Для заключения договора вышлите на электронные адреса to@appex.ru и od@appex.ru следующие данные:
 +
* ФИО, телефон и e-mail контактного лица;
  
−
[[File:ut-2.png|center|frame]]
+
* телефон и e-mail, которые можно сообщать плательщикам в уведомлении;
  
−
Просто копируем значения Login и Password из браузера и вставляем в текстовые поля в личном кабинете Слетать.Ру:
+
* e-mail для отправки реестров по платежам;
  
−
[[File:ut-3.png|center|frame]]
+
* логотип агентства в формате PNG (желательно), GIF или JPG, размером не более 50Кб (рекомендованная высота: 56 px);
  
−
Внимание: не копируйте логин и пароль от вашего личного кабинета Uniteller. Необходимы значения только из раздела «Параметры авторизации».
+
* ожидаемый месячный оборот по платежам;
  
−
Далее, переходим в раздел «Точки продаж»:
+
* реквизиты компании на фирменном бланке.
 +
<blockquote>К письму на od@appex.ru прикрепите одним архивом (формат ZIP или RAR) отсканированные копии следующих документов.</blockquote>
 +
{| class="wikitable"
 +
|Для ООО, ПАО:
 +
|Для индивидуальных предпринимателей:
 +
|-
 +
|
 +
* устав организации (все страницы);
 +
* протокол (решение) о создании общества;
 +
* свидетельство ИНН;
 +
* свидетельство ОГРН;
 +
* протокол (решение) о назначении руководителя общества.
 +
* приказы о вступлении в должность руководителя и бухгалтера общества;
 +
* договор аренды или свидетельство на собственность помещения;
 +
* информационное письмо о постановке на учёт в Росстате;
 +
* паспорт руководителя;
 +
* договоры с двумя-тремя крупными операторами (первую и последнюю страницы);
 +
* выписка из ЕГРЮЛ, действующая на момент заключения договора (все страницы),
 +
|
 +
* свидетельство ИНН;
 +
* свидетельство ОГРНИП;
 +
* договор аренды или свидетельство на собственность помещения;
 +
* информационное письмо о постановке на учёт в Росстате;
 +
* паспорт индивидуального предпринимателя;
 +
* страховое свидетельство СНИЛС индивидуального предпринимателя;
 +
* договоры с двумя-тремя крупными операторами (первую и последнюю страницы);
 +
* выписка из ЕГРИП, действующая на момент заключения договора (все страницы)
 +
|}
  
−
[[File:ut-4.png|center|frame]]
+
Заключив договор, вы получите доступ в личный кабинет на сайте my.paygateway.ru, номер лицевого счёта, ключ безопасности и адрес платёжного шлюза, необходимые для настройки платёжной системы.   
  
−
Обратите внимание на колонку Uniteller Point ID – данное значение также копируем из браузера и вставляем в текстовое поле в настройках вашего платежного провайдера в личном кабинете Слетать.Ру на странице:  
+
== Настройки Аппекс ==
−
https://sletat.ru/workspace/billingsettings.aspx
+
В этом разделе описаны параметры, которые нужно настроить в Личном кабинете Аппекс.[[Файл:Appex.png|centre|frame|''Рис. 1. Личный кабинет в системе Аппекс.'']]
  
−
[[File:ut-5.png|center|frame]]
+
Войдите в ваш Личный кабинет в системе Ап-пекс. Откройте раздел «Настройки профиля». Откройте вкладку «Настройки интеграции».
 +
# Скопируйте номер лицевого счёта.
 +
# Скопируйте значение ключа из поля «Ключ 1».
 +
# Введите значение второго ключа безопасности в поле «Ключ 2». <!-- Ключ 1 и Ключ 2 — это подписи сообщений о платёжных операциях. Ключ 1 автоматически генерирует система Аппекс. Ключ 2 придумываете вы. -->
 +
# В выпадающем списке «Метод запроса при возврате» выберите опцию «GET».
 +
# Отметьте галочкой опцию «Хэширование подписи HMAC<!-- HMAC — это алгоритм шифрования данных. По умолчанию система Аппекс использует алгоритм MD5. Так как HMAC по надёжности превосходит MD5, мы настоятельно рекомендуем использовать его. -->» (рекомендовано).
  
−
== URL-адрес оповещения магазина ==
+
== Настройки Слетать.ру ==
 +
В этом разделе описаны параметры, которые нужно настроить в Личном кабинете Слетать.ру.
  
−
Следующим шагом является настройка адреса для оповещения магазина о статусе проведенной операции.  
+
Войдите в Личный кабинет в системе Слетать.ру. В разделе «Список заказов» Основного меню вы-берите опцию «Настройки».
−
С какой целью требуется настройка этого адреса?
+
−
Представьте, покупатель совершил платеж, компания Uniteller показала ему статус его операции, но вы, как менеджер турагенства, этот статус (платеж совершен, платеж не совершен вследствии какой-либо причины) не получаете, так как компания Uniteller не знает, кого оповестить. Адрес оповещения как раз и решает эту задачу, а именно, принимает статус проведенной денежной операции и оповещает менеджеров турагенства об успешности/неуспешности платежной операции в режиме реального времени.
+
−
Без указания данного адреса оповещения вы все равно получите реальный статус проведенной операции, НО, только по истечении 25 минут после того, как покупатель уйдет на платежную страницу Uniteller для осуществления платежа.
+
−
Для настройки этого адреса перейдите к настройкам точки продаж:
+
  
−
[[File:ut-6.png|center|frame]]
+
[[Файл:Appex sletat lk.png|centre|thumb|600x600px|''Рис. 2. Опция «Настройки».'']]
  
−
На представленной ниже странице обратите внимание на поле «URL адрес уведомления магазина».
+
На вкладке «Платёжный провайдер» в выпадающем списке «Выберите платёжный провайдер» выберите опцию «Аппекс».
  
−
[[File:ut-7.png|center|frame]]
+
[[Файл:Appex sletat lk2.png|centre|thumb|600x600px|''Рис. 3. Выпадающий список «Выберите платёжный провайдер».'']]
  
−
В данное поле вы должны вставить определенным образом сформированный адрес, значение которого можно взять из настроек платежного провайдера в личном кабинете Слетать.Ру. Данное значение так и называется – «Адрес оповещения». Берем значение из данной настройки:
+
Заполните поля настроек, как показано на Рис. 4:
  
−
[[File:ut-8.png|center|frame]]
+
[[Файл:Appex sletat lk3.png|centre|thumb|600x600px|''Рис. 4. Настройки в системе Слетать.ру.'']]
 +
## В поле «Номер счёта» скопируйте номер вашего лицевого счёта в системе Аппекс.
 +
## В поле «Секретный ключ 1» вставьте значение из поля «Ключ 1» в Личном кабинете Аппекс.
 +
## В поле «Секретный ключ 2» впишите придуманный вами второй ключ безопасности, введённый ранее в поле «Ключ 2» в Личном кабинете Аппекс.
 +
## В поле «Хэширование подписи» введите «SHA256», если вы отметили галочкой опцию «Хэширование подписи HMAC<!-- HMAC — это алгоритм шифрования данных. По умолчанию система Аппекс использует алгоритм MD5. Так как HMAC по надёжности превосходит MD5, мы настоятельно рекомендуем использовать его. -->» в Личном кабинете Аппекс, или «MD5», если вы не отмечали этой опции.
  
−
Копируем его и вставляем в поле «URL-адрес для уведомления магазина» в личном кабинете Uniteller.
+
== Настройки адресов ==
 +
В этом разделе описаны параметры адресов, которые нужно настроить, чтобы связать ваши аккаунты в системах Аппекс и Слетать.ру.
  
−
==Платежная страница Uniteller==
+
В Личном кабинете Слетать.ру:
−
В принципе, на данном этапе в личном кабинете Uniteller все необходимое для настройки интеграции для осуществления онлайн-продажи туров уже готово.  
+
# В поле «Адрес Appex API» введите адрес платёжного шлюза Аппекс. Этот адрес вы получите по электронной почте от менеджера Аппекс после заключения договора.
−
Но вы можете также перейти к настройкам самой платежной страницы Uniteller. Для этого в настройках вашей точки продаж переходим по ссылке «Тип шаблона» - Редактировать.
+
# Скопируйте значение поля «Адрес оповещения».
 +
# Скопируйте значение поля «Адрес под-тверждения».
 +
[[Файл:Appex sletat lk4.png|centre|thumb|600x600px|''Рис. 5. Настройки адресов в Личном кабинете Слетать.ру.'']]
 +
В Личном кабинете Аппекс (см. Рис. 6):
 +
# В поле «URL для обращения за подтверждением платежа» введите адрес, скопированный из поля «Адрес подтверждения» в Личном кабинете Слетать.ру.
 +
# В поле «URL для уведомления о статусе платежа» введите адрес, скопированный из поля «Адрес оповещения» в Личном кабинете Слетать.ру.
 +
# В поле «URL для возврата после совершения платежа» введите адрес, приведённый ниже.
 +
http://globaltps.ru/appex/completeholdinghandler.ashx 
  
−
[[File:ut-9.png|center|frame]]
+
[[Файл:Appex sletat lk5.png|centre|thumb|600x600px|''Рис. 6. Настройки адресов в Личном кабинете Аппекс.'']]
−
 
+
__ОБЯЗАТЕЛЬНОЕ_ОГЛАВЛЕНИЕ__
−
Здесь вам будет доступна масса настроек, из числа которых вы можете загрузить логотип вашей компании, поменять названии компании и пр. Просим вас также обратить внимание на следующие настройки:
+
[[Категория:Подключение платежных провайдеров]]
−
Комментарий к заказу – это строка, которая будет показана покупателю на платежной странице вместе с номером заказа. Вы можете поменять значение этой настройки на что-либо другое, например, «Название тура», «Тур» и прочее. По умолчанию будет использовано значение «Комментарий к оплате»:
+
−
 
+
−
[[File:ut-10.png|center|frame]]
+
−
 
+
−
После того, как поменяли значение данной настройки, например, на значение «Описание счета», платежная страница будет выглядеть так:
+
−
 
+
−
[[File:ut-11.png|center|frame]]
+
−
 
+
−
Обратите внимание также на то, что сейчас на платежную страницу Uniteller передается информация об Email и номере телефона заказчика тура. Эта информация сейчас доступна в разделе «Операции по карте», когда мы переходим к деталям операции на странице «Подробная информация об операции по карте».  
+
−
Например, такая информация может выглядеть так:
+
−
 
+
−
[[File:ut-12.png|center|frame]]
+
−
 
+
−
Если вы хотите, чтобы заказчик тура имел возможность изменить Email или номер телефона на платежной странице в момент совершения платежа, вам необходимо поправить следующие настройки:
+
−
 
+
−
[[File:ut-13.png|center|frame]]
+
−
 
+
−
Платежная страница с показанными выше настройками может выглядеть так:
+
−
 
+
−
[[File:ut-14.png|center|frame]]
+
−
 
+
−
По умолчанию данные значения скрываются, если они передаются на платежную страницу.
+
−
 
+
−
 
+
−
== Остальные настройки платежного провайдера==
+
−
Теперь, для окончательной настройки платежного провайдера, вам необходимо изменить адреса для обращения к операциям Uniteller, а именно, операциям подтверждения платежа, отмены авторизации, возврата средства и получения текущей информации о заказе.
+
−
 
+
−
[[File:ut-15.png|center|frame]]
+
−
 
+
−
Под каждым таким адресом указано, каким может быть значение для аккаунта в тестовом режиме. Если у вас «боевой» аккаунт, просто скопируйте значение из подсказки и уберите строку «test».
+

Текущая версия на 17:17, 16 февраля 2017

Заключение договора

В этом разделе описан процесс заключения договора с платёжным провайдером Аппекс.

Для заключения договора вышлите на электронные адреса to@appex.ru и od@appex.ru следующие данные:

  • ФИО, телефон и e-mail контактного лица;
  • телефон и e-mail, которые можно сообщать плательщикам в уведомлении;
  • e-mail для отправки реестров по платежам;
  • логотип агентства в формате PNG (желательно), GIF или JPG, размером не более 50Кб (рекомендованная высота: 56 px);
  • ожидаемый месячный оборот по платежам;
  • реквизиты компании на фирменном бланке.
К письму на od@appex.ru прикрепите одним архивом (формат ZIP или RAR) отсканированные копии следующих документов.
Для ООО, ПАО: Для индивидуальных предпринимателей:
  • устав организации (все страницы);
  • протокол (решение) о создании общества;
  • свидетельство ИНН;
  • свидетельство ОГРН;
  • протокол (решение) о назначении руководителя общества.
  • приказы о вступлении в должность руководителя и бухгалтера общества;
  • договор аренды или свидетельство на собственность помещения;
  • информационное письмо о постановке на учёт в Росстате;
  • паспорт руководителя;
  • договоры с двумя-тремя крупными операторами (первую и последнюю страницы);
  • выписка из ЕГРЮЛ, действующая на момент заключения договора (все страницы),
  • свидетельство ИНН;
  • свидетельство ОГРНИП;
  • договор аренды или свидетельство на собственность помещения;
  • информационное письмо о постановке на учёт в Росстате;
  • паспорт индивидуального предпринимателя;
  • страховое свидетельство СНИЛС индивидуального предпринимателя;
  • договоры с двумя-тремя крупными операторами (первую и последнюю страницы);
  • выписка из ЕГРИП, действующая на момент заключения договора (все страницы)

Заключив договор, вы получите доступ в личный кабинет на сайте my.paygateway.ru, номер лицевого счёта, ключ безопасности и адрес платёжного шлюза, необходимые для настройки платёжной системы.

Настройки Аппекс

В этом разделе описаны параметры, которые нужно настроить в Личном кабинете Аппекс.
Рис. 1. Личный кабинет в системе Аппекс.

Войдите в ваш Личный кабинет в системе Ап-пекс. Откройте раздел «Настройки профиля». Откройте вкладку «Настройки интеграции».

  1. Скопируйте номер лицевого счёта.
  2. Скопируйте значение ключа из поля «Ключ 1».
  3. Введите значение второго ключа безопасности в поле «Ключ 2».
  4. В выпадающем списке «Метод запроса при возврате» выберите опцию «GET».
  5. Отметьте галочкой опцию «Хэширование подписи HMAC» (рекомендовано).

Настройки Слетать.ру

В этом разделе описаны параметры, которые нужно настроить в Личном кабинете Слетать.ру.

Войдите в Личный кабинет в системе Слетать.ру. В разделе «Список заказов» Основного меню вы-берите опцию «Настройки».

Рис. 2. Опция «Настройки».

На вкладке «Платёжный провайдер» в выпадающем списке «Выберите платёжный провайдер» выберите опцию «Аппекс».

Рис. 3. Выпадающий список «Выберите платёжный провайдер».

Заполните поля настроек, как показано на Рис. 4:

Рис. 4. Настройки в системе Слетать.ру.
    1. В поле «Номер счёта» скопируйте номер вашего лицевого счёта в системе Аппекс.
    2. В поле «Секретный ключ 1» вставьте значение из поля «Ключ 1» в Личном кабинете Аппекс.
    3. В поле «Секретный ключ 2» впишите придуманный вами второй ключ безопасности, введённый ранее в поле «Ключ 2» в Личном кабинете Аппекс.
    4. В поле «Хэширование подписи» введите «SHA256», если вы отметили галочкой опцию «Хэширование подписи HMAC» в Личном кабинете Аппекс, или «MD5», если вы не отмечали этой опции.

Настройки адресов

В этом разделе описаны параметры адресов, которые нужно настроить, чтобы связать ваши аккаунты в системах Аппекс и Слетать.ру.

В Личном кабинете Слетать.ру:

  1. В поле «Адрес Appex API» введите адрес платёжного шлюза Аппекс. Этот адрес вы получите по электронной почте от менеджера Аппекс после заключения договора.
  2. Скопируйте значение поля «Адрес оповещения».
  3. Скопируйте значение поля «Адрес под-тверждения».
Рис. 5. Настройки адресов в Личном кабинете Слетать.ру.

В Личном кабинете Аппекс (см. Рис. 6):

  1. В поле «URL для обращения за подтверждением платежа» введите адрес, скопированный из поля «Адрес подтверждения» в Личном кабинете Слетать.ру.
  2. В поле «URL для уведомления о статусе платежа» введите адрес, скопированный из поля «Адрес оповещения» в Личном кабинете Слетать.ру.
  3. В поле «URL для возврата после совершения платежа» введите адрес, приведённый ниже.
http://globaltps.ru/appex/completeholdinghandler.ashx 
Рис. 6. Настройки адресов в Личном кабинете Аппекс.
Источник — «https://wiki.sletat.ru/index.php?title=«Аппекс»_—_интеграция&oldid=1771»