Barion integráció

Mi az a Barion?

A Barion egy magyar online fizetési szolgáltató. A Barion Smart Gateway bankkártyás és Barion-egyenleges fizetést tesz lehetővé a webshopokban és más online szolgáltatásokban. A vásárló a Barion biztonságos fizetőoldalán fizet, a pénz a te Barion-fiókodba érkezik.

Mire használhatod a Suarában?

Ha összekötöd a Bariont, az appod online fizetést fogadhat. Néhány példa:

• Webshop: a kosár tartalmáért a vásárló a Barion fizetőoldalán fizet, majd visszatér az oldaladra.

• Foglalás előleggel: a vendég a foglalás véglegesítése előtt kifizeti az előleget.

• Szolgáltatás- vagy jegyeladás: az app a sikeres fizetés után aktiválja a hozzáférést vagy elküldi a jegyet.

• Visszatérítés: egy lemondott rendelés összegét az app részben vagy egészben visszautalja.

Az AI az alábbi műveleteket használja:

• Fizetés indítása: létrehozza a fizetést (összeg, pénznem, tételek), és visszaad egy fizetőoldal-címet, ahová a vásárlót át kell irányítani.

• Fizetés állapotának lekérdezése: megmutatja, hogy a fizetés sikeres, megszakított, lejárt vagy sikertelen.

• Visszatérítés: egy sikeres fizetés összegét részben vagy egészben visszautalja.

• Fizetési értesítés (callback) feldolgozása: a Barion szerverről szerverre jelzi, ha egy fizetés állapota változott. A Suara ezt automatikusan fogadja.

Teszt és éles környezet

A Barion két külön környezetet kínál, és a kapcsolat mentésekor ki kell választanod, melyiket használod:

