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

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

Анкета на подключение

В процессе заключения договора на предоставление услуг интернет-эквайринга от процессингового центра Payture вам необходимо указать следующее (все нижеперечисленное можно также увидеть в порядке интеграции http://payture.ru/help/integration/integration-procedure/ ):

Адрес возврата пользователя

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

http://globaltps.ru/payture/completeholdinghandler.ashx?result={success}&orderid={orderid}

Адрес для возврата должен быть указан именно этот. Как в случае успешной оплаты, так и в случае неуспешной покупатель будет возвращен к той странице, на которой первоначально был совершен online-заказ, с предоставлением результата проведеной платежной операции - успешна или неуспешна (в случае неуспешности оплаты будет показано сообщение и причина ошибки).

Указанный адрес - это обработчик от компании Слетать.Ру, при получении ответа со стороны платежной страницы процессиногового центра Payture данный обработчик вернет пользователя к той странице, на которой он производил первоначальный поиск и на которой ему была показана карточка счета (лист бронирования) для последущего перехода к платежной странице процессинга.

Нотификация ( http://payture.ru/api/notifications/ )

Нотификации – это асинхронные ответы от Payture о результатах выполнения запросов. Для успешной интеграции необходимо выбрать минимум один метод нотификации – HTTP POST запрос. В качестве адреса нотификации указываем этот:

http://globaltps.ru/payture/{идентификатор вашего турагенства}/callbackhandler.ashx Этот адрес вы можете увидеть в настройках провайдера в личном кабинете SLETAT.RU https://sletat.ru/workspace/billingsettings.aspx :

С какой целью требуется настройка этого адреса? Представьте, покупатель совершил платеж, процессинговый центр Payture показал ему статус платежной операции, но вы, как менеджер турагентства, этот статус (платеж совершен, платеж не совершен вследствие какой-либо причины) не получаете, так как Payture не знает, кого оповестить. Адрес оповещения как раз и решает эту задачу, а именно, принимает статус проведенной денежной операции и оповещает менеджеров турагентства об успешности/неуспешности платежной операции в режиме реального времени. Само по себе оповещение (SMS, Email) осуществляется в таком случае компанией SLETAT.RU, получив запрос на указанный адрес от процессинга Payture. Важно: Без указания данного адреса оповещения вы все равно получите реальный статус проведенной операции, НО, только по истечении 25 минут после того момента, как покупатель перешел на платежную страницу Payture для осуществления платежа.

Схема проведения платежей

Двухстадийная схема проведения платежей.

В этом случае списание происходит через выполнение двух операций с картой – блокирование средств на карте (авторизация или блокировка средств) и завершение авторизации (списание). При этом завершение может инициализироваться Продавцом в течение нескольких дней после успешной блокировки. Срок, в течение которого необходимо выполнить завершение, может находиться в пределах 10¬‐30 рабочих дней и зависит от правил банка эмитента. Если завершение не будет инициализировано в требуемый срок (более 10 рабочих дней), то эмитент самостоятельно осуществит автоматическую разблокировку средств на карте покупателя. Завершение после этого уже невозможно.

Необходимый набор команд

• Блокировка средств (в рамках двухстадийного списания)
• Завершение списания (вторая стадия после блокировки)
• Отмена блокировки средств
• Возврат средств
• Запрос статуса платежа

Порядок (место) ввода данных банковской карты

Ввод данных банковской карты должен осуществляться на стороне 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

Например, в тестовом режиме настройки могут выглядеть так:

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

Обратите внимание, что для полной настройки процесса онлайн-продаж вам также необходимо настроить 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 разработан и протестирован базовый шаблон платежной страницы, который вы можете использовать в качестве начального и для быстрого старта. Выглядит он следующим образом:

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