# A Stripe kiegészítő beállítása és a fizetés leírásának módosítása

> Mit kell előkészítened, hogyan hozod létre a webhookot élő és teszt módban, hová másold az aláíró titkot, és hogyan változtathatod meg a Stripe-nak küldött fizetési leírást.

A Stripe kiegészítő a beállítások oldalon csatlakozik a Stripe-fiókodhoz, és ugyanitt kell megadnod a webhookot is, amelyen át a Stripe visszaszól az oldaladnak a fizetés eseményeiről.

## Előfeltételek

- Telepített és aktív Gravity Forms és Stripe kiegészítő.
- Beállított SSL-tanúsítvány az oldalon.
- Egy Stripe-fiók.
- Olyan Stripe-belépés, amelynek szerepköre „owner” (tulajdonos) vagy „administrator” (rendszergazda).

## A Stripe beállításainak megnyitása

1. Jelentkezz be a WordPress admin felületére.
2. Kattints az **Űrlapok → Beállítások** menüpontra.
3. Válaszd a **Stripe** fület.

Itt találod a csatlakozást (élő vagy teszt mód), a webhook beállításait és a fizetésgyűjtés módját.

### Mód

A mód mondja meg, melyik Stripe-környezetbe kerülnek az űrlapbeküldések.

| Mód | Mit csinál |
|---|---|
| Élő (Live) | Valódi tranzakciókat indít a Stripe-fiókodban. |
| Teszt (Test) | A beküldés a Stripe tesztkörnyezetébe megy, tényleges terhelés nincs. |

### Webhookok

Az élő környezetben mindenképp be kell állítanod a webhookot, a tesztkörnyezetben pedig akkor, ha használod. A Stripe a fizetések és az előfizetések létrehozása közben ezeken a végpontokon keresztül jelzi az eseményeket az oldaladnak. A kiegészítő által figyelt események körét a `gform_stripe_webhook` szűrő határozza meg, ezzel további eseményekre is feliratkozhatsz.

A beállítások oldalán a **Webhook-útmutató megtekintése** hivatkozás megnyitja a lépéseket, és megmutatja az oldalad végpont-URL-jét. Mellette egy másolás gomb a vágólapra teszi az URL-t.

A végpont-URL az oldalad címéből és a `?callback=gravityformsstripe` toldalékból áll. Ha az oldalad címe `https://www.example.com`, akkor a végpont:

```text
https://www.example.com/?callback=gravityformsstripe
```

A Stripe 6.0-s kiadása előtt a végpont-URL a webhook-útmutató ablakában szerepelt.

Az élő fiók élő aláíró titkot ad (**Live Signing Secret**), a tesztfiók tesztaláíró titkot (**Test Signing Secret**). A kettőt ne keverd össze.

#### Webhook létrehozása élő módban

1. Jelentkezz be a Stripe-fiókod Workbench felületére, a webhookok oldalra, és válaszd az eseménycél létrehozását (**Create an event destination**).
2. Az események forrásánál (**Events from**) maradjon a **Your account**, az API-verziónál válaszd a legfrissebbet.
3. Az eseményeknél jelöld be az összes esemény kiválasztását (**Select all**). A Stripe figyelmeztet, hogy ez növelheti a késleltetést, de a mindent kijelölő beállítást érdemes használni: a Stripe gyakran változtat az eseményein, és egy szűkebb lista idővel megszűnhet működni a kiegészítővel. Ha mégis egyenként választasz, legalább a `gform_stripe_webhook` szűrő leírásában szereplő eseményeknek szerepelniük kell (a lista változhat), és érdemes minden frissítés után tesztkörnyezetben újra kipróbálni.
4. Kattints a **Continue** gombra.
5. A célpont típusánál válaszd a **Webhook endpoint** lehetőséget, majd **Continue**.
6. A hasznos adat stílusáról szóló tájékoztatón is kattints a **Continue** gombra.
7. A **Snapshot payloads** résznél hagyd az alapértelmezett célpontnevet, írd be a végpont-URL-t, majd **Continue**.
8. A **Thin payloads** résznél ugyanígy hagyd az alapnevet, írd be ugyanazt a végpont-URL-t, majd **Continue**.
9. Az összegző lépésben ellenőrizd mindkét célpontot, és kattints az **Add Destination** gombra.
10. A Stripe megmutatja mindkét célponthoz az aláíró titkot. Másold ki a **Snapshot** célpont titkát a vágólap ikonnal, és kattints a **Done** gombra. A Thin célpont titkát a Gravity Forms jelenleg nem használja.
11. Illeszd be a másolt titkot a **Stripe** beállítások **Live Signing Secret** mezőjébe.

