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

Материал из wiki.Sletat.ru
Перейти к: навигация, поиск
(Анкета на подключение)
Строка 1: Строка 1:
 
[[Category:Подключение платежных провайдеров]]
 
[[Category:Подключение платежных провайдеров]]
== Анкета на подключение ==
+
== Заключение договора ==
В процессе заключения договора на предоставление услуг интернет-эквайринга от процессингового центра Payture вам необходимо указать следующее (все нижеперечисленное можно также увидеть в порядке интеграции http://payture.ru/help/integration/integration-procedure/ ):
+
  
'''Адрес возврата пользователя'''
+
=== В этом разделе описан процесс заключения договора с платёжным провайдером Аппекс. ===
 +
Для заключения договора вышлите на электронные адреса to@appex.ru и od@appex.ru следующие данные:
 +
* ФИО, телефон и e-mail контактного лица;
  
В качестве адреса возврата пользователя необходимо указать следующий адрес:
+
* телефон и e-mail, которые можно сообщать плательщикам в уведомлении;
http://globaltps.ru/payture/completeholdinghandler.ashx?result={success}&orderid={orderid}
+
Адрес для возврата должен быть указан именно этот. Как в случае успешной оплаты, так и в случае неуспешной покупатель будет возвращен к той странице, на которой первоначально был совершен online-заказ, с предоставлением результата проведеной платежной операции - успешна или неуспешна (в случае неуспешности оплаты будет показано сообщение и причина ошибки).
+
  
Указанный адрес - это обработчик от компании Слетать.Ру, при получении ответа со стороны платежной страницы процессиногового центра Payture данный обработчик вернет пользователя к той  странице, на которой он производил первоначальный поиск и на которой ему была показана карточка счета (лист бронирования) для последущего перехода к платежной странице процессинга.
+
* e-mail для отправки реестров по платежам;
  
'''Нотификация ( http://payture.ru/api/notifications/ )'''
+
* логотип агентства в формате PNG (желательно), GIF или JPG, размером не более 50Кб (рекомендованная высота: 56 px);
  
Нотификации – это асинхронные ответы от Payture о результатах выполнения запросов.
+
* ожидаемый месячный оборот по платежам;
Для успешной интеграции необходимо выбрать минимум один метод нотификации – HTTP POST запрос. В качестве адреса нотификации указываем этот:
+
  
http://globaltps.ru/payture/{идентификатор вашего турагенства}/callbackhandler.ashx
+
* реквизиты компании на фирменном бланке.
Этот адрес вы можете увидеть в настройках провайдера в личном кабинете SLETAT.RU https://sletat.ru/workspace/billingsettings.aspx :
+
<blockquote>К письму на od@appex.ru прикрепите одним архивом (формат ZIP или RAR) отсканированные копии следующих документов.</blockquote>
 +
{| class="wikitable"
 +
|Для ООО, ПАО:
 +
|Для индивидуальных предпринимателей:
 +
|-
 +
|
 +
* устав организации (все страницы);
 +
* протокол (решение) о создании общества;
 +
* свидетельство ИНН;
 +
* свидетельство ОГРН;
 +
* протокол (решение) о назначении руководителя общества.
 +
* приказы о вступлении в должность руководителя и бухгалтера общества;
 +
* договор аренды или свидетельство на собственность помещения;
 +
* информационное письмо о постановке на учёт в Росстате;
 +
* паспорт руководителя;
 +
* договоры с двумя-тремя крупными операторами (первую и последнюю страницы);
 +
* выписка из ЕГРЮЛ, действующая на момент заключения договора (все страницы),
 +
|
 +
* свидетельство ИНН;
 +
* свидетельство ОГРНИП;
 +
* договор аренды или свидетельство на собственность помещения;
 +
* информационное письмо о постановке на учёт в Росстате;
 +
* паспорт индивидуального предпринимателя;
 +
* страховое свидетельство СНИЛС индивидуального предпринимателя;
 +
* договоры с двумя-тремя крупными операторами (первую и последнюю страницы);
 +
* выписка из ЕГРИП, действующая на момент заключения договора (все страницы)
 +
|}
  
[[File:pt-1.png|center|frame]]
+
Заключив договор, вы получите доступ в личный кабинет на сайте 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|''Рис. 2. Опция «Настройки».'']]
'''Необходимый набор команд'''
+
 
+
* Блокировка средств (в рамках двухстадийного списания)
+
* Завершение списания (вторая стадия после блокировки)
+
* Отмена блокировки средств
+
* Возврат средств
+
* Запрос статуса платежа
+
 
+
'''Порядок (место) ввода данных банковской карты'''
+
 
+
Ввод данных банковской карты должен осуществляться на стороне Payture.
+
В данном случае пользователь находится на сайте продавца только до момента ввода данных своей платежной карты, для чего он должен быть перенаправлен на страницу Payture. После ввода данных и совершения операции пользователь будет возвращен обратно на сайт Продавца с результатами операции.
+
 
+
 
+
'''Вариант API'''
+
 
+
Выбираем интерфейс Payture InPay  - http://payture.ru/api/inpay/ ,
+
который реализует основные возможности сервиса Payture аналогично интерфейсу Payture API, но с вводом данных банковских карт на странице шлюза Payture.
+
 
+
'''Ограничение платежной сессии'''
+
 
+
Очень важно указать, что требуется установить максимальное время жизни платежной сессии – 40 минут
+
 
+
== Настройки провайдера ==
+
После заключение договора с процессинговым центром 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.
+
На этом минимальная настройка процесса онлайн-покупки туров заканчивается.
+
  
 
== Настройка платежной страницы ==
 
== Настройка платежной страницы ==

Версия 16:57, 29 ноября 2016

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

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

Для заключения договора вышлите на электронные адреса 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. Опция «Настройки».

Настройка платежной страницы

Вы можете разработать свой шаблон платежной страницы согласно правилам, которые опубликованы на сайте Payture.ru: http://payture.ru/help/payment-page-templates/general-information/ Шаблоны, предлагаемые в качестве базовых, доступны по адресу: http://payture.ru/help/payment-page-templates/payture-inpay-interface/ Для вашего удобства и скорейшего подключения в компании SLETAT.RU разработан и протестирован базовый шаблон платежной страницы, который вы можете использовать в качестве начального и для быстрого старта. Выглядит он следующим образом:

Pt-3.png

Вам потребуется заменить изображение с логотипом вашей компании вместо логотипа компании 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.