# Beállítás

> A Stripe Gateway telepítése, a Stripe API-kulcsok megszerzése és megadása, az űrlap Stripe Checkout beállításai.

A beállítás négy lépés: a kiegészítő telepítése, a Stripe API-kulcsok megszerzése, a kulcsok megadása a JetFormBuilderben, majd az űrlap átjáró-beállításai.

## 1. A kiegészítő telepítése

1. Menj ide: **JetFormBuilder → Addons**.
2. Az **All Available Addons** szakaszban keresd meg a **Stripe Payment Gateway** kártyát, és kattints az **Install Addon** gombra.
3. A telepítés után a kártya a **Your Installed Addons** szakaszba kerül. Kattints az **Activate Addon** gombra.

Ha a bővítményt a **Bővítmények** oldalról telepíted, elég aktiválni. Az aktivált kiegészítő kártyáján megjelenik a **Deactivate Addon** gomb.

## 2. A Stripe API-kulcsok megszerzése

1. Hozz létre egy fiókot a Stripe oldalán, vagy lépj be a meglévőbe.
2. Új fióknál a Stripe e-mailben megerősítő linket küld. Kattints rá, így a Stripe vezérlőpultjára (dashboard) jutsz.
3. Először teszt környezetben dolgozz: a bal felső sarokban a **Sandbox** felirat látszik, a jobb felsőben pedig a **Switch to live account** gomb. Ha éles fiókban vagy, a jobb felső **Viewing test data** gombbal válts Sandbox módra.
4. A vezérlőpulton (**Developers → API keys**) találod az API-kulcsokat. A **Secret key** (titkos kulcs) mindenképp kell, a **Publishable key** (nyilvános kulcs) pedig a kiegészítő mezőibe kerül.

Éles használatra átváltás után az éles fiók kulcsait add meg ugyanígy.

## 3. Globális beállítások

1. Menj ide: **JetFormBuilder → Settings → Payments Gateways**.
2. Kapcsold be az **Enable Gateways** kapcsolót.
3. Nyisd le a **Stripe Gateway API** szakaszt.
4. Írd be a **Public Key** és a **Secret Key** mezőbe a Stripe-ból kimásolt kulcsokat.
5. Kattints a **Save** gombra.

![A JetFormBuilder Settings oldal Payments Gateways fülje, megnyitott Stripe Gateway API szakasszal](./kepek/beallitasok-stripe.webp)

*A JetFormBuilder Settings oldal Payments Gateways fülje, megnyitott Stripe Gateway API szakasszal* (https://minta-bolt.hu/wp-admin/edit.php?post_type=jet-form-builder&page=jfb-settings)

A kép a bekapcsolt **Enable Gateways** kapcsolót és a kulcsmezőket mutatja. Az **Enable Test Mode** kapcsoló csak a PayPal átjáróra hat, a Stripe tesztelése a Stripe saját Sandbox kulcsaival megy.

| Beállítás | Mit csinál |
|---|---|
| **Enable Gateways** | Bekapcsolja a fizetési átjárókat az űrlapokhoz. |
| **Public Key** | A Stripe nyilvános (Publishable) kulcsa, az összes űrlapra érvényes. |
| **Secret Key** | A Stripe titkos kulcsa, az összes űrlapra érvényes. |

## 4. Az űrlap beállítása

1. Nyisd meg az űrlapot a **JetFormBuilder → Forms** listából.
2. A jobb oldali **JetForm** fülön nyisd le a **Gateways Settings** szakaszt.
3. Válaszd a **Stripe Checkout** lehetőséget, és kattints a mellette megjelenő **Edit** gombra.

![Az űrlapszerkesztő JetForm oldalsávja, a Gateways Settings szakaszban kiválasztott Stripe Checkouttal](./kepek/urlap-atjaro-panel.webp)

*Az űrlapszerkesztő JetForm oldalsávja, a Gateways Settings szakaszban kiválasztott Stripe Checkouttal* (https://minta-bolt.hu/wp-admin/post.php?post=4&action=edit)

A kép a **Gateways Settings** szakaszt mutatja három lehetőséggel: **None**, **PayPal Checkout** és **Stripe Checkout**, utóbbi mellett az **Edit** gombbal.

Az **Edit Stripe Checkout Settings** ablak mezői:

| Beállítás | Mit csinál |
|---|---|
| **Use Global Settings** | Bekapcsolva a **Settings → Payments Gateways** oldalon megadott kulcsokat használja. Kikapcsolva az űrlaphoz külön kulcsokat adhatsz meg. |
| **PUBLIC KEY** | A Stripe Publishable kulcsa (csak kikapcsolt globális beállításnál). |
| **SECRET KEY** | A Stripe Secret kulcsa (csak kikapcsolt globális beállításnál). |
| **GATEWAY ACTION** | A fizetési forgatókönyv: **Pay Now** (egyszeri fizetés) vagy **Előfizetés**. |
| **FIZETÉSI MÓDOK** | **Auto**: a Stripe kínálja a módokat. **Select Manually**: te jelölöd ki a módszereket. |
| **ENGEDÉLYEZETT MÓDSZEREK** | A kézi választásnál bepipálható fizetési módszerek (például **card**, **link**, **paypal**, **klarna**). |
| **REQUEST BUTTON** | A **Sync Access Token** gomb: ellenőrzi a kulcsokat a Stripe-nál. |

![Az Edit Stripe Checkout Settings ablak Pay Now beállítással](./kepek/stripe-ablak-fizetes.webp)

*Az Edit Stripe Checkout Settings ablak Pay Now beállítással* (https://minta-bolt.hu/wp-admin/post.php?post=4&action=edit)

A kép az ablakot **Pay Now** műveletnél mutatja: fent a kulcsmezők, lent a fizetési módok listája.

### A Sync Access Token gomb

1. Add meg a kulcsokat (vagy kapcsold be a **Use Global Settings** kapcsolót).
2. Kattints a **Sync Access Token** gombra.
3. Sikeres ellenőrzés után az **Access Token updated** üzenet jelenik meg, és az ablak újabb mezőkkel bővül:

| Beállítás | Mit csinál |
|---|---|
| **CURRENCY CODE** | Háromjegyű pénznemkód (például `HUF`, `EUR`, `USD`). A Stripe által támogatott kódokat használd. |
| **PRICE/AMOUNT FIELD** | Az űrlap mezője, amelynek értéke a fizetendő összeg. |
| **PAYMENT SUCCESS MESSAGE** | Az üzenet, amelyet a látogató sikeres fizetés után lát. |
| **PAYMENT FAILED MESSAGE** | Az üzenet sikertelen fizetés esetén. |

Hibás kulcsnál a Stripe hibaüzenete jelenik meg az ablakban (például **Invalid API Key provided**), és a további mezők nem nyílnak meg.

4. Kattints az **Update** gombra az ablak mentéséhez.

### Az összegmező

Az összegmező típusa lehet **Calculated** vagy **Hidden** mező, az értéke pedig csak számjegy legyen. Így a fizetendő összeg számolható az űrlapon, vagy rögzített lehet. A **Secure payment amount** kapcsoló miatt a rejtett mezőnél a **Render in HTML** legyen kikapcsolva, lásd [Fizetési átjárók beállítása](https://hub.hellowp.io/hu/plugins/jet-form-builder-stripe-gateway/elso-lepesek-fizetesi-atjarok/).

A Stripe által támogatott pénznemkódokat használd a **CURRENCY CODE** mezőben.