Skip to main content
A Macaly Stripe-integrációjával egyszeri és ismétlődő fizetéseket (előfizetéseket) fogadhatsz el közvetlenül a projektedben. A teljesen működő tesztkörnyezet automatikusan létrejön, így Stripe-fiók nélkül is elkezdhetsz építeni és tesztelni. Ha készen állsz az élesítésre, csatlakoztasd a Stripe-fiókodat, és válts Éles módra.
Elérhető a Pro és az Ügynökségi csomagban

​
Fizetések hozzáadása a projektedhez

Írd le az ügynöknek a beszélgetésben, milyen fizetési megoldásra van szükséged. Például:
Az ügynök létrehozza a projektedet egy teljes fizetési folyamattal, és a háttérben beállít egy Stripe-tesztkörnyezetet. Fizetések hozzáadásához a felső navigációs sáv Fizetések füléről is indulhatsz. Azonnal elkezdheted a tesztelést a Fizetések fülön megjelenített tesztkártyával: Nyisd meg a projektedet, hajts végre egy tesztvásárlást, és ellenőrizd a fizetési élményt.
A hibaforgatókönyveket, például az elutasított kártyákat vagy az érvénytelen fizetési adatokat is tesztelheted a Stripe erre szolgáló tesztkártyáival. A tesztkártyaszámok és az általuk szimulált hibák teljes listáját a Stripe tesztelési dokumentációjában találod.

​
A biztonságos tesztelési környezet aktiválása

Amikor a Macaly létrehozza a tesztkörnyezetedet, egy Stripe-sandboxot hoz létre. A sandbox azonnal működik, és lehetővé teszi a fizetések tesztelését, de nincs összekapcsolva egyetlen Stripe-fiókkal sem. Az igénylés nélküli sandboxok 60 nap után lejárnak. A sandbox igénylésével összekapcsolod a Stripe-fiókoddal. Az igénylés után a sandbox a tiéd marad, és közvetlenül a Stripe Dashboardon kezelheted. A sandboxot kétféleképpen igényelheted: a projekted Fizetések fülén, vagy abban az e-mailben, amelyet a Stripe a tesztkörnyezet létrehozása után küld neked. Az igénylés egyben az első lépés a valódi fizetések elfogadása felé. Az élesítéshez igényelned kell a sandboxot, meg kell erősítened a vállalkozásodat a Stripe-nál, és meg kell adnod az éles API-kulcsaidat.
1

Nyisd meg a Fizetések fület

Nyisd meg a projekted Fizetések fülét. Az “Aktiváld a biztonságos tesztelési környezetedet” cím alatt egy Stripe sandbox igénylése gombot látsz.
2

Kattints a Stripe sandbox igénylése gombra

A Stripe új lapon megnyitja a Claim your sandbox oldalt.Ha már van Stripe-fiókod, válaszd ki a listából. Ha nincs, kattints a + Create new account gombra, és hozz létre egyet ingyen.A folytatáshoz kattints a Continue gombra.
3

Add meg a vállalkozásod adatait

A Stripe néhány alapvető információt kér:
  1. Business name and location. Add meg a vállalkozásod nevét, és válaszd ki az országodat. Kattints a Continue gombra.
  2. Business website and description. Add meg az oldalad URL-jét, és röviden írd le a termékeidet vagy szolgáltatásaidat. Ezt a lépést kihagyhatod a Skip gombra kattintva.
  3. Intended use of Stripe. Válaszd ki a vállalkozásodhoz illő fizetési típusokat (pl. egyszeri vagy ismétlődő fizetések). Ezt a lépést szintén kihagyhatod.
4

Fejezd be a sandbox beállítását

Az utolsó képernyőn a Stripe összefoglalja a következő lépéseket: a beállítás befejezése, váltás éles módra és a fizetések elfogadásának megkezdése. A befejezéshez kattints a Go to sandbox gombra.
5

Térj vissza a Macalyhoz

Navigálj vissza a Macalyhoz. A Fizetések fülön ekkor narancssárga színnel a következő felirat jelenik meg: A fizetések Teszt módban vannak. Ez megerősíti, hogy az igénylés sikeres volt.
Az állapotfrissítések szinkronizálása eltarthat egy ideig. Ha az igénylés gombja még mindig látható, frissítsd az oldalt.

​
Váltás Éles módra

