# Обзор

> JavaScript-клиент Entase открывает оформление заказа с вашего сайта – в виде встроенной панели или всплывающего окна – не перенаправляя посетителя на другую страницу.

JavaScript-клиент Entase – это небольшая библиотека, которую вы загружаете из нашей CDN. Он даёт вашему сайту возможность, недоступную ему самостоятельно: **открывать оформление заказа Entase прямо на странице**, чтобы посетитель мог купить билет, не покидая текущую страницу.

Он управляет панелью или всплывающим окном, фоном, блокировкой прокрутки страницы, этапом согласия, локалью и параметрами отслеживания. Ваш код определяет, *когда* открывать оформление заказа и *для какого события*.

## Чем он не является

Клиент не отображает списки событий, даты, цены или доступность. Если вам нужен готовый виджет с вашей программой, используйте коды встраивания – их достаточно скопировать и вставить, и они не требуют разработки. См. [Встраивание событий на ваш сайт](/organizers/sharing-and-embedding/embedding-events-on-your-website.md).

Однако это не альтернативы друг другу. Виджет встраивания использует тот же клиент для открытия оформления заказа, поэтому вы можете передавать параметры клиента через конфигурацию встраивания. См. [Расширенные параметры встраивания](/developers/js-client/embed-advanced-options.md).

## Когда его использовать

Используйте клиент напрямую, если у вас есть собственные страницы событий и вы хотите, чтобы ваша кнопка «Купить билеты» открывала оформление заказа Entase:

```html
<button id="buy">Buy tickets</button>

<script src="https://js.entase.com/client.js"></script>
<script>
  const entase = new Entase({ pk: 'YOUR_PUBLISHABLE_KEY' });
  document.getElementById('buy').addEventListener('click', () => {
    entase.book('EVENT_ID');
  });
</script>
```

На этом интеграция завершена. Всё остальное в этом разделе – уточнения: какие параметры доступны, как оформление заказа выбирает между панелью и всплывающим окном и какие события можно отслеживать.

## Два режима оформления заказа

Оформление заказа открывается одним из двух способов:

- **Панель** – встроенная панель на вашей странице, выезжающая справа на компьютере и снизу на мобильном устройстве. Посетитель не покидает ваш сайт.
- **Всплывающее окно** – отдельное окно браузера.

Режим панели обеспечивает более удобный опыт, но доступен только для доменов, добавленных вами в качестве доверенных источников в настройках Entase. Клиент определяет, какой режим разрешено использовать, и переключается на всплывающее окно, если встроенное оформление заказа не разрешено. Это важнейшее поведение, которое необходимо понять перед интеграцией – см. [Режимы оформления заказа](/developers/js-client/checkout-modes.md).

## Требования

- Страница, работающая по **HTTPS**. При обычном HTTP клиент всегда использует всплывающее окно.
- Ваш домен добавлен в **доверенные источники** в разделе «Настройки» → «Интеграции», если вы хотите использовать встроенное оформление заказа. См. [Интеграции и настройка оформления заказа](/organizers/settings/integrations-and-checkout-customization.md).
- Не требуются этап сборки, бандлер или менеджер пакетов. Библиотека подключается одним тегом script.

## Что дальше

- [Установка клиента](/developers/js-client/installing-the-client.md) – загрузка скрипта и создание экземпляра.
- [Параметры конструктора](/developers/js-client/constructor-options.md) – все параметры и их значения по умолчанию.
- [Открытие оформления заказа](/developers/js-client/opening-the-checkout.md) – метод `book()` и переопределения для отдельных вызовов.
- [События](/developers/js-client/events.md) – реакция на открытие, закрытие и завершение оформления заказа.