> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe

> Fogadj el fizetéseket a Macaly-projektedben

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.

<Callout icon="user">
  Elérhető a [**Pro és az Ügynökségi csomagban**](/docs/hu/welcome/pricing)
</Callout>

## 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:

```
Online szeretném árusítani a bőrápolási termékeimet. Kell egy webshop
katalógussal és pénztárral, hogy a vásárlók kártyával fizethessenek.
```

```
Írtam egy e-könyvet, és $19 áron szeretném eladni. Készíts egy oldalt,
ahol az emberek fizethetnek, és azonnal letölthetik.
```

```
Havi online jógaórát indítok $29/hó áron. Építs egy landing oldalt,
ahol a tagok feliratkozhatnak, és elindíthatják az előfizetésüket.
```

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:

| Mező | Érték |
| - | - |
| Kártyaszám | 4242 4242 4242 4242 |
| Lejárat | Bármely jövőbeli dátum (pl. 01/30) |
| CVC | Bármely 3 számjegy (pl. 111) |
| Irányítószám | Bármilyen érték (pl. 11000) |

Nyisd meg a projektedet, hajts végre egy tesztvásárlást, és ellenőrizd a fizetési élményt.

<Tip>
  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](https://docs.stripe.com/testing#declined-payments) találod.
</Tip>

## 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.

<iframe src="https://www.youtube.com/embed/SVcTB6UZlIc" />

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.

    <Info>
      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.
    </Info>
  </Step>
</Steps>

## 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.

<Warning>
  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.
</Warning>

### 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.

<Steps>
  <Step title="Nyisd meg a Stripe Dashboardot">
    Menj a [dashboard.stripe.com](https://dashboard.stripe.com) oldalra, és jelentkezz be abba a fiókba, amellyel a sandboxot igényelted.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Info>
  Amíg a Stripe ellenőrzi a fiókodat, Teszt módban továbbra is építheted és tesztelheted a projektedet.
</Info>

### Add meg az éles API-kulcsaidat

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

<Steps>
  <Step title="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.

    <Warning>
      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.
    </Warning>
  </Step>

  <Step title="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_`).
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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

<AccordionGroup>
  <Accordion title="Mi az a sandbox, és miben különbözik a Stripe-fiókomtól?">
    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.
  </Accordion>

  <Accordion title="A tesztfizetések nem mennek át">
    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.
  </Accordion>

  <Accordion title="Mi a különbség a Teszt mód és az Éles mód között?">
    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.
  </Accordion>

  <Accordion title="Nem találom az éles API-kulcsokat a Stripe Dashboardon">
    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.
  </Accordion>

  <Accordion title="A Macaly még mindig Teszt módot mutat, miután ellenőriztem a Stripe-fiókomat">
    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.
  </Accordion>

  <Accordion title="Az éles fizetések nem mennek át">
    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.
  </Accordion>

  <Accordion title="Mi történik, amikor a sandboxom lejár?">
    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.
  </Accordion>
</AccordionGroup>

## 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](https://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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.