Параметры длинной записи в Gate API

Общая информация

В этом разделе перечислены параметры бронирования, которые могут передаваться в запросах платежной платформы ecommpay. Эти параметры используются для взаимодействия с Gate. Для каждого параметра приведена следующая информация:

  • Имя — название объекта или параметра;
  • Тип — тип параметра;
  • Описание — информация о бронировании, которую должен содержать параметр, а также формат значения параметра, а также, где это уместно, сведения о длине и допустимых значениях.

Все денежные суммы в длинной записи представляются в валюте платежа, а все суммы выражаются в дробных единицах валюты без десятичного знака, например 100 USD представляются в центах, то есть значением "10000".

Табл. 1. Объекты и параметры длинной записи
Имя Описание tree

lodging
object, optional

 Этот корневой объект, содержащий общие параметры бронирования отеля, а также вложенные объекты с параметрами, представляющими отдельные компоненты бронирования, например характеристики номера или сборы 1

customer_service_toll_free_number
string, required

Телефон сервисной службы отеля.

Строка из букв и цифр длиной не более 17 символов

 1-1 1

check_in_date
string, required

 Дата заселения в отель в формате дд-мм-гггг 1-2 1

check_out_date
string, required

 Дата выезда из отеля в формате дд-мм-гггг 1-3 1

folio_number
string, required

Уникальный номер бронирования в системе бронирования отелей.

Строка из букв и цифр длиной не более 25 символов

 1-4 1

room
object, required

 Объект, параметры которого описывают свойства номера отеля. Этот объект является дочерним по отношению к объекту lodging 2

tax
integer, optional

Общая сумма налога за номер.

Целое число длиной не более 12 десятичных знаков

 2-1 2

rate
integer, optional

Стоимость номера за ночь без налогов.

Целое число длиной не более 12 десятичных знаков

 2-2 2

number_of_nights
integer, optional

Количество ночей в номере отеля.

Целое число длиной не более двух десятичных знаков

 2-3 2

fire_safety_act_indicator
boolean, required

 Логическое значение, указывающее, удовлетворяет ли отель требованиям по пожаробезопасности в соответствии с актом Motel Fire Safety Act от 1990 года (PL101-391) или схожим нормативом 2-4 2

guest_name
string, optional

Имя клиента.

Строка из букв и цифр длиной не более 40 символов

 2-5 2

guest_number
string, optional

Идентификатор клиента в системе отеля.

Строка из букв и цифр длиной не более 25 символов

 2-5 2

billing_adjustment
string, optional

Сумма дополнительного счета, выставленного после выезда клиента.

Строка из букв и цифр длиной не более 12 символов

 2-7 2

property_phone_number
string, optional

Местный номер отеля.

Строка из букв и цифр длиной не более 17 символов

 2-8 2

no_show_indicator
string, optional

Булево значение, указывающее на неявку гостя в отель (no show). Значение true подразумевает, что клиент не явился в дату заезда в отель, не отменив бронирование.

Значение параметра по умолчанию — false

 2-9 2

prepaid_expenses
integer, optional

Сумма предоплаченных расходов.

Целое число длиной не более 12 десятичных знаков

 2-10 2

total_tax
integer, optional

Общая сумма налога. Параметр используется только для карт Visa, Visa Electron и Maestro. Для Mastercard параметр не используется.

Целое число длиной не более 12 десятичных знаков

 2-11 2

charges
object, optional

 Объект, содержащий информацию о сборах за услуги отеля. Этот объект является дочерним по отношению к объекту lodging 3

room_service
integer, optional

Сбор за обслуживание номеров.

Целое число длиной не более 12 десятичных знаков

 3-1 3

bar_or_lounge
integer, optional

Сборы за услуги бара или зоны отдыха.

Целое число длиной не более 12 десятичных знаков

 3-2 3

transportation
integer, optional

Сборы за трансфер.

Целое число длиной не более 12 десятичных знаков

 3-3 3

gratuity
integer, optional

Чаевые.

Целое число длиной не более 12 десятичных знаков

 3-4 3

conference_room
integer, optional

Сбор за использование конференц-зала.

Целое число длиной не более 12 десятичных знаков

 3-5 3

audio_or_visual
integer, optional

Сбор за использование аудио- или видео-оборудования.

Целое число длиной не более 12 десятичных знаков

 3-6 3

banquet
integer, optional

Сбор за услуги банкетного зала.

Целое число длиной не более 12 десятичных знаков

 3-1 3

internet_access
integer, optional

Сбор за доступ к Интернету.

Целое число длиной не более 12 десятичных знаков

 3-7 3

early_departure
integer, optional

Сбор за ранний выезд.

Целое число длиной не более 12 десятичных знаков

 3-1 3

phone
integer, optional

Сбор за пользование телефоном.

Целое число длиной не более 12 десятичных знаков

 3-8 3

restaurant
integer, optional

Сбор за услуги ресторана.

Целое число длиной не более 12 десятичных знаков

 3-9 3

minibar
integer, optional

Сбор за пользование мини-баром.

Целое число длиной не более 12 десятичных знаков

 3-10 3

gift_shop
integer, optional

Сбор за покупки в магазине сувениров.

Целое число длиной не более 12 десятичных знаков

 3-11 3

laundry_or_cleaning
integer, optional

Сбор за стирку и химчистку.

Целое число длиной не более 12 десятичных знаков

 3-12 3

valet
integer, optional

Сбор за услуги парковщика.

Целое число длиной не более 12 десятичных знаков

 3-13 3

movie
integer, optional

Сборы за просмотр фильмов и телепрограмм.

Целое число длиной не более 12 десятичных знаков

 3-14 3

business_center
integer, optional

Сбор за услуги бизнес-центра.

Целое число длиной не более 12 десятичных знаков

 3-15 3

health_club
integer, optional

Сбор за услуги фитнеса и SPA.

Целое число длиной не более 12 десятичных знаков

 3-16 3

Ссылки по теме