Для систем продажи авиабилетов предусмотрена возможность передать в авторизационном запросе дополнительные поля с информацией о полете. Информация о полете используется для формирования расширенной записи, отсылаемой в банк. Минимальные банковские требования к информации о полете — имя авиакомпании, код агента, дата отправления, номер билета.
Алгоритм работы системы заказа билетов должен строиться по следующей схеме:
Дополнительные параметры для систем продажи авиабилетов передаются вместе с основными параметрами в авторизационном запросе, а также могут передаваться в запросах на подтверждение и отмену платежа, создание счета или оплату через web-сервисы silentpay и tokenpay в зависимости от того какие из этих запросов использует предприятие.
Поля, помеченные знаком «*», рекомендуется передавать для создания полной расширенной записи для банка.
Вся информация о полете передается в авторизационном запросе (кроме номера билета).
Номер билета (поле TICKET_NUMBER) передается в подтверждении оплаты (сервис charge — в запросе добавляется дополнительное поле TICKET_NUMBER).
Параметр PNR может быть передан как в авторизационном запросе, так и в запросе на подтверждение оплаты.
При двустадийном механизме работы списание средств со счета покупателя происходит только после подтверждения оплаты со стороны предприятия.
Для подтверждения оплаты нужно отправить запрос на сервер АПК Ассист методом HTTP POST или SOAP (в кодировке UTF-8).
URL запроса для передачи финансового подтверждения:
https://<SERVER-NAME>/charge/charge.cfm.
Список параметров запроса для подтверждения оплаты:
Название | Обязательное поле | Принимаемые значения | Значения по умолчанию | Описание |
Billnumber | Да | 15 или 16 цифр Расширенный формат | Номер платежа, соответствующий заказу в системе АПК Ассист, допускается передача расширенного номера платежа | |
Merchant_ID | Да | Число | Идентификатор предприятия в АПК Ассист | |
Login | Да | 20 символов | Логин | |
Password | Да | 30 символов | Пароль | |
Amount | Нет* | Число, 15 цифр (разделители «.», «,») | Сумма финансового подтверждения | |
Currency | Нет* | 3 символа | Код валюты подтверждения. Может быть использован только код валюты операции оплаты | |
ClientIP | Нет | Максимум 15 цифр, 4 разделителя «.» | IP компьютера оператора, который производит подтверждение платежа | |
Language | Нет | RU – русский | RU | Язык выдачи результатов |
TICKET_NUMBER | Да | 14 цифр | Номер билета — уникальный идентификационный номер билета от продавца билета. | |
Format | Нет | 1 – CSV, 2 – WDDX, | Формат входных данных | Формат выдачи результатов |
* Параметры Amount, Currency могут присутствовать или отсутствовать в запросе только одновременно. В случае отсутствия параметров операция подтверждения оплаты будет проведена на полную сумму.