# Fizetési átjárók beállítása

> A fizetési átjárók bekapcsolása, a PayPal és a Stripe kulcsai, az űrlap átjáró-választása és a Manual mód több átjáróval.

A JetFormBuilder két fizetési átjárót ismer: a **PayPal Checkout** a JetFormBuilder alapfunkciója, a **Stripe Checkout** a Stripe Gateway kiegészítőt igényli. Ez a fejezet az átjárók közös beállítását írja le: hol kapcsolod be őket, hová kerülnek a kulcsok, és hogyan választod ki az űrlapon, melyik átjáró dolgozzon.

A Stripe-specifikus mezőkről a [Beállítás](https://hub.hellowp.io/hu/plugins/jet-form-builder-stripe-gateway/beallitas/), az egész űrlap felépítéséről a [Stripe-fizetős űrlap létrehozása](https://hub.hellowp.io/hu/plugins/jet-form-builder-stripe-gateway/elso-lepesek-fizetos-urlap/) fejezetben olvashatsz.

## A kulcsok megszerzése

### Stripe

1. Nyisd meg a Stripe regisztrációs oldalát, és hozz létre fiókot, vagy lépj be a meglévőbe.
2. Új fióknál a Stripe e-mailt küld. Kattints a benne lévő **Verify email** linkre.
3. A Stripe vezérlőpultján menj a **Developers → API keys** oldalra.
4. Másold ki a **Publishable key** és a **Secret key** értékét.

Kezdd Sandbox (teszt) módban: a vezérlőpult bal felső sarkában ilyenkor a **Sandbox** felirat látszik. Éles fiókból a jobb felső **Viewing test data** gombbal válthatsz át.

### PayPal

A PayPal kulcsait a PayPal fejlesztői oldalán találod.

1. Lépj be a PayPal Developer oldalra (új fióknál a **Get started** gombbal regisztrálj).
2. Nyisd le az **Apps & Credentials** fület, és keresd meg a **REST API apps** szakaszt. Itt alapból van egy **Default Application**.
3. Ha külön kulcs kell, kattints a **Create App** gombra, és töltsd ki a felugró ablakot. Az új alkalmazás megjelenik a listában.
4. Másold ki a kívánt alkalmazás **Client ID** és **Secret Key** értékét.

Éles használathoz a PayPal fiókodban a **Sandbox** módról **Live** módra kell váltani az **Apps & Credentials** oldalon. A pénznem kódja a PayPal által támogatott háromjegyű kód legyen.

## A globális beállítás

1. Menj ide: **JetFormBuilder → Beállítások → Payments Gateways**.
2. Kapcsold be az **Enable Gateways** kapcsolót. Ez teszi lehetővé a fizetési műveleteket.
3. Ha a PayPal fiókodban Sandbox módot használsz, kapcsold be az **Enable Test Mode** kapcsolót is. Ez a kapcsoló csak a PayPal átjáróra hat. Éles módban hagyd kikapcsolva.
4. Nyisd le a **PayPal Gateway API** szakaszt, írd be a **Client ID** és a **Secret Key** értékét, és kattints a **Save** gombra.
5. Nyisd le a **Stripe Gateway API** szakaszt, írd be a **Public Key** és a **Secret Key** értékét, és kattints a **Save** gombra.

![A Payments Gateways beállítóoldal bekapcsolt átjárókkal, megnyitott PayPal és Stripe szakasszal](./kepek/elso-lepesek-fizetesi-atjarok-beallitas.webp)

*A Payments Gateways beállítóoldal bekapcsolt átjárókkal, megnyitott PayPal és Stripe szakasszal* (https://minta-bolt.hu/wp-admin/edit.php?post_type=jet-form-builder&page=jfb-settings)

A képen az **Enable Gateways** be van kapcsolva, és mindkét átjáró kulcsmezői látszanak. A **Stripe Gateway API** szakasz csak akkor jelenik meg, ha a Stripe Gateway kiegészítő aktív.

## Az űrlap átjáró-választása

Nyisd meg az űrlapot a **JetFormBuilder → Űrlapok** listából. A jobb oldali **JetForm** fülön a **Gateways Settings** szakaszban ezek közül választhatsz:

| Lehetőség | Mit csinál |
|---|---|
| **None** | Az űrlapon nincs fizetés. |
| **PayPal Checkout** | A PayPal átjárót állítja be. Mellette az **Edit** gombbal nyílik a beállítóablak. |
| **Stripe Checkout** | A Stripe átjárót állítja be, szintén az **Edit** gombbal. |
| **Manual** | A látogató választ az átjárók közül. |

A **PayPal Checkout** és a **Stripe Checkout** közül egyszerre csak egyet jelölhetsz ki.

### A PayPal Checkout beállításai

Az **Edit PayPal Checkout Settings** ablak a Stripe ablakához hasonló:

| Beállítás | Mit csinál |
|---|---|
| **Use Global Settings** | Bekapcsolva a **Client ID** és a **Secret Key** mezőt a globális beállításból tölti ki. Kikapcsolva kézzel is megadhatod. |
| **Gateway Action** | A beküldés után lefutó fizetési forgatókönyv. |
| **Request Button** | A **Sync Access Token** gomb, amely ellenőrzi a kulcsokat. |
| **Currency Code** | Háromjegyű pénznemkód (a szinkron után jelenik meg). |
| **Price/amount field** | Az árat tartalmazó űrlapmező (a szinkron után jelenik meg). |
| **Payment success message** és **Payment failed message** | A sikeres és a sikertelen fizetés üzenete, a [makrókkal](https://hub.hellowp.io/hu/plugins/jet-form-builder-stripe-gateway/hasznalat/) kiegészíthető. |

A beállítások után görgess az ablak aljára, kattints az **Update** gombra, majd mentsd az űrlapot.

### A Stripe Checkout beállításai

Az **Edit Stripe Checkout Settings** ablak ugyanígy épül fel, csak a **Client ID** helyett **PUBLIC KEY** mező van, ahová a Stripe Publishable kulcsa kerül. Ha bekapcsolod a **Use Global Settings** kapcsolót, mindkét kulcs magától kitöltődik, utána kattints a **Sync Access Token** gombra.

- **GATEWAY ACTION**: a **Pay Now** a **CURRENCY CODE** és a **PRICE/AMOUNT FIELD** mezőt nyitja meg. Az **Előfizetés** az előfizetési csomag mezőit.
- **FIZETÉSI MÓDOK**: az **Auto** minden módot felkínál, a **Select Manually** engedi, hogy te válassz a listából.
- Az üzenetek és a makrók ugyanúgy működnek, mint a PayPalnál.

A mezők részletes leírását a [Beállítás](https://hub.hellowp.io/hu/plugins/jet-form-builder-stripe-gateway/beallitas/) fejezetben találod.

## Manual: több átjáró egy űrlapon

Ha a látogató döntse el, PayPalon vagy Stripe-on fizet:

1. A **Gateways Settings** szakaszban válaszd a **Manual** lehetőséget.
2. Kapcsold be a **Show on frontend** kapcsolót mindkét átjáró alatt (**PayPal Checkout** és **Stripe Checkout**).
3. Ha még nem állítottad be őket, kattints az **Edit** gombokra, és add meg a beállításokat.
4. Kattints az **Add block** gombra a **Manual** alatti sárga dobozban. Ezzel a Multi Gateway (fizetési módok) blokk bekerül az űrlapra. A blokkot a blokkkereső mezőből is behúzhatod bárhová.

![Az űrlap Gateways Settings szakasza Manual móddal és bekapcsolt Show on frontend kapcsolókkal](./kepek/elso-lepesek-manual-atjaro.webp)

*Az űrlap Gateways Settings szakasza Manual móddal és bekapcsolt Show on frontend kapcsolókkal* (https://minta-bolt.hu/wp-admin/post.php?post=4&action=edit)

A képen a **Manual** lehetőség, az **Add block** gomb és a két bekapcsolt **Show on frontend** kapcsoló látszik. Alattuk a **Secure payment amount** kapcsoló található.

Manual módnál mindkét átjáróhoz külön kell eseményeket rendelned a beküldés utáni műveletekhez, lásd az [Akciók és események](https://hub.hellowp.io/hu/plugins/jet-form-builder-stripe-gateway/elso-lepesek-akcio-esemenyek/) fejezetet.

## Secure payment amount

A **Secure payment amount** kapcsoló az űrlap összes, az árhoz kötött átjárójára érvényes. Bekapcsolva az összeg csak olyan mezőből jöhet, amelynek értékét a látogató nem tudja átírni.

- Megfelelő: **Calculated Field**, **Hidden Field** (kikapcsolt **Render in HTML** mellett), számított értékű **Select/Radio/Checkbox** mezők és a JetBooking árvariábilis makrói.
- Nem megfelelő: Text, Number és Date mező, **Hidden Field** bekapcsolt **Render in HTML** mellett, és a bejegyzés meta makrói (például `%META::...%`).

## Gyakori kérdések

**Mi a különbség a teszt és az éles mód között?**
A JetFormBuilder abban a módban dolgozik, amelyet a PayPal vagy a Stripe fiókodban beállítottál. PayPalnál Sandbox használatakor kapcsold be az **Enable Test Mode** kapcsolót, élesben hagyd kikapcsolva. A Stripe tesztelése a Stripe saját Sandbox kulcsaival megy.

**Hogyan kapcsolom be az átjárókat?**
A **JetFormBuilder → Beállítások → Payments Gateways** oldalon az **Enable Gateways** kapcsolóval, majd az űrlapban a globális vagy az űrlaponkénti kulcsokkal.

**Hogyan használok külön kulcsot egy űrlaphoz?**
Az **Edit Stripe Checkout Settings** vagy az **Edit PayPal Checkout Settings** ablakban ne kapcsold be a **Use Global Settings** kapcsolót, és írd be a kulcsokat az ablakban.

**Hogyan jelenítek meg több átjárót az űrlapon?**
Válaszd a **Manual** lehetőséget, és add hozzá a fizetési módok blokkot az **Add block** gombbal, vagy húzd be a blokkot a blokkkeresőből.