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

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:

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.

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.