# Fizetési átjáró az űrlapban (PayPal)

> A Gateway Settings szakasz bekapcsolása, PayPal-alkalmazás létrehozása, Client ID és Secret Key megadása, értesítési sorrend, fizetési üzenetek és a rendeléseket tároló bejegyzéstípus.

A régi űrlapkészítő űrlapjaihoz fizetési átjárót is köthetsz. Jelenleg két átjáró van: az ingyenes PayPal és a fizetős Stripe (a Stripe-hoz külön bővítmény kell).

## Az átjáró beállításainak bekapcsolása

Alapból az űrlapszerkesztőben nem látszik a fizetési átjáró szakasza. Bekapcsolásához add hozzá a gyermektéma `functions.php` fájljához ezt a kódot, majd mentsd el a fájlt:

```php
add_filter( 'jet-engine/forms/allow-gateways', '__return_true' );
```

Ezután minden űrlap szerkesztőjében megjelenik a **Gateway Settings** szakasz, benne a PayPal és a Stripe.

## PayPal Client ID és Secret Key

A beállításhoz regisztrálnod kell egy PayPal-alkalmazást, amely Client ID-t és Secret Key-t ad.

1. Jelentkezz be a PayPal fejlesztői felületére (vagy hozz létre fiókot).
2. Éles űrlaphoz a **My Apps & Credentials** oldalon a **Live** módot válaszd. Próbaüzemhez a **Sandbox** módot használd.
3. Sandbox módban add hozzá a `functions.php` fájlhoz ezt is, különben nem fog működni:

```php
add_filter( 'jet-engine/forms/gateways/paypal/sandbox-mode', '__return_true' );
```

4. Valódi fizetés nélküli próbához hozz létre tesztfiókot: **Sandbox → Accounts → Create Account**, add meg a fiók típusát és az országot, és kattints a **Create** gombra.
5. A **Dashboard → My Apps & Credentials** oldalon kattints a **Create App** gombra. Adj nevet az alkalmazásnak, válaszd ki az üzleti fiókot, és az **App Type** értéke legyen **Merchant** vagy **Platform**.
6. Az alkalmazás oldalán megtalálod a **Client ID** és **Secret Key** értékeket. Másold ki őket.

Éles működéshez a megfelelő (Live vagy Sandbox) API-adatokat és a pénznem kódját (például HUF) kell megadnod.

## A PayPal beállításai az űrlapban

### Értesítési sor

Itt adhatod meg, mikor menjenek e-mail-értesítések az adminnak. Három lehetőség van:

- mielőtt a fizetés elmegy az átjáróhoz,
- ha a fizetés sikeres volt,
- ha a fizetés nem sikerült.

Érdemes csak az egyiket bejelölni, különben ugyanarról többször kapsz értesítést.

A **Price/amount field** listában azt a mezőt választod, amelyből a rendszer az árat vagy darabszámot veszi.

### PayPal-adatok

Másold be a **Client ID** és **Secret Key** értékét, és add meg a **Currency Code** (pénznemkód) mezőben a pénznem kódját.

### Fizetési eredmény üzenetei

A **Payment success message** és **Payment failed message** a fizetés sikere vagy kudarca után az űrlap alatt megjelenő szöveg. Nincs alapértelmezett szöveg, magadnak kell megírnod.

## Előkészület: a rendeléseket tároló bejegyzéstípus

Fizetési átjáróval használt űrlaphoz hozz létre egy egyéni bejegyzéstípust a sikeres rendeléseknek (lásd [Bejegyzéstípus létrehozása](https://hub.hellowp.io/hu/plugins/jet-engine/bejegyzestipusok-bejegyzestipus-letrehozasa/)). Az űrlapnak tartalmaznia kell egy **Insert/Update Post** értesítést, amely az új bejegyzést a Rendelések típusba hozza létre:

1. A **Beküldés utáni műveletek / értesítések beállításai** szakaszban kattints az **Értesítés hozzáadása** gombra, nyisd meg a szerkesztését, és válaszd a **Típus** listából az **Insert/Update Post** értéket.
2. Válaszd ki a **Post Type** és **Post Status** értékét.
3. A **Fields Map** részben rendeld az űrlap mezőit a bejegyzés meta mezőihez, és add meg a **Default Fields** értékeit.
4. Kattints a **Módosítások alkalmazása**, majd a **Frissítés** gombra.

Az értesítések részleteit az [Beküldés utáni műveletek és értesítések](https://hub.hellowp.io/hu/plugins/jet-engine/urlapok-ertesitesek/) fejezetben találod.