Amikor készen állsz a valódi fizetések elfogadására, aktiválnod kell a Stripe-fiókodat, és csatlakoztatnod kell az éles API-kulcsaidat a Macalyhoz.
A projekted által elfogadott fizetésekkel kapcsolatos összes jogi és adózási kötelezettség a te felelősséged. Ha bizonytalan vagy a kötelezettségeidben, kérj tanácsot adótanácsadótól.

​
Aktiváld a Stripe-fiókodat

Mielőtt hozzáférnél az éles API-kulcsokhoz, a Stripe megköveteli a vállalkozásod megerősítését. Ez egy szokásos beüzemelési folyamat, amely teljes egészében a Stripe oldalán zajlik.
1

Nyisd meg a Stripe Dashboardot

Menj a dashboard.stripe.com oldalra, és jelentkezz be abba a fiókba, amellyel a sandboxot igényelted.
2

Végezd el a beállítási útmutatót

A Stripe felszólít a fiókbeállítás befejezésére. Ez általában a következőket tartalmazza:
  • Vállalkozási adatok (hivatalos név, cím, a vállalkozás típusa)
  • Személyazonosság-ellenőrzés
  • Bankszámla vagy kifizetési adatok a pénz fogadásához
Kövesd a Stripe beállítási útmutatóját, amíg minden lépés késznek nem lesz jelölve.
3

Várd meg az ellenőrzést

A Stripe átnézi az adataidat, és aktiválja a fiókodat. Ez általában azonnal megtörténik, de az országodtól és a vállalkozásod típusától függően akár néhány napig is eltarthat.Az ellenőrzés után a fiókod éles, és az éles API-kulcsaid elérhetővé válnak a Dashboardon.
Amíg a Stripe ellenőrzi a fiókodat, Teszt módban továbbra is építheted és tesztelheted a projektedet.

​
Add meg az éles API-kulcsaidat

Amint a Stripe-fiókodat ellenőrizték, másold át az éles kulcsaidat a Macalyba.
1

Másold ki a kulcsaidat a Stripe Dashboardról

A Stripe Dashboardon az API-kulcsaid a kezdőoldal jobb oldalán található API keys kártyán jelennek meg. Megtalálod őket az oldalsáv alján a Developers → API keys alatt is.Két kulcsot fogsz látni:
  • A Publishable key pk_live_ előtaggal kezdődik.
  • A Secret key sk_live_ előtaggal kezdődik.
Másold ki mindkét kulcsot.
A titkos kulcsod teljes hozzáférést ad a Stripe-fiókodhoz. Soha ne oszd meg, és ne illeszd be a beszélgetésbe.
2

Add meg a kulcsaidat a Macalyban

A Fizetések fülön kattints a Stripe-kapcsolat hozzáadása gombra. Illeszd be az egyes kulcsokat a megfelelő mezőbe, és kattints az API-kulcsok mentése gombra. Ügyelj rá, hogy az éles kulcsaidat használd (amelyek pk_live_ és sk_live_ előtaggal kezdődnek), ne a tesztkulcsokat (pk_test_ és sk_test_).
3

Válts Éles módra

Kattints a Váltás Éles módra gombra. A Macaly úgy állítja be újra a projektedet, hogy az éles Stripe-fiókodat használja. Az állapot zöld színnel A fizetések Éles módban vannak feliratra változik.
4

Tedd közzé a projektedet

Tedd közzé a projektedet a módosítások életbe léptetéséhez. Az éles fizetések csak a közzétett oldalon kerülnek feldolgozásra, az előnézetben nem.

​
Az integráció kezelése

Az összes fizetési beállítás a Fizetések fülön érhető el:
  • A Stripe megnyitása megnyitja a Stripe Dashboardot, ahol áttekintheted a tranzakciókat, visszatérítéseket indíthatsz, és követheted a kifizetéseket.
  • A Váltás Éles módra / Váltás Teszt módra lehetővé teszi, hogy bármikor váltogass a környezetek között a projekted kódját érintő módosítás nélkül.
  • A Stripe-kapcsolat kezelése lehetővé teszi az éles API-kulcsaid frissítését a kezdeti beállítás után.
  • A Tesztfizetések megjeleníti a tesztkártya adatait tájékoztatásul, amíg Teszt módban vagy.

​
Hibaelhárítás

