Передача дополнительных сведений об оплатах для их учёта на стороне веб-сервиса

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

С помощью параметра booking_info можно фиксировать сведения о бронировании, связанном с оплатой, и получать эти сведения в оповещениях от платёжной платформы. В отличие от используемых в отдельных индустриях «длинных записей» (подробнее) эта возможность может применяться более широко (например, для указания сведений о бронировании билетов на концерт) и гибко, без ограничений на категорию мерчанта (согласно коду Merchant Category Code, MCC). Вместе с тем, использование этой возможности не обеспечивает тех преимуществ, которые могут быть доступны при работе с «длинными записями», и при наличии вопросов о работе с этими возможностями можно обращаться к курирующему менеджеру Openpayze.

Параметр booking_info может использоваться практически для всех целевых действий с прямым использованием платёжных карт: в частности, для проведения оплат, блокировки средств, регистрации нерегулярных повторяемых оплат и проверки платёжных инструментов.

С помощью параметра booking_info можно фиксировать в запросах сведения о бронировании товаров и услуг.

Пример использования

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

• сбор и обработку информации о бронированиях билетов на фестивали;
• оперативный доступ своих сотрудников к актуальной информации такого рода по каждому пользователю.

Для этого настраивается следующая схема работы:

1. В каждом запросе на открытие Payment Page со стороны веб-сервиса мерчанта передаются сведения о бронировании в параметре booking_info. В значении этого параметра указывается строка, полученная в результате кодирования JSON-объекта алгоритмом Base64.

   Исходный JSON-объект может включать в себя следующую информацию.

   • Массив bookers с информацией о лицах, для которых бронируется услуга. Каждый элемент такого массива содержит:
     • first_name — имя получателя услуги, указанное при бронировании;
     • last_name — фамилия получателя услуги, указанная при бронировании;
     • email— адрес электронной почты, указанный при бронировании.
   • Массив items с информацией об отдельных услугах, которые входят в состав бронирования. Каждый элемент такого массива содержит:
     • description — описание отдельной услуги в рамках бронирования;
     • start_date — дата начала действия отдельной услуги;
     • end_date — дата окончания действия отдельной услуги.
   • А также следующие параметры:
     • start_date — дата начала действия забронированной услуги;
     • end_date — дата окончания действия забронированной услуги;
     • description — произвольное описание бронирования;
     • total — итоговая стоимость бронирования;
     • pax — количество лиц, для которых бронируется услуга;
     • reference — указатель забронированной услуги, в качестве которого могут выступать URL, название или код услуги в сервисе мерчанта;
     • id — идентификатор бронирования, уникальный в рамках сервиса мерчанта.
     Notice: Стоит учитывать, что в параметрах start_date и end_date исходного JSON-объекта должны передаваться даты начала и окончания забронированной услуги в целом, а в параметрах start_date и end_date массива items — даты начала и окончания отдельных её составляющих.
     Внимание: В параметрах total и pax следует передавать численное значение выше 0.
2. По результатам выполнения соответствующей операции информация из параметра booking_info передаётся к веб-сервису мерчанта в итоговом оповещении и становится доступной для просмотра в карточке платежа интерфейса Dashboard.
3. На стороне веб-сервиса обеспечивается необходимая обработка получаемой информации вместе с другой информацией о выполняемых операциях.

Подключение

Указывать параметр booking_info в запросах и получать передаваемые в нём сведения в оповещениях (при использовании типовой структуры оповещений) можно без согласований и каких-либо дополнительных действий. Эти возможности доступны по умолчанию.

Возможности использования параметра booking_info доступны по умолчанию и не требуют отдельного подключения.

Формат данных

Параметр booking_info может включаться в запросы на открытие Payment Page в виде строки, полученной в результате кодирования с применением алгоритма Base64 JSON-объекта booking_info с необходимыми параметрами бронирования.

{
    "payment": {
        "date": "2024-01-24T06:24:45+0000",
        "method": "card",
        "id": "FESTIVAL_PASS_1781",
        "sum": {
            "amount": 0,
            "currency": "EUR"
        },
        "type": "purchase",
        "status": "refunded",
        "description": "FESTIVAL_PASS_1781"
    },
    "project_id": 111738,
    "customer": {
        "id": "musicaficionado_83"
    },
    "account": {
        "number": "551115******1822",
        "token": "7123ba1f24f16a115f3390a9",
        "type": "mastercard",
        "card_holder": "WILLIAM HERSCHEL",
        "expiry_month": "08",
        "expiry_year": "2030"
    },
    "booking info": {    // Объект с информацией о бронировании
        "start_date": "12-08-2026",
        "end_date": "14-08-2026",
        "description": "Sideris music festival full pass",
        "total": 200000,
        "pax": 2,
        "bookers": [
          {
            "first_name": "William",
            "last_name": "Herschel",
            "email": "rsfellow@mail.com"
          },
          {
            "first_name": "Caroline",
            "last_name": "Herschel",
            "email": "salariedastronomer@mail.com"
          }
        ],        
        "items": [
          {
            "description": "VIP Arrival",
            "start_date": "12-08-2026",
            "end_date": "12-08-2026"
          },
          {
            "description": "Hotel",
            "start_date": "12-08-2026",
            "end_date": "14-08-2026"
          },
          {
            "description": "Concerts",
            "start_date": "12-08-2026",
            "end_date": "14-08-2026"
          },
          {
            "description": "VIP Departure",
            "start_date": "14-08-2026",
            "end_date": "14-08-2026"
          }
        ],
        "reference": "musicfestlink",
        "id": "83"
    },
    "operation": {
        "provider": {
            "payment_id": "0010000124258736",
            "auth_code": "",
            "endpoint_id": 414,
            "id": 414
        },
        "sum_converted": {
            "amount": 200000,
            "currency": "EUR"
        },
        "code": "0",
        "message": "Success",
        "id": 55386010114429,
        "type": "refund",
        "status": "success",
        "date": "2024-01-24T06:24:45+0000",
        "sum_initial": {
            "amount": 200000
            "currency": "EUR"
        },
        "created_date": "2024-01-24T06:24:43+0000",
        "request_id": "abcaf52323381a-d988c158cc4b43046-00055387"
    }
}

Подключение

Возможности применения параметра merchant_data для передачи и получения различных сведений следует согласовывать с курирующим менеджером Openpayze. После согласований специалисты Openpayze выполняют необходимые действия в платёжной платформе и уведомляют о готовности к включению расширенных сведений в оповещения и к отображению этих сведений в интерфейсе Dashboard.