Использование «длинной записи»
Общая информация
Gate поддерживает так называемую длинную запись (addendum), которая используется в туристической отрасли и подразумевает передачу в запросах платежной платформы информации о бронировании, например номеров брони, имен гостей отеля или путешественников, дат проживания или путешествия. Информация о бронировании передается в запросе в дополнение к обычным данным о платеже. Использование длинной записи позволяет повысить безопасность операций и снизить стоимость платежей.
В целом, платежи с длинной записью обрабатываются в обычном порядке, но в процессе их обработки есть ряд особенностей:
- Ограничение на MCC-код — длинная запись используется только в туристической отрасли, поэтому платежи с этой записью доступны только для мерчантов с определенными MCC-кодами. В частности, для бронирований отелей разрешены только MCC-коды из диапазона 3501–3999 и код 7011.
- Обязательное наличие длинной записи в начальном запросе на оплату — длинная запись должна обязательно передаваться в начальном запросе. В последующих запросах ее использовать не обязательно. Если в начальном запросе длинная запись не передавалась, то при попытке передать длинную запись в любом из последующих запросов платежная платформа вернет ошибку.
Кроме того, использование длинной записи поддерживается только при проведении операций с использованием карт платёжных систем Visa и Mastercard.
Информация длинной записи размещается в запросе в виде JSON-объекта lodging. Общая информация о бронировании размещается в параметрах самого объекта lodging, а сведения о номере отеля и сбора размещаются в дочерних объектах room и charges соответственно. Далее приводится пример наполнения объекта lodging информацией о бронировании.
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, а также в спецификации API Gate.