• Teszt: a Barion tesztkörnyezete (Sandbox). Itt valódi pénz nélkül kipróbálhatod az egész fizetési folyamatot. A tesztkörnyezethez külön tesztfiók és tesztbolt kell a Barion tesztoldalán (https://test.barion.com), a tesztbolt kulcsa pedig nem működik éles környezetben.

• Éles: valódi fizetések, valódi pénz. Az éles kulcsot az éles Barion-fiókodban (https://secure.barion.com) kapod.

Biztonság

A titkos kulcs (POSKey) titkosítva, a Suara szerverén marad. A generált app sosem látja, és a böngészőbe sem kerül, az app csak egy átlátszatlan kapcsolat-azonosítót lát. Az app a Suara gatewayen keresztül hívja a Bariont, a gateway pedig a háttérben hozzáadja a kulcsot, a fogadó e-mail-címet és a callback-címet. A kapcsolatot a láthatóság beállításával korlátozhatod: Csak én, Csak kiválasztott tagok vagy Az egész munkaterület.

A fizetés sikerességét a Suara nem a vásárló böngészőjének visszatérése alapján állapítja meg, hanem a Barion szervertől kéri le újra a fizetés állapotát. Így egy kitalált visszatérési cím nem „fizet ki” egy rendelést.

Jóváhagyás: mivel pénzmozgásról van szó, a Barion-művelet (fizetés indítása, visszatérítés) a chatben minden alkalommal a jóváhagyásodat kéri. Ehhez a kapcsolathoz nincs „mindig engedélyezem” beállítás. Az állapot-lekérdezés jóváhagyás nélkül fut.

Beállítás lépésről lépésre

1. Szerezd meg a titkos kulcsot a Barionban

1. Jelentkezz be a Barion-fiókodba: éleshez https://secure.barion.com, teszthez https://test.barion.com.

2. Ha még nincs boltod, hozz létre egyet az Üzletek (Shops) menüben.

3. Az Üzletek listában a bolt sorában nyisd meg a Műveletek → Részletek (Actions → Details) oldalt.

4. Másold ki a Titkos kulcs (POSKey) értékét.

5. Jegyezd fel a Barion-fiókod e-mail-címét is. A fizetések ennek a fióknak a nevére érkeznek.

2. Kösd be a Suarában

1. A Suara oldalsávjában nyisd meg az Integrációk oldalt.

2. A Katalógusban keresd meg a Bariont. A Fizetés kategóriában találod, vagy használhatod a keresőt (Integráció keresése…).

3. Kattints a Csatlakoztatás gombra. Megnyílik a „Barion csatlakoztatása” ablak.

4. Töltsd ki a mezőket:

   • Környezet: Teszt vagy Éles. Az alapértelmezett a Teszt. A kulcsnak ahhoz a környezethez kell tartoznia, amelyet kiválasztasz.

   • Titkos kulcs (POSKey): a másolt kulcs. A Kulcs megjelenítése ikonnal ellenőrizhető. A Hol találom? hivatkozás a Barion oldalára visz.

   • Fogadó e-mail cím (Payee): a Barion-fiókod e-mail-címe, a fizetések címzettje.

5. Válaszd ki, ki használhatja a kapcsolatot (Csak én vagy Az egész munkaterület). Ha a teljes munkaterületnek engedélyezed, a Suara figyelmeztet, hogy minden tag használhatja a kapcsolatot a saját projektjeiben. Ennél az integrációnál ez azt jelenti, hogy az ő appjaik is fogadhatnak fizetést a te Barion-fiókodba.

6. Kattints a Mentés és ellenőrzés gombra. A Suara ellenőrzi a kulcsot a Barionnál, és ha érvényes, a kapcsolat Barion · {e-mail-cím} néven megjelenik a Kapcsolataid között.

3. Használd a projektedben

Három módon használhatod a kapcsolatot:

• A chatben kérve: írd le az AI-nak, mit szeretnél, például „A kosár oldalon a Fizetés gombra induljon el a Barion fizetés, sikeres fizetés után pedig a rendelés kerüljön fizetett állapotba.” Ha még nincs kapcsolat, az AI felkínálja a csatlakoztatást.

• Az Integrációk oldalról: a Kapcsolataid között a Barion mellett a Bekötés az appba gombbal kötheted be a kapcsolatot egy projektbe.

• A projekt Kapcsolatok oldaláról: nyisd meg a projekt Kapcsolatok részét, és kattints a Kapcsolat gombra. Ott a Munkaterület kapcsolatai közül választhatsz egy meglévőt, vagy az Új bekötése gombbal újat hozhatsz létre.

A bekötés után az AI a Barion-hívásokat az app szerveroldali (edge function) részében generálja. A kulcs így nem kerül a kódba, és a kapcsolatot szükség esetén a projekt Kapcsolatok oldaláról bármikor leválaszthatod.

4. A fizetési értesítés

A Barion-adminban nem kell callback-címet beállítanod: a Suara minden fizetés indításakor elküldi a sajátját. Ha a Suara Cloud be van kapcsolva, a Suara a sikeres, sikertelen, megszakított vagy lejárt fizetésről értesíti az appodat, így az automatikusan frissítheti a rendelés állapotát.

Kapcsolat kezelése

Az Integrációk → Kapcsolataid alatt a Barion kapcsolatra kattintva elérhető:

• Alapadatok: az elnevezés és a láthatóság módosítása.

• Kulcsok frissítése: új POSKey, környezet vagy fogadó e-mail-cím mentése.

• Kapcsolt projektek: itt látod, mely projektek használják a kapcsolatot.

• Utolsó hívások: itt látod a legutóbbi hívásokat (metódus, útvonal, státusz, időtartam, forrás: alkalmazás vagy chat).

• Leválasztás (Veszélyzóna): megszünteti a kapcsolatot. A hozzá kötött projektek ezután nem tudnak fizetést fogadni.

A státusz lehet Aktív, Hiba vagy Visszavonva. Ha Újracsatlakozás szükséges üzenetet látsz, mentsd újra a kulcsot.

Hibaelhárítás

• „Mentés és ellenőrzés” hibával áll meg: Ellenőrizd, hogy a POSKey helyesen lett kimásolva (szóköz nélkül), és hogy a kiválasztott környezet egyezik a kulccsal. Tesztkulcs csak a Teszt, éles kulcs csak az Éles környezettel működik.

• A fogadó e-mail-cím hibás: A Fogadó e-mail cím a Barion-fiókodhoz tartozó e-mail-cím legyen, és érvényes formátumú.

• A kapcsolat „Hiba” vagy „Visszavonva” státuszú: A kulcs megváltozott vagy érvénytelenné vált. Másold ki újra a Barionból, és mentsd el a Kulcsok frissítése résznél.

• Az app nem indít fizetést: Ellenőrizd, hogy a kapcsolat be van-e kötve a projektbe, és hogy a Suara Cloud be van-e kapcsolva.

• A vásárló visszatért az oldalra, de a rendelés nem lett fizetett: A visszatérés önmagában nem bizonyítja a fizetést. A rendelés állapota a Barion értesítése alapján frissül, ehhez a Suara Cloudnak bekapcsolva kell lennie.

• Teszt fizetés nem megy át: Tesztkörnyezetben a Barion tesztkártyáit vagy tesztfiókját kell használni, valódi kártya nem működik.