Genel bakış

Entase JavaScript istemcisi, CDN'imizden yüklediğiniz küçük bir kütüphanedir. Web sitenize kendi başına yapamayacağı bir işlev kazandırır: Entase ödeme sayfasını bulunduğu yerde açmak; böylece ziyaretçi, bulunduğu sayfadan ayrılmadan bilet satın alır.

Paneli veya açılır pencereyi, arka plan katmanını, sayfa kaydırmasının kilitlenmesini, onay adımını, yerel ayarı ve izleme parametrelerini yönetir. Kodunuz, ödeme sayfasının ne zaman ve hangi etkinlik için açılacağına karar verir.

Ne değildir

İstemci; etkinlik listelerini, tarihleri, fiyatları veya müsaitliği görüntülemez. Programınızı gösteren hazır bir bileşen istiyorsanız bunun yerine yerleştirme kodlarını kullanın – bunlar kopyalayıp yapıştırmaya hazırdır ve geliştirme çalışması gerektirmez. Bkz. Etkinlikleri web sitenize yerleştirme.

Ancak ikisi birbirinin alternatifi değildir. Yerleştirme bileşeni, ödeme sayfasını açmak için arka planda aynı istemciyi yükler; bu nedenle istemci seçeneklerini yerleştirme yapılandırması üzerinden iletebilirsiniz. Bkz. Gelişmiş yerleştirme seçenekleri.

Ne zaman kullanılmalı

Kendi etkinlik sayfalarınız varsa ve kendi "Bilet satın al" düğmenizin Entase ödeme sayfasını açmasını istiyorsanız istemciyi doğrudan kullanın:

<button id="buy">Bilet satın al</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>

Tüm entegrasyon bundan ibarettir. Bu bölümdeki diğer her şey ayrıntılandırmadır: mevcut seçenekler, ödeme sayfasının panel ile açılır pencere arasında nasıl karar verdiği ve hangi olayları dinleyebileceğiniz.

İki ödeme sayfası modu

Ödeme sayfası iki yoldan biriyle açılır:

• Panel – sayfanızın içinde, masaüstünde sağdan ve mobilde alttan kayarak açılan satır içi bir panel. Ziyaretçi sitenizden hiç ayrılmaz.
• Açılır pencere – ayrı bir tarayıcı penceresi.

Panel modu daha iyi bir deneyim sunar, ancak yalnızca Entase ayarlarınıza güvenilir kaynak olarak eklediğiniz alan adları için kullanılabilir. İstemci, hangisini kullanmasına izin verildiğini algılar ve satır içi ödeme sayfasına izin verilmediğinde açılır pencereye geri döner. Entegrasyondan önce anlaşılması gereken en önemli davranış budur – bkz. Ödeme sayfası modları.

Gereksinimler

• HTTPS üzerinden sunulan bir sayfa. Düz HTTP'de istemci her zaman açılır pencere kullanır.
• Satır içi ödeme sayfası istiyorsanız alan adınızın Ayarlar → Entegrasyonlar bölümünde güvenilir kaynaklara eklenmiş olması gerekir. Bkz. Entegrasyonlar ve ödeme sayfası özelleştirmesi.
• Derleme adımı, paketleyici veya paket yöneticisi gerekmez. Kütüphane tek bir betik etiketidir.

Sonraki adımlar

• İstemciyi yükleme – betiği yükleme ve bir örnek oluşturma.
• Kurucu seçenekleri – tüm seçenekler ve varsayılan değerleri.
• Ödeme sayfasını açma – book() yöntemi ve çağrı başına geçersiz kılmalar.
• Olaylar – ödeme sayfasının açılmasına, kapanmasına ve tamamlanmasına tepki verme.