Подключение туроператоров — различия между версиями
Vm (обсуждение | вклад) (→Реализуемые методы) |
Vm (обсуждение | вклад) (→Настройка платежной страницы) |
||
| Строка 45: | Строка 45: | ||
== Реализуемые методы == | == Реализуемые методы == | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
== Настройка платежной страницы == | == Настройка платежной страницы == | ||
=== Структура шаблона === | === Структура шаблона === | ||
Версия 12:28, 20 января 2016
Содержание
Описание сервиса
Для интеграции со Слетать.ру нужно создать веб-сервис, который будет выполнять следующие задачи:
- Выгружать справочники: города вылета, страны, курорты, отели и т.д.
- Осуществлять параметризованный поиск цен
- Актуализировать выбранный тур по его идентификатору
Для упрощения, сервис можно представить веб-страничкой, которая принимает GET или POST параметры и выдаёт ответ в формате XML (не SOAP).
Для всех методов сервиса должен использоваться один адрес. Например, если вы реализуете сервис по адресу: http://mysite.com/services/sletatru.xml , то этот адрес должен быть общим для всех запросов.
Примеры:
- http://mysite.com/services/sletatru.xml?action=GetCountries – запрос списка стран
- http://mysite.com/services/sletatru.xml?action=GetDepartCities – запрос списка городов вылета
Выдача результатов должна быть в формате XML, для каждого метода описан формат.
Для корневого элемента в результате должен быть указан атрибут version с указанием версии протокола. Атрибут нужен для определения версии провайдера туров сервисом Слетать.ру.
Пример:
<getCountriesResult version="1.0"> ... </getCountriesResult>
Данный документ описывает версию прокола 1.0.
Все методы должны возвращать XML в кодировке UTF-8.
Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. Для серверной стороны обработка всех полученных параметров запроса обязательна.
Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.
Пул IP адресов, с которых сервис Слетать.ру будет обращаться к реализуемому провайдеру туров уточняется отдельно. Для его уточнения необходимо написать на support@sletat.ru
Дополнительные требования к сервису
Максимально допустимое время при работе с любым методом сервиса не должно превышать 30 секунд. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до 5 секунд. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.
Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.
Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
- количества и популярности направлений туроператора
- количества городов вылета
- количества поисковых запросов в сервисе Слетать.ру
Реализуемые методы
Настройка платежной страницы
Структура шаблона
После скачивания архива payment_page.zip (на текущий момент шаблон можно скачать по адресу http://static.sletat.ru/Files/templates/payment_page.zip ) его необходимо распаковать. После этого вам будут доступны для редактирования следующие подкаталоги и файлы:
Внимание: Структура подкаталогов должна быть строго определенная и не может быть изменена.
Изменение шаблона
1. Подкаталог 9290000000 необходимо переименовать, указав в качестве имени ваш MERCHANT ID, выданный банком. Таким образом, если ваш MERCHANT ID - 9290101010, то после переименования структура подкаталогов должна выглядеть так:
2. Открыть файл cardinfo.html в notepad.exe (или в любом другом текстовом редакторе). После открытия файла вы должны увидеть следующее:
Обратите внимание, что в тексте присутствует прежнее название переименованного каталога: 9290000000.
Необходимо все такие строки переименовать в наше новое значение – полученный от банка MERCHANT ID. В notepad.exe это можно выполнить, вызвав команду меню Правка – Заменить:
Укажите в качестве нового значения ваш (присвоенный банком «Русский Стандарт») MERCHANT ID. В нашем примере это будет выглядеть так:
После выполнения команды «Заменить все» наш текст будет выглядеть примерно так:
3. После выполнения предыдущих операций, если вы откроете файл cardinfo.html в браузере (Internet Explorer, Firefox, Opera или любой другой), то ваш шаблон платежной страницы будет выглядеть следующим образом:
4. Все, что осталось нам сделать – это применить по центру изображение логотипа вашей компании. Для этого необходимо заменить файл your_logo_here.jpg (находится по пути \template\<ваш MERCHANT ID>\img) на файл с логотипом вашей компании:
Также вы можете указать любой другой файл изображения, поместив его в подкаталог \img и изменив в тексте файла cardinfo.html ссылку на этой изображение, например, так:
После сохранения шаблон с указанным изображением будет выглядеть, в случае нашего примера, вот так:
5. После всех вышеперечисленных действий создаем архивный файл, содержащий наши файлы и подкаталоги, и отправляем этот архивный файл в банк «Русский Стандарт» с просьбой применить данный шаблон в качестве шаблона платежной страницы для вашего MERCHANT.
Настройка платежной страницы
Структура шаблона
После скачивания архива payment_page.zip (на текущий момент шаблон можно скачать по адресу http://static.sletat.ru/Files/templates/payment_page.zip ) его необходимо распаковать. После этого вам будут доступны для редактирования следующие подкаталоги и файлы:
Внимание: Структура подкаталогов должна быть строго определенная и не может быть изменена.
Изменение шаблона
1. Подкаталог 9290000000 необходимо переименовать, указав в качестве имени ваш MERCHANT ID, выданный банком. Таким образом, если ваш MERCHANT ID - 9290101010, то после переименования структура подкаталогов должна выглядеть так:
2. Открыть файл cardinfo.html в notepad.exe (или в любом другом текстовом редакторе). После открытия файла вы должны увидеть следующее:
Обратите внимание, что в тексте присутствует прежнее название переименованного каталога: 9290000000.
Необходимо все такие строки переименовать в наше новое значение – полученный от банка MERCHANT ID. В notepad.exe это можно выполнить, вызвав команду меню Правка – Заменить:
Укажите в качестве нового значения ваш (присвоенный банком «Русский Стандарт») MERCHANT ID. В нашем примере это будет выглядеть так:
После выполнения команды «Заменить все» наш текст будет выглядеть примерно так:
3. После выполнения предыдущих операций, если вы откроете файл cardinfo.html в браузере (Internet Explorer, Firefox, Opera или любой другой), то ваш шаблон платежной страницы будет выглядеть следующим образом:
4. Все, что осталось нам сделать – это применить по центру изображение логотипа вашей компании. Для этого необходимо заменить файл your_logo_here.jpg (находится по пути \template\<ваш MERCHANT ID>\img) на файл с логотипом вашей компании:
Также вы можете указать любой другой файл изображения, поместив его в подкаталог \img и изменив в тексте файла cardinfo.html ссылку на этой изображение, например, так:
После сохранения шаблон с указанным изображением будет выглядеть, в случае нашего примера, вот так:
5. После всех вышеперечисленных действий создаем архивный файл, содержащий наши файлы и подкаталоги, и отправляем этот архивный файл в банк «Русский Стандарт» с просьбой применить данный шаблон в качестве шаблона платежной страницы для вашего MERCHANT.
