Способы подключения

Подключение по API

Приложение 2. Спецификация дополнительных полей для платежей в авиакоммерции и бронировании отелей

Приложение 2. Спецификация дополнительных полей для платежей в авиакоммерции и бронировании отелей


Для улучшения контроля и качества в сфере борьбы с мошенничеством при предоставлении услуг Интернет Коммерции при продаже авиабилетов и бронировании отелей, необходимо при регистрации платежа в платёжном шлюзе передавать дополнительную информацию о составе пассажиров и параметрах перелёта, а так же при бронировании отеля указывать информацию о постояльцах.

Дополнительная информация передаваемая при авиакомерции

Ниже приведена таблица, в которой указано название дополнительных полей, а так же их описание.

ОбязательностьНазвание поляОписание поля
1Да TICKETНомер билета/номер бронирования
2НетLANGUAGEЯзык или гражданство оформляющего билет клиента
3Да USER_FIRST_NAMEИмя клиента, осуществляющего оформление билетов
4Да USER_LAST_NAMEФамилия клиента, осуществляющего оформление билетов
5НетUSER_MOBILE_PHONEМобильный номер телефона клиента, осуществляющего оформление билетов
6НетUSER_HOME_PHONEДомашний номер телефона клиента, осуществляющего оформление билетов
7Да USER_EMAILАдрес электронной почты клиента, осуществляющего оформление билетов
8Да S{N}-BDATEДата и время вылета по сегменту номер N. Используемый формат: dd.mm.yyyy hh24:mi: ss.
9Да S{N}-EDATEДата и время прилёта по сегменту номер N. Используемый формат: dd.mm.yyyy hh24:mi: ss.
10Да S{N}-BLOCATIONCOUNНазвание страны вылета по сегменту номер N, указанное на русском или английском языке
11Да S{N}-ELOCATIONCOUNНазвание страны прилёта по сегменту номер N, указанное на русском или английском языке
12Да S{N}-BLOCATIONCODEКод аэропорта вылета по сегменту номер N, указанное на русском или английском языке
13Да S{N}-ELOCATIONCODEКод аэропорта прилёта по сегменту номер N, указанное на русском или английском языке
14Да S{N}-BLOCATIONCITYНазвание города вылета по сегменту номер N, указанное на русском или английском языке
15Да S{N}-ELOCATIONCITYНазвание города прилёта по сегменту номер N, указанное на русском или английском языке
16Да S{N}-FLIGHTNUMBERНомер рейса по сегменту номер N
17Да P{M}-FIRSTNAMEИмя пассажира номер M
18Да P{M}-LASTNAMEФамилия пассажира номер M

Дополнительные пояснения:

  • S{N} — указание на номер сегмента перелёта. Под Сегментом в данном случае подразумевается перелёт из одного аэропорта в другой без совершения авиатранспортом посадок. Параметр {N} может быть число от 1 до 99, т. е. общее название будет изменяться в диапазоне от S1 до S99.

  • P{M} — указание на номер пассажира. Параметр {M} может быть числом от 1 до 99, т. е. общее название будет изменяться в диапазоне от P1 до P99.

Пример заполнения параметров:

Название поля**Значение поля **
1TICKET5WY8FZ
2LANGUAGERU
3USER_FIRST_NAMEMaxim
4USER_LAST_NAMEZhukoveckiy
5USER_MOBILE_PHONE+7 905 545 73 19
6USER_HOME_PHONEnull
7USER_EMAIL11@11.ru
8S{N}-BDATE22.01.2013 15:40:00
9S{N}-EDATE22.01.2013 15:40:00
10S{N}-BLOCATIONCOUNРоссийская Федерация
11S{N}-ELOCATIONCOUNРоссийская Федерация
12S{N}-BLOCATIONCODEPEE
13S{N}-ELOCATIONCODELED
14S{N}-BLOCATIONCITYПермь
15S{N}-ELOCATIONCITYСанкт-Петербург
16S{N}-FLIGHTNUMBER712
17P{M}-FIRSTNAMEMaxim
18P{M}-LASTNAMEZhukoveckiy

Дополнительная информация передаваемая при бронировании и оплате отелей

Ниже приведена таблица, в которой указано название дополнительных полей, а так же их описание.

ОбязательностьНазвание поляОписание
1НетHLANGUAGEЯзык или гражданство оформляющего бронирование клиента
2Да HUSER_FIRST_NAMEИмя клиента осуществляющего оформление бронирования
3Да HUSER_LAST_NAMEФамилия клиента осуществляющего оформление бронирования
4НетHUSER_MOBILE_PHONEМобильный номер телефона клиента, осуществляющего оформление бронирования
5НетHUSER_HOME_PHONEДомашний номер телефона клиента, осуществляющего оформление бронирования
6Да HUSER_EMAILАдрес электронной почты клиента, осуществляющего оформление бронирования
7Да H{N}-BDATEДата заезда гостей в отель номер N. Используемый формат: dd.mm.yyyy hh24:mi: ss.
8Да H{N}-EDATEДата выезда гостей из отеля номер N. Используемый формат: dd.mm.yyyy hh24:mi: ss.
9Да H{N}-LOCATIONCOUNНазвание страны нахождения отеля номер N, указанное на русском или английском языке
10Да H{N}-SLOCATIONCOUNНазвание города нахождения отеля номер N, указанное на русском или английском языке
11Да H{N}-NAMEНазвание отеля номер N, указанное на русском или английском языке
12Да H{N}-GCOUNTКоличество гостей в отеле номер N. Необходимо указать количество взрослых и детей через символ двоеточие
13Да H{M}-GFIRSTNAMEИмя гостя номер M
14Да H{M}-GLASTNAMEФамилия гостя номер M

Дополнительные пояснения:

  • H{N} — указание на номер отеля в списке бронирования. Под списком бронирования понимается, что клиент может забронировать несколько отелей и перемещаться между ними в течение времени. Параметр {N} может быть числом от 1 до 99, т. е. общее название будет изменяться в диапазоне от H1 до H99.

  • H{N}-GCOUNT — общее количество гостей с указанием количества взрослых и детей. Если бронирование в отеле рассчитано на двух взрослых и одного ребёнка, то необходимо указать значение «2:1», если бронирование в отеле рассчитано на двух взрослых и ноль детей, то необходимо указать «2:0». Возможно заселение детей без взрослого (например, языковые школы или стажировки). Т. е. если бронирование в отеле рассчитано на ноль взрослых и двух детей, то необходимо указать значение «0:2».

  • H{M} — указание на номер гостя. Параметр {M} может быть числом от 1 до 99, т. е. общее название будет изменяться в диапазоне от H1 до H99. Так как зачастую для заселения отели требуют предоставление детальной информации только об одном госте с указанием общего количества гостей. В данном случае возможна передача информации только об указанном госте и общем количестве гостей.

Пример заполнения параметров:

Название поляЗначение поля
1HLANGUAGERU
2HUSER_FIRST_NAMEMaxim
3HUSER_LAST_NAMEZhukoveckiy
4HUSER_MOBILE_PHONE+7 905 545 73 19
5HUSER_HOME_PHONEnull
6HUSER_EMAIL11@11. r u
7H{N}-BDATE22.01.2013 15:40:00
8H{N}-EDATE22.01.2013 15:40:00
9H{N}-LOCATIONCOUNРоссийская Федерация
10H{N}-SLOCATIONCOUNСанкт-Петербург
11H{N}-NAMEAkyan St-Petersburg
12H{N}-GCOUNT2:0
13H{M}-GFIRSTNAMEMaxim
14H{M}-GLASTNAMEZhukoveckiy