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

Материал из wiki.Sletat.ru
Перейти к: навигация, поиск
(→‎В этом разделе описаны параметры, которые нужно настроить в Личном кабинете Слетать.ру.)
 
(не показано 13 промежуточных версий этого же участника)
Строка 1: Строка 1:
−
[[Category:Подключение платежных провайдеров]]
 
−
== Анкета на подключение ==
 
−
В процессе заключения договора на предоставление услуг интернет-эквайринга от процессингового центра Payture вам необходимо указать следующее (все нижеперечисленное можно также увидеть в порядке интеграции http://payture.ru/help/integration/integration-procedure/ ):
 
  
−
'''Адрес возврата пользователя'''
+
== Заключение договора ==
 +
В этом разделе описан процесс заключения договора с платёжным провайдером Аппекс.
  
−
В качестве адреса возврата пользователя необходимо указать следующий адрес:
+
Для заключения договора вышлите на электронные адреса to@appex.ru и od@appex.ru следующие данные:
−
http://globaltps.ru/payture/completeholdinghandler.ashx?result={success}&orderid={orderid}
+
* ФИО, телефон и e-mail контактного лица;
−
Адрес для возврата должен быть указан именно этот. Как в случае успешной оплаты, так и в случае неуспешной покупатель будет возвращен к той странице, на которой первоначально был совершен online-заказ, с предоставлением результата проведеной платежной операции - успешна или неуспешна (в случае неуспешности оплаты будет показано сообщение и причина ошибки).
+
  
−
Указанный адрес - это обработчик от компании Слетать.Ру, при получении ответа со стороны платежной страницы процессиногового центра Payture данный обработчик вернет пользователя к той  странице, на которой он производил первоначальный поиск и на которой ему была показана карточка счета (лист бронирования) для последущего перехода к платежной странице процессинга.
+
* телефон и e-mail, которые можно сообщать плательщикам в уведомлении;
  
−
'''Нотификация ( http://payture.ru/api/notifications/ )'''
+
* e-mail для отправки реестров по платежам;
  
−
Нотификации – это асинхронные ответы от Payture о результатах выполнения запросов.
+
* логотип агентства в формате PNG (желательно), GIF или JPG, размером не более 50Кб (рекомендованная высота: 56 px);
−
Для успешной интеграции необходимо выбрать минимум один метод нотификации – HTTP POST запрос. В качестве адреса нотификации указываем этот:
+
  
−
http://globaltps.ru/payture/{идентификатор вашего турагенства}/callbackhandler.ashx
+
* ожидаемый месячный оборот по платежам;
−
Этот адрес вы можете увидеть в настройках провайдера в личном кабинете SLETAT.RU https://sletat.ru/workspace/billingsettings.aspx :
+
  
−
[[File:pt-1.png|center|frame]]
+
* реквизиты компании на фирменном бланке.
 +
<blockquote>К письму на od@appex.ru прикрепите одним архивом (формат ZIP или RAR) отсканированные копии следующих документов.</blockquote>
 +
{| class="wikitable"
 +
|Для ООО, ПАО:
 +
|Для индивидуальных предпринимателей:
 +
|-
 +
|
 +
* устав организации (все страницы);
 +
* протокол (решение) о создании общества;
 +
* свидетельство ИНН;
 +
* свидетельство ОГРН;
 +
* протокол (решение) о назначении руководителя общества.
 +
* приказы о вступлении в должность руководителя и бухгалтера общества;
 +
* договор аренды или свидетельство на собственность помещения;
 +
* информационное письмо о постановке на учёт в Росстате;
 +
* паспорт руководителя;
 +
* договоры с двумя-тремя крупными операторами (первую и последнюю страницы);
 +
* выписка из ЕГРЮЛ, действующая на момент заключения договора (все страницы),
 +
|
 +
* свидетельство ИНН;
 +
* свидетельство ОГРНИП;
 +
* договор аренды или свидетельство на собственность помещения;
 +
* информационное письмо о постановке на учёт в Росстате;
 +
* паспорт индивидуального предпринимателя;
 +
* страховое свидетельство СНИЛС индивидуального предпринимателя;
 +
* договоры с двумя-тремя крупными операторами (первую и последнюю страницы);
 +
* выписка из ЕГРИП, действующая на момент заключения договора (все страницы)
 +
|}
  
−
С какой целью требуется настройка этого адреса?
+
Заключив договор, вы получите доступ в личный кабинет на сайте my.paygateway.ru, номер лицевого счёта, ключ безопасности и адрес платёжного шлюза, необходимые для настройки платёжной системы.  
−
Представьте, покупатель совершил платеж, процессинговый центр Payture показал ему статус платежной операции, но вы, как менеджер турагентства, этот статус (платеж совершен, платеж не совершен вследствие какой-либо причины) не получаете, так как Payture не знает, кого оповестить. Адрес оповещения как раз и решает эту задачу, а именно, принимает статус проведенной денежной операции и оповещает менеджеров турагентства об успешности/неуспешности платежной операции в режиме реального времени. Само по себе оповещение  (SMS, Email) осуществляется в таком случае компанией SLETAT.RU, получив запрос на указанный адрес от процессинга Payture.
+
−
Важно: Без указания данного адреса оповещения вы все равно получите реальный статус проведенной операции, НО, только по истечении 25 минут после того момента, как покупатель перешел на платежную страницу Payture для осуществления платежа.
+
  
−
'''Схема проведения платежей'''
+
== Настройки Аппекс ==
 +
В этом разделе описаны параметры, которые нужно настроить в Личном кабинете Аппекс.[[Файл:Appex.png|centre|frame|''Рис. 1. Личный кабинет в системе Аппекс.'']]
  
−
Двухстадийная схема проведения платежей.
+
Войдите в ваш Личный кабинет в системе Ап-пекс. Откройте раздел «Настройки профиля». Откройте вкладку «Настройки интеграции».
 +
# Скопируйте номер лицевого счёта.
 +
# Скопируйте значение ключа из поля «Ключ 1».
 +
# Введите значение второго ключа безопасности в поле «Ключ 2». <!-- Ключ 1 и Ключ 2 — это подписи сообщений о платёжных операциях. Ключ 1 автоматически генерирует система Аппекс. Ключ 2 придумываете вы. -->
 +
# В выпадающем списке «Метод запроса при возврате» выберите опцию «GET».
 +
# Отметьте галочкой опцию «Хэширование подписи HMAC<!-- HMAC — это алгоритм шифрования данных. По умолчанию система Аппекс использует алгоритм MD5. Так как HMAC по надёжности превосходит MD5, мы настоятельно рекомендуем использовать его. -->» (рекомендовано).
  
−
В этом случае списание происходит через выполнение двух операций с картой – блокирование средств на карте (авторизация или блокировка средств) и завершение авторизации (списание). При этом завершение может инициализироваться Продавцом в течение нескольких дней после успешной блокировки. Срок, в течение которого необходимо выполнить завершение, может находиться в пределах 10¬‐30 рабочих дней и зависит от правил банка эмитента. Если завершение не будет инициализировано в требуемый срок (более 10 рабочих дней), то эмитент самостоятельно осуществит автоматическую разблокировку средств на карте покупателя. Завершение после этого уже невозможно.
+
== Настройки Слетать.ру ==
 +
В этом разделе описаны параметры, которые нужно настроить в Личном кабинете Слетать.ру.
  
−
'''Необходимый набор команд'''
+
Войдите в Личный кабинет в системе Слетать.ру. В разделе «Список заказов» Основного меню вы-берите опцию «Настройки».
  
−
* Блокировка средств (в рамках двухстадийного списания)
+
[[Файл:Appex sletat lk.png|centre|thumb|600x600px|''Рис. 2. Опция «Настройки».'']]
−
* Завершение списания (вторая стадия после блокировки)
+
−
* Отмена блокировки средств
+
−
* Возврат средств
+
−
* Запрос статуса платежа
+
  
−
'''Порядок (место) ввода данных банковской карты'''
+
На вкладке «Платёжный провайдер» в выпадающем списке «Выберите платёжный провайдер» выберите опцию «Аппекс».
  
−
Ввод данных банковской карты должен осуществляться на стороне Payture.
+
[[Файл:Appex sletat lk2.png|centre|thumb|600x600px|''Рис. 3. Выпадающий список «Выберите платёжный провайдер».'']]
−
В данном случае пользователь находится на сайте продавца только до момента ввода данных своей платежной карты, для чего он должен быть перенаправлен на страницу Payture. После ввода данных и совершения операции пользователь будет возвращен обратно на сайт Продавца с результатами операции.
+
  
 +
Заполните поля настроек, как показано на Рис. 4:
  
−
'''Вариант API'''
+
[[Файл:Appex sletat lk3.png|centre|thumb|600x600px|''Рис. 4. Настройки в системе Слетать.ру.'']]
 +
## В поле «Номер счёта» скопируйте номер вашего лицевого счёта в системе Аппекс.
 +
## В поле «Секретный ключ 1» вставьте значение из поля «Ключ 1» в Личном кабинете Аппекс.
 +
## В поле «Секретный ключ 2» впишите придуманный вами второй ключ безопасности, введённый ранее в поле «Ключ 2» в Личном кабинете Аппекс.
 +
## В поле «Хэширование подписи» введите «SHA256», если вы отметили галочкой опцию «Хэширование подписи HMAC<!-- HMAC — это алгоритм шифрования данных. По умолчанию система Аппекс использует алгоритм MD5. Так как HMAC по надёжности превосходит MD5, мы настоятельно рекомендуем использовать его. -->» в Личном кабинете Аппекс, или «MD5», если вы не отмечали этой опции.
  
−
Выбираем интерфейс Payture InPay  - http://payture.ru/api/inpay/ ,
+
== Настройки адресов ==
−
который реализует основные возможности сервиса Payture аналогично интерфейсу Payture API, но с вводом данных банковских карт на странице шлюза Payture.
+
В этом разделе описаны параметры адресов, которые нужно настроить, чтобы связать ваши аккаунты в системах Аппекс и Слетать.ру.
  
−
'''Ограничение платежной сессии'''
+
В Личном кабинете Слетать.ру:
 +
# В поле «Адрес Appex API» введите адрес платёжного шлюза Аппекс. Этот адрес вы получите по электронной почте от менеджера Аппекс после заключения договора.
 +
# Скопируйте значение поля «Адрес оповещения».
 +
# Скопируйте значение поля «Адрес под-тверждения».
 +
[[Файл:Appex sletat lk4.png|centre|thumb|600x600px|''Рис. 5. Настройки адресов в Личном кабинете Слетать.ру.'']]
 +
В Личном кабинете Аппекс (см. Рис. 6):
 +
# В поле «URL для обращения за подтверждением платежа» введите адрес, скопированный из поля «Адрес подтверждения» в Личном кабинете Слетать.ру.
 +
# В поле «URL для уведомления о статусе платежа» введите адрес, скопированный из поля «Адрес оповещения» в Личном кабинете Слетать.ру.
 +
# В поле «URL для возврата после совершения платежа» введите адрес, приведённый ниже.
 +
http://globaltps.ru/appex/completeholdinghandler.ashx 
  
−
Очень важно указать, что требуется установить максимальное время жизни платежной сессии – 40 минут
+
[[Файл:Appex sletat lk5.png|centre|thumb|600x600px|''Рис. 6. Настройки адресов в Личном кабинете Аппекс.'']]
−
 
+
__ОБЯЗАТЕЛЬНОЕ_ОГЛАВЛЕНИЕ__
−
== Настройки провайдера ==
+
[[Категория:Подключение платежных провайдеров]]
−
После заключение договора с процессинговым центром Payture вы получите:
+
−
* параметры коммерческого доступа (VWID, Key, Password – в виде смс на номер мобильного телефона представителя Продавца)
+
−
* имя хоста коммерческого сервиса (Host)
+
−
* параметры доступа к личному кабинету через web интерфейс (логин, пароль для входа, пароль для возвратов и отмен), пароли будут переданы в смс на номер мобильного телефона официального представителя Продавца.
+
−
 
+
−
 
+
−
Используя параметры доступа Key и Password, а также имя хоста коммерческого сервиса, вам необходимо будет заполнить следующие настройки в личном кабинете SLETAT.RU на странице:
+
−
https://sletat.ru/workspace/billingsettings.aspx:
+
−
 
+
−
Идентификатор Продавца - {Key}
+
−
Пароль Продавца - {Password}
+
−
Адрес, используемый для инициализации платежной сессии - https://{Host}/apim/Init
+
−
Адрес формы оплаты платёжного шлюза - https://{Host}/apim/Pay
+
−
Адрес, используемый для подтверждения платежа - https://{Host}/apim/Charge
+
−
Адрес, используемый для получения состояния платежа - https://{Host}/apim/PayStatus
+
−
Адрес, используемый для отмены авторизации платежа - https://{Host}/apim/Unblock
+
−
Адрес, используемый для возврата средств - https://{Host}/apim/Refund
+
−
 
+
−
Обратите внимание: Нужно использовать пароль Password для доступа к API !!!
+
−
Пароль для доступа к личному кабинету Payture является ваше конфиденциальной информацией.
+
−
 
+
−
Обратите внимание: В запросах наименования параметров чувствительны к регистру, нужно указывать именно в том виде, в котором они предоставлены центром Payture
+
−
 
+
−
Например, в тестовом режиме настройки могут выглядеть так:
+
−
 
+
−
[[File:pt-2.png|center|frame]]
+
−
 
+
−
== Настройки провайдера ==
+
−
Обратите внимание, что для полной настройки процесса онлайн-продаж вам также необходимо настроить SMS и Email оповещения в разделе
+
−
https://sletat.ru/workspace/billingsettings.aspx?tab=notifications
+
−
 
+
−
а также указать настройки своей почты в разделе «Настройки SMTP»:
+
−
https://sletat.ru/workspace/billingsettings.aspx?tab=smtp
+
−
 
+
−
Это необходимо для своевременного оповещения менеджеров вашей компании о новом online-заказе, а также о последующих оповещениях вашего клиента от имени вашей компании по email и SMS.
+
−
На этом минимальная настройка процесса онлайн-покупки туров заканчивается.
+
−
 
+
−
== Настройка платежной страницы ==
+
−
 
+
−
Вы можете разработать свой шаблон платежной страницы согласно правилам, которые опубликованы на сайте Payture.ru:
+
−
http://payture.ru/help/payment-page-templates/general-information/
+
−
Шаблоны, предлагаемые в качестве базовых, доступны по адресу:
+
−
http://payture.ru/help/payment-page-templates/payture-inpay-interface/
+
−
Для вашего удобства и скорейшего подключения в компании SLETAT.RU разработан и протестирован базовый шаблон платежной страницы, который вы можете использовать в качестве начального и для быстрого старта. Выглядит он следующим образом:
+
−
 
+
−
[[File:pt-3.png|center|frame]]
+
−
 
+
−
Вам потребуется заменить изображение с логотипом вашей компании вместо логотипа компании SLETAT.RU (Sletat\i\l.gif). Сделать это можно, отредактировав файл:
+
−
 
+
−
[MERCHANT]MerchantSletat-Pay-Default-Default.template (Выделенный фрагмент заменить на идентификатор продавца.)
+
−
 
+
−
Следующим шагом потребуется поменять имя данного файла, заменив «MerchantSletat» на идентификатор мерчанта, который вам будет присвоен при заключении договора с Payture.ru (значение «Идентификатор продавца» из настроек платежного провайдера), а также изменив название вложенного каталога Sletat и поправив относительные пути к нему в файле
+
−
 
+
−
[MERCHANT]MerchantSletat-Pay-Default-Default.template (Выделенный фрагмент заменить на идентификатор продавца.)
+
−
 
+
−
Загрузить предлагаемый шаблон можно по адресу:
+
−
 
+
−
http://static.sletat.ru/Files/templates/payture_payment_page.zip
+
−
 
+
−
Полученный результат нужно отправить в службу поддержки компании Payture - support@payture.com.
+

Текущая версия на 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»