Atsiskaitymo režimai

Atsiskaitymas atidaromas vienu iš dviejų režimų.

Skydelis yra įterptinis skydelis, rodomas jūsų puslapio viduje. Staliniame kompiuteryje jis įslenka iš dešinės ir jo plotis ribojamas pane.width; mobiliajame įrenginyje jis išslenka iš apačios. Lankytojas lieka jūsų svetainėje, o skydelis užsidaro jam paspaudus „Escape“ arba spustelėjus pritemdytą sritį.

Iššokantis langas yra atskiras naršyklės langas, rodomas lankytojo ekrano centre. Klientas stebi, kada langas uždaromas, kad galėtų pašalinti foninį uždangalą.

Įterptiniam atsiskaitymui reikia patikimo kilmės šaltinio

Skydelio režimu Entase atsiskaitymas rodomas iframe elemente jūsų domene, todėl jis leidžiamas tik tiems domenams, kuriuos aiškiai autorizavote. Pridėkite kiekvieną domeną, kuriame atidaromas atsiskaitymas, prie Patikimų kilmės šaltinių skiltyje Nustatymai → Integracijos – žr. Integracijos ir atsiskaitymo tinkinimas.

Svarbu, ar įtrauktas priešdėlis www.. Jei nesate tikri, kurią formą naudoja jūsų svetainė, pridėkite abi.

Jei jūsų domeno sąraše nėra, atsiskaitymas vis tiek veiks – jis tiesiog bus atidarytas iššokančiame lange.

Kaip nustatoma 'auto' reikšmė

Naudojant numatytąjį checkoutMode: 'auto', klientas sprendžia tokia tvarka:

1. Ne HTTPS → iššokantis langas. Įterptinis atsiskaitymas niekada nenaudojamas nesaugiame puslapyje.
2. localhost arba 127.0.0.1 → skydelis, o konsolėje užregistruojamas įspėjimas. Tai kūrimo patogumui skirta galimybė, kad galėtumėte kurti naudodami įterptinį išdėstymą; ji nieko nesako apie tai, ar jūsų produkcinis domenas yra leidžiamas.
3. Kitu atveju → klientas klausia Entase, ar šis kilmės šaltinis gali naudoti įterptinį atsiskaitymą, ir siunčia pk, kad identifikuotų paskyrą. Jei atsakyme nurodomas skydelis, režimas tampa skydeliu.

Kol negaunamas atsakymas, režimas yra popup. Būtent toks veikimas greičiausiai jus nustebins: patikra yra asinchroninė, todėl book() iškvietus iškart įkėlus puslapį – dar prieš lankytojui turint galimybę ką nors spustelėti – gali būti atidarytas iššokantis langas net ir visiškai tinkamai sukonfigūruotame domene. Praktiškai tikras spustelėjimas visada įvyksta gerokai po to, kai patikra baigiama. Jei atsiskaitymą atidarote automatiškai, nustatykite režimą priverstinai, užuot pasikliovę aptikimu.

Priverstinis režimo nustatymas

Nustatykite aiškią checkoutMode reikšmę, kad aptikimas būtų visiškai praleistas:

const entase = new Entase({ pk: 'YOUR_PUBLISHABLE_KEY', checkoutMode: 'popup' });

Arba pakeiskite ją vienam užsakymui:

entase.book('EVENT_ID', { checkoutMode: 'popup' });

Priverstinai nustačius 'pane' domene, kuris nėra patikimas kilmės šaltinis, leidimas nesuteikiamas – skydelis atsidaro, tačiau jame esantis atsiskaitymas negali susisiekti su jūsų puslapiu. Naudokite 'popup' sąmoningai pasirinkdami, o kai norite įterptinio atsiskaitymo visur, kur jis leidžiamas, palikite 'auto'.

Neatpažinta reikšmė ignoruojama ir laikoma 'auto'.

Režimo nuskaitymas ir keitimas vykdymo metu

entase.getCheckoutMode();        // 'pane' arba 'popup' – niekada 'auto'
entase.setCheckoutMode('popup'); // taikoma kiekvienam vėlesniam book() iškvietimui

getCheckoutMode() grąžina nustatytą režimą, todėl nurodo, kas iš tikrųjų įvyks. Nustačius režimą atgal į 'auto', aptikimas vykdomas iš naujo.

Iššokančių langų blokavimas

Naršyklės leidžia window.open() tik naudotojo veiksmo metu. Iškvieskite book() tiesiogiai spustelėjimo apdorojimo funkcijoje – ne po await, fetch ar setTimeout, nes tuo metu veiksmas jau bus pasibaigęs ir iššokantis langas bus užblokuotas.

// Užblokuota: iki book() vykdymo veiksmas jau pasibaigęs.
button.addEventListener('click', async () => {
  const event = await fetch('/api/current-event').then(r => r.json());
  entase.book(event.id);
});

// Gerai: pirmiausia gaukite id, tada atidarykite spustelėję.
button.addEventListener('click', () => entase.book(button.dataset.eventId));

Tai taikoma tik iššokančio lango režimui. Skydelio režimas puslapyje sukuria elementą, todėl šis apribojimas jam netaikomas.