|
|
| (не показано 56 промежуточных версий 1 участника) |
| Строка 1: |
Строка 1: |
| − | [[Category:Подключение платежных провайдеров]] | + | [[Category:Подключение_туроператоров]] |
| − | == Описание сервиса == | + | == SletatRu Provider API == |
| − | | + | Актуальная версия документации доступна по ссылке: https://static.sletat.ru/Files/api/SletatRu_Provider_API.pdf |
| − | Для интеграции со Слетать.ру нужно создать веб-сервис, который будет выполнять следующие задачи:
| + | |
| − | * Выгружать справочники: города вылета, страны, курорты, отели и т.д.
| + | |
| − | * Осуществлять параметризованный поиск цен
| + | |
| − | * Актуализировать выбранный тур по его идентификатору
| + | |
| − | | + | |
| − | '''Для упрощения, сервис можно представить веб-страничкой, которая принимает 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 ) его необходимо распаковать. После этого вам будут доступны для редактирования следующие подкаталоги и файлы:
| + | |
| − | | + | |
| − | [[File:tieto2-1.png|center|frame]]
| + | |
| − | | + | |
| − | Внимание: Структура подкаталогов должна быть строго определенная и не может быть изменена.
| + | |
| − | | + | |
| − | === Изменение шаблона ===
| + | |
| − | 1. Подкаталог 9290000000 необходимо переименовать, указав в качестве имени ваш MERCHANT ID, выданный банком. Таким образом, если ваш MERCHANT ID - 9290101010, то после переименования структура подкаталогов должна выглядеть так:
| + | |
| − | | + | |
| − | [[File:tieto2-2.png|center|frame]]
| + | |
| − | | + | |
| − | 2. Открыть файл cardinfo.html в notepad.exe (или в любом другом текстовом редакторе). После открытия файла вы должны увидеть следующее:
| + | |
| − | | + | |
| − | [[File:tieto2-3.png|center|frame]]
| + | |
| − | | + | |
| − | Обратите внимание, что в тексте присутствует прежнее название переименованного каталога: 9290000000.
| + | |
| − | | + | |
| − | Необходимо все такие строки переименовать в наше новое значение – полученный от банка MERCHANT ID. В notepad.exe это можно выполнить, вызвав команду меню
| + | |
| − | Правка – Заменить:
| + | |
| − | | + | |
| − | [[File:tieto2-4.png|center|frame]]
| + | |
| − | | + | |
| − | Укажите в качестве нового значения ваш (присвоенный банком «Русский Стандарт») MERCHANT ID. В нашем примере это будет выглядеть так:
| + | |
| − | | + | |
| − | [[File:tieto2-5.png|center|frame]]
| + | |
| − | | + | |
| − | После выполнения команды «Заменить все» наш текст будет выглядеть примерно так:
| + | |
| − | | + | |
| − | [[File:tieto2-6.png|center|frame]]
| + | |
| − | | + | |
| − | 3. После выполнения предыдущих операций, если вы откроете файл cardinfo.html в браузере (Internet Explorer, Firefox, Opera или любой другой), то ваш шаблон платежной страницы будет выглядеть следующим образом:
| + | |
| − | | + | |
| − | [[File:tieto2-7.png|center|frame]]
| + | |
| − | | + | |
| − | 4. Все, что осталось нам сделать – это применить по центру изображение логотипа вашей компании.
| + | |
| − | Для этого необходимо заменить файл your_logo_here.jpg (находится по пути \template\<ваш MERCHANT ID>\img) на файл с логотипом вашей компании:
| + | |
| − | | + | |
| − | [[File:tieto2-8.png|center|frame]]
| + | |
| − | | + | |
| − | Также вы можете указать любой другой файл изображения, поместив его в подкаталог \img и изменив в тексте файла cardinfo.html ссылку на этой изображение, например, так:
| + | |
| − | | + | |
| − | [[File:tieto2-9.png|center|frame]]
| + | |
| − | | + | |
| − | После сохранения шаблон с указанным изображением будет выглядеть, в случае нашего примера, вот так:
| + | |
| − | | + | |
| − | [[File:tieto2-10.png|center|frame]]
| + | |
| − | | + | |
| − | 5. После всех вышеперечисленных действий создаем архивный файл, содержащий наши файлы и подкаталоги, и отправляем этот архивный файл в банк «Русский Стандарт» с просьбой применить данный шаблон в качестве шаблона платежной страницы для вашего MERCHANT.
| + | |
| − | | + | |
| − | == Настройка платежной страницы ==
| + | |
| − | === Структура шаблона ===
| + | |
| − | После скачивания архива payment_page.zip (на текущий момент шаблон можно скачать по адресу http://static.sletat.ru/Files/templates/payment_page.zip ) его необходимо распаковать. После этого вам будут доступны для редактирования следующие подкаталоги и файлы:
| + | |
| − | | + | |
| − | [[File:tieto2-1.png|center|frame]]
| + | |
| − | | + | |
| − | Внимание: Структура подкаталогов должна быть строго определенная и не может быть изменена.
| + | |
| − | | + | |
| − | === Изменение шаблона ===
| + | |
| − | 1. Подкаталог 9290000000 необходимо переименовать, указав в качестве имени ваш MERCHANT ID, выданный банком. Таким образом, если ваш MERCHANT ID - 9290101010, то после переименования структура подкаталогов должна выглядеть так:
| + | |
| − | | + | |
| − | [[File:tieto2-2.png|center|frame]]
| + | |
| − | | + | |
| − | 2. Открыть файл cardinfo.html в notepad.exe (или в любом другом текстовом редакторе). После открытия файла вы должны увидеть следующее:
| + | |
| − | | + | |
| − | [[File:tieto2-3.png|center|frame]]
| + | |
| − | | + | |
| − | Обратите внимание, что в тексте присутствует прежнее название переименованного каталога: 9290000000.
| + | |
| − | | + | |
| − | Необходимо все такие строки переименовать в наше новое значение – полученный от банка MERCHANT ID. В notepad.exe это можно выполнить, вызвав команду меню
| + | |
| − | Правка – Заменить:
| + | |
| − | | + | |
| − | [[File:tieto2-4.png|center|frame]]
| + | |
| − | | + | |
| − | Укажите в качестве нового значения ваш (присвоенный банком «Русский Стандарт») MERCHANT ID. В нашем примере это будет выглядеть так:
| + | |
| − | | + | |
| − | [[File:tieto2-5.png|center|frame]]
| + | |
| − | | + | |
| − | После выполнения команды «Заменить все» наш текст будет выглядеть примерно так:
| + | |
| − | | + | |
| − | [[File:tieto2-6.png|center|frame]]
| + | |
| − | | + | |
| − | 3. После выполнения предыдущих операций, если вы откроете файл cardinfo.html в браузере (Internet Explorer, Firefox, Opera или любой другой), то ваш шаблон платежной страницы будет выглядеть следующим образом:
| + | |
| − | | + | |
| − | [[File:tieto2-7.png|center|frame]]
| + | |
| − | | + | |
| − | 4. Все, что осталось нам сделать – это применить по центру изображение логотипа вашей компании.
| + | |
| − | Для этого необходимо заменить файл your_logo_here.jpg (находится по пути \template\<ваш MERCHANT ID>\img) на файл с логотипом вашей компании:
| + | |
| − | | + | |
| − | [[File:tieto2-8.png|center|frame]]
| + | |
| − | | + | |
| − | Также вы можете указать любой другой файл изображения, поместив его в подкаталог \img и изменив в тексте файла cardinfo.html ссылку на этой изображение, например, так:
| + | |
| − | | + | |
| − | [[File:tieto2-9.png|center|frame]]
| + | |
| − | | + | |
| − | После сохранения шаблон с указанным изображением будет выглядеть, в случае нашего примера, вот так:
| + | |
| − | | + | |
| − | [[File:tieto2-10.png|center|frame]]
| + | |
| − | | + | |
| − | 5. После всех вышеперечисленных действий создаем архивный файл, содержащий наши файлы и подкаталоги, и отправляем этот архивный файл в банк «Русский Стандарт» с просьбой применить данный шаблон в качестве шаблона платежной страницы для вашего MERCHANT.
| + | |
