Második lépés: Stripe fizetés integrálása a MotiBro-ba V2
A Stripe online fizetési rendszerének integrálásával lehetővé teheted, hogy vendégeid közvetlenül a MotiBro felületén, bankkártyával vásárolják meg bérleteiket és egyéb díjtípusaikat.
Az integráció beállításához szükséged lesz egy Stripe-fiókra, valamint két API-kulcsra, amelyeket a MotiBro rendszerében kell megadnod.
1. Az integráció létrehozásához szükséges Stripe API-kulcsok
A Stripe online fizetési rendszerét API kulcsok használatával lehet integrálni külső rendszerekbe, így a MotiBro-ba is.
Az integrációhoz két kulcsra lesz szükséged:
- Nyilvános kulcs (Publishable key): pk_live_ kezdetű kulcs, amelyet a Stripe automatikusan biztosít.
- Korlátozott jogú titkos kulcs (Restricted key): rk_live_ kezdetű kulcs, amelyet neked kell létrehoznod.
A MotiBro-hoz korlátozott jogú kulcs (Restricted key) használatát javasoljuk, mert ezzel csak a fizetés elindításához szükséges hozzáférést biztosítod, nem pedig teljes hozzáférést a Stripe-fiókodhoz.
1.1. Az API-kulcsok oldalának megnyitása
Lépj be a Stripe-fiókodba, majd nyisd meg az alábbi oldalt:
https://dashboard.stripe.com/apikeys
Az API kulcsokat a bal oldali sarokban, a "Developers" főmenü "API keys" menüpontjában találod:
Fontos! Ellenőrizd, hogy éles (Live) módban vagy, és nem a tesztkörnyezetben (Sandbox). Az éles kulcsok live_, míg a tesztkulcsok test_ jelölést tartalmaznak.
1.2. A korlátozott jogú kulcs létrehozása
A menüpontra történő kattintás után az alábbi oldal jelenik meg:
Az API keys oldalon kattints a Create secret key gombra.
A Stripe ezután megkérdezi, hogy mire szeretnéd használni a kulcsot:
How will you be using this key?
Itt válaszd a Providing this key to a third-party application lehetőséget, majd kattints a Continue gombra.
A következő lépésben add meg az alábbi adatokat:
- Name (Név): Motibro
- URL: https://www.motibro.com
Ezután jelöld be a Customize permissions for this key jelölőnégyzetet, hogy megadhassuk a kulcshoz tartozó jogosultságokat.
1.3. A jogosultságok beállítása
A megjelenő jogosultságlistában keresd meg a Checkout csoportot, azon belül pedig a Checkout Sessions sort.
Ennél az egy jogosultságnál állítsd be a Write értéket.
Minden más jogosultság maradhat None értéken.
Figyelj arra, hogy a Checkout Sessions jogosultsága Write legyen, ne Read, mert a MotiBro-nak írási hozzáférésre van szüksége az online fizetések elindításához.
Miután beállítottad a jogosultságot, kattints a Continue gombra, majd a Create key gombra.
Előfordulhat, hogy a Stripe biztonsági okokból megerősítő kódot kér, amelyet e-mailben vagy SMS-ben küld el. Add meg a kapott kódot a kulcs létrehozásának befejezéséhez.
1.4. A titkos kulcs kimásolása
A kulcs létrehozása után a Stripe megjeleníti az új, rk_live_ kezdetű korlátozott jogú kulcsodat.
Nagyon fontos, hogy a kulcsot azonnal másold ki, mert a Stripe csak egyszer jeleníti meg!
Javasoljuk, hogy a kulcsot megjelenítő ablakot addig ne zárd be, amíg nem adtad meg a MotiBro integrációs beállításainál.
Ha a kulcsot elveszíted, vagy nem másoltad ki időben, újat kell létrehoznod. A feleslegessé vált kulcsot töröld a Stripe felületén.
1.5. A nyilvános kulcs megkeresése
A másik szükséges kulcs a Publishable key, amelyet szintén a Stripe API keys oldalán találsz.
A Standard keys résznél keresd meg a pk_live_ kezdetű kulcsot, majd másold ki.
Ezt a kulcsot a Stripe folyamatosan megjeleníti, így később is bármikor hozzáférhetsz.
Figyelem! Ha korábban a Powering an integration you built lehetőséggel már létrehoztál egy sk_live_ kezdetű titkos kulcsot, azzal is működhet a MotiBro integráció. Ez azonban teljes hozzáférést biztosít a Stripe-fiókodhoz, ezért biztonsági szempontból inkább a rk_live_ kezdetű, korlátozott jogú kulcs használatát javasoljuk.
A titkos kulcsodat soha ne oszd meg illetéktelen személyekkel!
2. MotiBro integráció létrehozása
Anélkül, hogy kilépnél a Stripe fiókodból és bezárnád a titkos kulcsot megjelenítő ablakot, nyisd meg a MotiBro-t, lépj be a menedzseri profilodba és menj a bal oldali menüben az "Beállítások/Integrációk" menüpontra
A betöltődő oldalon keresd meg az "Felfedezés" részt és kattints az Stripe gombra, majd a Beállításra:
A felugró ablakban töltsd ki a szükséges adatokat az alábbiak szerint:
Elnevezés: az elfogadóhelyed tetszőleges neve (ezt csak te fogod látni), a MotiBro-ban ez lesz a neve a létrehozandó online fizetési integrációdnak (javasolt a cég nevét megadni).
Publikus azonosító (Publishable key): Ezt követően menjünk vissza a Stripe oldalára, zárjuk be a felugró ablakot és a "Publishable key" sorban a publikus kulcs (ez a "pk_live_"-el kezdődő) fölé állva másoljuk ki, majd illesszük be a MotiBro rendszerbe visszamenve a Publikus azonosítóhoz (Publishable key).
Titkos azonosító (Secret key): Ebbe a mezőbe az imént létrehozott rk_live_ kezdetű kulcsot írd. Miután az előzőekben a vágólapra másoltuk a Stripe titkos kulcsunkat, már csak be kell illeszteni ebbe a mezőbe. Kattints a mezőre, majd a ctrl + v billentyűkombinációval illeszd be a kulcsot.
A Létrehozás gombra kattintva mentsük el az adatokat. Ezt követően a MotiBro ellenőrzi, hogy létrehozható-e a kapcsolat a Stripe-pal és amennyiben igen, az integráció mentésre és élesítésre is kerül, ha nem volt korábban más integrációd.
Ha már volt aktív fizetési integrációd, jelöld ki a létrehozott Stripe integrációt, válaszd a További műveleteket, majd a Bekapcsolást. Ezt követően a MotiBro ismételten ellenőrzi, hogy az elfogadóhely valóban működik-e és amennyiben igen, élesíti az online fizetési integrációt.
3. Az online értékesíthető díjtípusok kiválasztása és beállítása a MotiBro menedzseri profilban
A MotiBro rendszerben az "Pénzügyek/Árlista" menüpontra. Itt az egyes díjtípusok szerkesztésénél állíthatod be, hogy vendégeid számára lehetővé teszed-e, hogy online vásárolják meg. Választd ki, melyik díjtípust szeretnéd, hogy online értékesíthető legyen, majd kattints az adott díjtípusra sorában a Szerkesztés gombra. Itt az alábbi opciót kell aktiválnod, majd a Módosít gombra kattintva, mentsd a módosítások.
FONTOS! Ahhoz, hogy az online fizetés elinduljon, minimum egy bérletet elérhetővé kell tenned az online vásárlók számára.
4. Online értékesítés opciói
Az online értékesítés esetén az érvényesség kezdő időpontját a vendég állítja be az online vásárlás során. A mendezser eldöntheti és beállíthatja, hogy ebben mekkora szabadsága legyen a vendégeknek.
A “Beállítások/Szervezet/Díjak és fizetés beállításai” menüben az "Online vásárlás érvényességi szabálya" résznél a legördülő menüt megnyitva négyféle lehetőség közül lehet választani:
4.1. Csak első használatkor aktiválódó díjtípus vásárolható
Az első lehetőség esetén a megvásárolt díjtípus kizárólag aktiválódó. Ez azt jelenti, hogy a díjtípus érvényessége az első órán való részvétel napja lesz. Figyelj arra, hogy a díjtípus abban az esetben is aktiválódik, amennyiben a vendég foglal az eseményre, de nem jelenik meg.
4.2. Az érvényesség mindig a vásárlás napján kezdődik
A második lehetőség esetén az online vásárolt díjtípus kezdő érvényességi dátuma automatikusan a vásárlás napja lesz.
Ezt akkor érdemes választani, ha ösztönözni szeretnéd vendégeidet a kifizetett díjtípus minél hamarabbi felhasználására.
4.3. A vendég választhat kezdőnapot, és első használatkor aktiválódó díjtípust is vásárolhat
A harmadik opció beállításakor a vendég akár visszamenőleg dátumozva is tud vásárolni, de azt is választhatja, hogy az első felhasználáskor aktiválódjon a díjtípus érvényessége.
4.4. A vendég választhat kezdőnapot, de első használatkor aktiválódó díjtípust nem vásárolhat
A negyedik lehetőség esetén a vendég beállíthatja az érvényesség kezdetét (akár visszamenőleg dátumozva is), de aktiválódó díjtípust nem tud vásárolni.
Válaszd ezt a beállítást, ha nem szeretnéd, hogy a vendégnek aznap kelljen megvásárolnia a díjtípust, amikor órára megy, ugyanakkor szeretnéd, hogy a konkrét időpont beállításával határozott döntést hozzon az órákon való részvételről.
Fontos megjegyezni, hogy amennyiben a vásárláskor a vendég nem módosítja a dátumot, az érvényesség kezdete automatikusan a vásárlás napja lesz.
Innentől kezdve vendégeid már online is megvehetik díjtípusaikat a személyes MotiBro oldalukra belépve!
Most, hogy elindítottad az online fizetést, szakíts egy kis időt a következő fejezetre is, ahol bemutatjuk, hogy hol tekintheted át a beérkező fizetéseket és hogy hogyan kezdeményezhetsz kifizetést a bankszámládra.