# Общ преглед

> 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).
- Не са нужни стъпка за изграждане, bundler или мениджър на пакети. Библиотеката е един-единствен 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) – реакция при отваряне, затваряне и завършване на процеса на плащане.
