Длинная запись в Gate

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

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

  • Ограничение на MCC-код — длинная запись используется только в туристической отрасли, поэтому платежи с этой записью доступны только для мерчантов с определенными MCC-кодами. В частности, для бронирований отелей разрешены только MCC-коды из диапазона 3501–3999 и код 7011.
  • Обязательное наличие длинной записи в начальном запросе на оплату — длинная запись должна обязательно передаваться в начальном запросе. В последующих запросах ее использовать не обязательно. Если в начальном запросе длинная запись не передавалась, то при попытке передать длинную запись в любом из последующих запросов платежная платформа вернет ошибку.

Кроме того, использование длинной записи поддерживается только при проведении операций с использованием карт платёжных систем Visa и Mastercard.

Информация длинной записи размещается в запросе в виде JSON-объекта lodging. Общая информация о бронировании размещается в параметрах самого объекта lodging, а сведения о номере отеля и сбора размещаются в дочерних объектах room и charges соответственно. Далее приводится пример наполнения объекта lodging информацией о бронировании.

Рис.: Пример JSON-объекта lodging с информацией о бронировании отеля

{
 "lodging": {
  "customer_service_toll_free_number": "88005553535", // Телефон поддержки клиентов отеля 
  "guest_name": "John Smith",        // Ф.И.О. гостя
  "check_in_date": "10-12-2019",     // Дата въезда в отель
  "check_out_date": "22-12-2019",    // Дата выезда из отеля
  "folio_number": "56265655ABC",     // Номер бронирования
  "fire_safety_act_indicator": true, // Класс пожарной безопасности отеля
  "room": {            // Объект с параметрами номера
  "rate": 12,                 // Стоимость суток проживания
  "number_of_nights": "12"    // Количество ночей
  },
  "charges": {            // Объект с суммами сборов
  "transportation": 1200,       // Сбор за услуги трансфера
  "internet_access": 4500       // Сбор за доступ к Интернету
  }
 }
}

Подробная информация о параметрах и дочерних объектах объекта lodging содержится в разделе Параметры длинной записи в Gate, а также в спецификации API Gate.

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