#### Webhook létrehozása teszt módban

A folyamat az élővel megegyezik, csak két különbség van: a képernyő tetején a „Test Mode” felirat látszik, és nem kell két hasznosadat-típust beállítani.

1. Nyisd meg a Stripe tesztkörnyezetének Workbench webhook-oldalát, és válaszd az eseménycél létrehozását.
2. Az események forrása legyen **Your account**, az API-verzió a legfrissebb.
3. Az eseményeknél jelöld be az összes kijelölését (a figyelmeztetést itt nyugodtan figyelmen kívül hagyhatod), vagy legalább a fent említett eseményeket.
4. A célpont típusa **Webhook endpoint**, majd **Continue**.
5. A célpont beállításánál add meg a végpont-URL-t, és kattints a **Create Destination** gombra.
6. Az eseménycélok áttekintő oldalán a **Signing secret** alatti szem ikonnal megjelenítheted a titkot, a vágólap ikonnal kimásolhatod.
7. Illeszd be a **Test Signing Secret** mezőbe a Stripe beállításai között.

#### A webhook bekapcsolásának megerősítése

1. Jelöld be az **I have enabled the Gravity Forms webhook URL in my Stripe account** (a Gravity Forms webhook-URL-jét bekapcsoltam a Stripe-fiókomban) négyzetet.
2. Kattints az oldal alján a **Beállítások mentése** gombra.

### Fizetésgyűjtés

Ez a rész a Stripe kiegészítő 2.6-os kiadásától létezik, korábbi kiadásokban nincs a beállítások között.

1. Görgess a **Payment Collection** (fizetésgyűjtés) részhez.
2. Válaszd ki a fizetésgyűjtési módot, vagyis azt, hogyan kéri be az űrlap a fizetési adatokat.

A beállítások mentése után a Stripe-kompatibilis űrlap összeállítása következik.

### Tudnivalók

- Egy Stripe-fiókhoz legfeljebb 16 webhook-végpont tartozhat.
- A Stripe Checkout csak nyilvános oldalon próbálható ki. Ha az oldalad nem nyilvános, a Checkout oldal nem jelenik meg.

## A Stripe-nak küldött fizetési leírás módosítása

Ha meg akarod változtatni azt a leírást, amelyet az űrlap a Stripe-nak küld a fizetéshez, a `gform_stripe_charge_description` szűrőt használd. A kódot tedd a sablonod `functions.php` fájljába, vagy ideálisan egy saját kis bővítménybe.

```php
add_filter( 'gform_stripe_charge_description', 'change_stripe_description', 10, 3 );
function change_stripe_description( $description, $strings, $entry ) {
    return $description . '  Purchased By: ' . rgar( $entry, '1.5' );
}
```

A szűrő megkapja az eredeti leírást (`$description`), a hozzá tartozó szövegeket és a bejegyzést (`$entry`). A példa az eredeti leírás után fűzi hozzá, ki vásárolt, a beküldött mező értéke alapján. Az `1.5` annak a mezőnek (és al-beviteli mezőjének) az azonosítója, amelynek az értékét hozzáfűzöd, a saját űrlapodhoz igazítsd.