# Használat

> Fizetési üzenetek és makrók, előfizetés, tesztelés és gyakorlati tippek a Stripe Gateway használatához.

## Fizetési üzenetek és makrók

A **PAYMENT SUCCESS MESSAGE** és a **PAYMENT FAILED MESSAGE** mezőbe saját szöveget írhatsz, és makrókkal adatokat szúrhatsz bele:

| Makró | Mit ad vissza |
|---|---|
| `%gateway_amount%` | A fizetés összege, ahogy az átjáró visszaadta. |
| `%gateway_status%` | A fizetés állapota, ahogy az átjáró visszaadta. |
| `%field_name%` | Az űrlap egy mezőjének értéke. A `field_name` helyére a mező nevét írd. |

Példa sikeres fizetési üzenetre:

```text
Köszönjük, %name%! A(z) %gateway_amount% összegű fizetésed megérkezett.
```

## Előfizetés

A **GATEWAY ACTION** mezőben az **Előfizetés** választásával havi, éves vagy egyéni időközű, ismétlődő számlázást állíthatsz be. Ilyenkor az ablak két további mezőt kínál:

![Az Edit Stripe Checkout Settings ablak Előfizetés beállítással](./kepek/stripe-ablak-elofizetes.webp)

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

A kép az **Előfizetés** művelet mezőit mutatja: az **ELŐFIZETÉSI CSOMAGHOZ TARTOZÓ MEZŐ** és az **ELŐFIZETÉSI CSOMAG** mezőt a fizetési módok alatt.

| Beállítás | Mit csinál |
|---|---|
| **ELŐFIZETÉSI CSOMAGHOZ TARTOZÓ MEZŐ** | Alapértéke **Manual Input**: a csomagot te adod meg az **ELŐFIZETÉSI CSOMAG** mezőben. Az űrlap egy mezőjét is kiválaszthatod, így a csomagot az űrlap adja (például havi vagy éves díj között választ a látogató). |
| **ELŐFIZETÉSI CSOMAG** | A Stripe-ban létrehozott csomagok közül választhatsz. A lista frissítése a Stripe-ból egy gombbal megy. |

A fizetési módok között előfizetésnél kevesebb módszer választható, mint egyszeri fizetésnél.

Az előfizetés előnyei a gyakorlatban:

- A fizetés és a hozzá tartozó előfizetés egy helyen követhető, a kezdő fizetéssel és az ismétlődő terhelésekkel együtt.
- Az előfizetés állapota (felfüggesztés, lemondás) WordPress és Stripe között szinkronban marad.
- A visszatérítés a WordPressből indítható, és a Stripe automatikusan feldolgozza.

## Tesztelés

1. A Stripe vezérlőpultján kapcsolj **Sandbox** (teszt) módra.
2. A Sandbox kulcsait add meg a **Settings → Payments Gateways** oldalon vagy az űrlap beállítóablakában.
3. Küldd be az űrlapot, és a Stripe teszt bankkártyáival fizess. Valódi terhelés nem történik.
4. Élesítéskor cseréld a kulcsokat az éles fiók kulcsaira.

Az egész fizetési és megújítási forgatókönyv végigpróbálható így, még éles indulás előtt.

## Tippek

- Az átjáró AJAX-os űrlapokkal működik a legjobban. Ha az űrlap **Page reload** beküldési módot használ, a látogató előbb az űrlap oldalára kerül vissza, és csak utána a Stripe fizetőoldalára. AJAX-nál nincs ez az extra átirányítás.
- Többmárkás oldalnál vagy fejlesztői és éles környezet elválasztására használd az űrlaponkénti kulcsokat (a **Use Global Settings** kikapcsolva).
- A fizetés előtti és utáni teendőket (például e-mail küldése) a **Post Submit Actions** feltételeivel állíthatod be.
- Az összegmező csak számot tartalmazhat, mértékegység nélkül.

## Hibaelhárítás

| Jelenség | Teendő |
|---|---|
| A **Sync Access Token** után **Invalid API Key provided** hibát látsz. | Ellenőrizd, hogy a kulcsot teljesen és a megfelelő környezetből (Sandbox vagy éles) másoltad ki. |
| Nem látszik a **CURRENCY CODE** és a **PRICE/AMOUNT FIELD** mező. | Előbb sikeres **Sync Access Token** kell, csak ezután nyílnak meg. |