# Ftuħ tal-checkout

> Il-metodu book() jiftaħ il-checkout għal avveniment wieħed, u jaċċetta sostituzzjonijiet għal kull sejħa kif ukoll kuntest tal-klijent li tista’ tgħaddi fis-sistemi tiegħek.

`book()` huwa l-metodu li jiftaħ il-checkout. Kull ħaġa oħra fil-klijent tikkonfigurah jew tosservah.

```js
entase.book(eventID);
entase.book(eventID, options);
```

`eventID` huwa l-identifikatur tal-avveniment skedat li trid tbigħ. Huwa l-istess id użat fil-kodiċijiet ta’ kondiviżjoni u inkorporazzjoni tal-avveniment tiegħek.

Is-sejħa tirritorna minnufih – tiftaħ il-pannell jew it-tieqa u ma tistenniex li l-viżitatur itemm il-proċess. Uża [l-avvenimenti](/developers/js-client/events.md) biex tirreaġixxi għal dak li jiġri wara.

## Għażliet

| Isem | Tip | Default | Deskrizzjoni |
|---|---|---|---|
| `checkoutMode` | string | valur tal-istanza | `'pane'` jew `'popup'` għal din il-prenotazzjoni biss. |
| `clientContext` | object | `null` | Data arbitrarja mgħoddija lill-checkout ladarba jkun lest. Ara hawn taħt. |
| `collectConsent` | boolean | valur tal-istanza | Jekk għandux jitlob lill-viżitatur jaċċetta l-avviż tat-termini. |
| `backdrop` | boolean | valur tal-istanza | Jekk għandhiex tiskura l-paġna wara l-checkout. |
| `backdropColor` | string | valur tal-istanza | Il-kulur taż-żona skurata. |
| `pane` | object | valur tal-istanza | `{ width, height }` għall-pannell integrat. |
| `popup` | object | valur tal-istanza | `{ width, height }` għat-tieqa pop-up. |

Kwalunkwe ħaġa li tħalli barra terġa’ lura għall-valur li bih inbniet l-istanza, għalhekk l-għażliet għal kull sejħa huma addittivi minflok sett ta’ sostituzzjoni.

```js
entase.book('EVENT_ID', {
  pane: { width: '60vw' },
  backdrop: false,
  clientContext: { source: 'homepage-hero' }
});
```

## Kuntest tal-klijent

`clientContext` huwa oġġett tad-disinn tiegħek stess. Il-klijent iżommu sakemm il-checkout jindika li huwa lest, imbagħad jgħaddih. Użah biex iġġorr informazzjoni li l-paġna tiegħek biss taf – liema buttuna ġiet ikklikkjata, minn liema kampanja wasal viżitatur, referenza interna ta’ klijent – sas-sessjoni tal-checkout.

Il-kuntest jinħażen għal kull id ta’ avveniment, għalhekk il-prenotazzjoni ta’ żewġ avvenimenti differenti mill-istess paġna żżomm il-kuntesti tagħhom separati.

Tpoġġi xejn sensittiv fih. Dan jivvjaġġa lejn il-checkout permezz tal-browser u huwa viżibbli għal kull min jispezzjona l-paġna.

## Ftuħ ta’ diversi avvenimenti minn paġna waħda

Istanza waħda timmaniġġja kwalunkwe numru ta’ avvenimenti. Oħloqha darba u għaddi id differenti kull darba:

```js
const entase = new Entase({ pk: 'YOUR_PUBLISHABLE_KEY' });

document.querySelectorAll('[data-event-id]').forEach(button => {
  button.addEventListener('click', () => {
    entase.book(button.dataset.eventId, {
      clientContext: { source: button.dataset.source }
    });
  });
});
```

## Wara li l-klijent jinqered

Jekk issejjaħ `book()` fuq istanza li diġà qridt, tiġi rreġistrata żball fil-console u ma jinfetaħ xejn. Dan huwa intenzjonat – istanza meqruda ma tibqax tisma’ messaġġi mill-checkout, għalhekk it-tieqa li fetħet ma setgħetx tingħalaq jew tiġi osservata. Oħloq istanza ġdida minflok.

## Għeluq tal-checkout

Il-viżitatur jagħlaq il-checkout hu stess: Escape jew klikk fuq iż-żona skurata fil-modalità pane, jew il-kontrolli tat-tieqa fil-modalità pop-up. Il-checkout jagħlaq ukoll waħdu meta titlesta prenotazzjoni.

Ma hemm l-ebda metodu pubbliku biex tagħlqu mill-kodiċi tiegħek. Jekk għandek bżonn tkun taf meta ngħalaq, isma’ l-avveniment `checkout.closed`.