A sandbox egy ideiglenes tesztkörnyezet, amelyet a Macaly hoz létre neked. Saját teszt API-kulcsokkal rendelkezik, és lehetővé teszi a fizetések szimulálását valódi pénz érintése nélkül. Nem a te Stripe-fiókod. Amikor igényled a sandboxot, összekapcsolod a tényleges Stripe-fiókoddal. Amíg nem igényled, a sandbox anonim, és 60 nap után lejár.
Győződj meg róla, hogy a 4242 4242 4242 4242 tesztkártyaszámot használod bármely jövőbeli lejárati dátummal, bármely 3 számjegyű CVC-vel és bármilyen irányítószámmal. Ha a probléma továbbra is fennáll, nézd át a beszélgetést a hiba részleteiért, vagy kérd meg az ügynököt, hogy diagnosztizálja a fizetési folyamatot.
A Teszt mód a sandbox-környezetet használja tesztkulcsokkal. Minden fizetés szimulált, és nem érint valódi pénzt. Az Éles mód az ellenőrzött Stripe-fiókodat használja éles kulcsokkal. Valódi pénz kerül terhelésre, és a bankszámládra érkezik. A módok között bármikor válthatsz a Fizetések fülön. A módváltás nem érinti a projekted kódját, csak azt, hogy mely Stripe-kulcsok aktívak.
A sandbox igénylése és a Stripe-fiókod ellenőrzése két külön lépés. Az igénylés összekapcsolja a sandboxot a fiókoddal, de az éles kulcsok létrejötte előtt még be kell fejezned a Stripe vállalkozás-ellenőrzését (személyazonosság, vállalkozási adatok, bankszámla). Nyisd meg a Stripe Dashboardot, és kövesd a beállítási útmutatót az ellenőrzés befejezéséhez. Ha csak tesztkulcsokat látsz (amelyek pk_test_ és sk_test_ előtaggal kezdődnek), a fiókodat még nem ellenőrizték teljesen.
A Stripe-fiók ellenőrzése nem kapcsolja át automatikusan a Macalyt Éles módra. Manuálisan meg kell adnod az éles API-kulcsaidat a Fizetések fülön, majd rá kell kattintanod a Váltás Éles módra gombra. A Macaly addig Teszt módban tart, amíg kifejezetten át nem váltasz.
Ellenőrizz három dolgot sorrendben:
  1. Közzétetted a projektedet? Az éles fizetések csak a közzétett oldalon kerülnek feldolgozásra, az előnézetben nem.
  2. Helyesek a kulcsaid? Ellenőrizd, hogy a Publishable key (amely pk_live_ előtaggal kezdődik) és a Secret key (amely sk_live_ előtaggal kezdődik) kulcsot adtad meg. Ha véletlenül tesztkulcsokat illesztettél be, kattints a Stripe-kapcsolat kezelése gombra, és frissítsd őket.
  3. Teljesen ellenőrizték a Stripe-fiókodat? Nyisd meg a Stripe Dashboardot, és nézd meg, vannak-e függőben lévő lépések a beállítási útmutatóban. A Stripe további dokumentumokat kérhet, mielőtt feldolgozza az éles fizetéseket.
Az igénylés nélküli sandboxok 60 nap után lejárnak. Nyisd meg a Fizetések fület, és kattints az Új sandbox beállítása gombra egy új környezet létrehozásához. A meglévő fizetési kódod változatlan marad. Ha már igényelted és ellenőriztetted a Stripe-fiókodat, az új sandbox létrehozása után újra meg kell adnod az éles kulcsaidat.

​
Jó tudni

  • A Stripe díjai érvényesek. A Macaly nem számít fel további díjat a fizetések után. Minden tranzakcióra a Stripe szokásos feldolgozási díjai vonatkoznak (lásd: stripe.com/pricing).
  • A sandbox lejárata. Az igénylés nélküli tesztkörnyezetek 60 nap után lejárnak. Ha ez megtörténik, nyisd meg a Fizetések fület, és kattints az Új sandbox beállítása gombra egy új létrehozásához.
  • A webhookokat automatikusan kezeljük. A Macaly beállítja és karbantartja az összes webhook-végpontot. A Stripe Dashboardon nincs szükség kézi beállításra.
  • A teszt- és az éles környezet elkülönül. A tesztkörnyezet tranzakciói nem jelennek meg az éles Stripe-fiókodban, és valódi terhelés sem történik.