# Überblick

> Der Entase-JavaScript-Client öffnet den Checkout über Ihre eigene Website – entweder als eingebettetes Panel oder als Pop-up-Fenster, ohne Besucher auf eine andere Seite weiterzuleiten.

Der Entase-JavaScript-Client ist eine kleine Bibliothek, die Sie über unser CDN laden. Sie ermöglicht Ihrer Website etwas, das sie allein nicht kann: **den Entase-Checkout direkt auf der Seite zu öffnen**, sodass Besucher ein Ticket kaufen können, ohne die aktuelle Seite zu verlassen.

Er übernimmt das Panel oder Pop-up-Fenster, den Hintergrund, das Sperren des Seiten-Scrollens, den Einwilligungsschritt, die Sprache und Tracking-Parameter. Ihr Code entscheidet, *wann* der Checkout geöffnet wird und *für welche Veranstaltung*.

## Was er nicht ist

Der Client rendert keine Veranstaltungslisten, Termine, Preise oder Verfügbarkeiten. Wenn Sie ein sofort einsatzbereites Widget wünschen, das Ihr Programm anzeigt, verwenden Sie stattdessen die Einbettungscodes – diese können Sie einfach kopieren und einfügen und benötigen keine Entwicklungsarbeit. Siehe [Veranstaltungen auf Ihrer Website einbetten](/organizers/sharing-and-embedding/embedding-events-on-your-website.md).

Die beiden sind jedoch keine Alternativen. Das Einbettungs-Widget lädt im Hintergrund denselben Client, um seinen Checkout zu öffnen. Deshalb können Sie Client-Optionen über die Einbettungskonfiguration übergeben. Siehe [Erweiterte Einbettungsoptionen](/developers/js-client/embed-advanced-options.md).

## Wann Sie ihn verwenden sollten

Verwenden Sie den Client direkt, wenn Sie eigene Veranstaltungsseiten haben und Ihre eigene Schaltfläche „Tickets kaufen“ den Entase-Checkout öffnen soll:

```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>
```

Das ist die gesamte Integration. Alles Weitere in diesem Abschnitt dient der Feinabstimmung: welche Optionen verfügbar sind, wie der Checkout zwischen einem Panel und einem Pop-up entscheidet und auf welche Ereignisse Sie reagieren können.

## Zwei Checkout-Modi

Der Checkout wird auf eine von zwei Arten geöffnet:

- **Panel** – ein eingebettetes Panel auf Ihrer Seite, das sich auf Desktop-Geräten von rechts und auf Mobilgeräten von unten einschiebt. Besucher verlassen Ihre Website nie.
- **Pop-up** – ein separates Browserfenster.

Der Panel-Modus bietet die bessere Nutzererfahrung, ist jedoch nur für Domains verfügbar, die Sie in Ihren Entase-Einstellungen als vertrauenswürdige Origins hinzugefügt haben. Der Client erkennt, welchen Modus er verwenden darf, und wechselt zu einem Pop-up, wenn der eingebettete Checkout nicht zulässig ist. Dies ist das wichtigste Verhalten, das Sie vor der Integration verstehen sollten – siehe [Checkout-Modi](/developers/js-client/checkout-modes.md).

## Voraussetzungen

- Eine über **HTTPS** bereitgestellte Seite. Bei einfachem HTTP verwendet der Client immer ein Pop-up.
- Ihre Domain ist unter **vertrauenswürdige Origins** in Einstellungen → Integrationen hinzugefügt, wenn Sie den eingebetteten Checkout verwenden möchten. Siehe [Integrationen und Checkout-Anpassung](/organizers/settings/integrations-and-checkout-customization.md).
- Kein Build-Schritt, Bundler oder Paketmanager. Die Bibliothek besteht aus einem einzigen Script-Tag.

## Wie es weitergeht

- [Den Client installieren](/developers/js-client/installing-the-client.md) – das Script laden und eine Instanz erstellen.
- [Konstruktoroptionen](/developers/js-client/constructor-options.md) – jede Option und ihr Standardwert.
- [Den Checkout öffnen](/developers/js-client/opening-the-checkout.md) – die Methode `book()` und Überschreibungen pro Aufruf.
- [Ereignisse](/developers/js-client/events.md) – auf das Öffnen, Schließen und Abschließen des Checkouts reagieren.