Kártyaelfogadás Braintree segítségével

Az alábbi bejegyzés a következő módon épül fel:

• Jelenlegi működés: ha Ön most állítja be a Braintree kártyaelfogadást, ezt a leírást kövesse, és a következő pont szerint később álljon át az új működésre.
  
• Hogyan tud átállni az új működésre: előreláthatólag szeptember 14-éig, de pontos információkat számunkra is csak később fognak biztosítani a bankkártya szolgáltatók.
• Új működés: a bankkártya szolgáltatók által később biztosított végleges dokumentációk alapján itt mutatjuk be az új működést.

Jelenlegi működés

A Braintree fizetési szolgáltató lehetővé teszi megrendelések esetén egyszeri vagy tagsági rendszerek esetén ismétlődő fizetések egyszerű kezelését. Mindezt úgy, hogy a bankkártya adatok közvetlenül a megrendelés űrlapon keresztül kerülnek bekérésre a legszigorúbb biztonsági irányelvek (PCI DSS compliance) betartásával.

Az alábbi leírás a leglényegesebb beállításokat foglalja össze. Esettanulmányt és a beállítást részletesen bemutató videókat az Online Katapult weboldalán talál.

FONTOS: A Braintree fizetési módot nincs lehetőség más Bankkártyás fizetési integrációval együtt használni egy űrlapon. Más fizetési módokkal (átutalás, készpénz) alkalmazható. De bankkártyás fizetési módok közül a Braintree használata esetén nem lehetséges más szolgáltatókat is felvenni. A többi fizetési szolgáltató (PayPal, Simple, Barion) szerepelhet egyszerre egy űrlapon.

Integráció beállítása

Először létre kell hoznia egy Braintree próba fiókot (Braintree Sandbox). A fiók létrehozása után jelentkezzen be. A bejelentkezés utáni oldalon találja az integrációhoz szükséges paramétereket(1), amelyeket a SalesAutopilotban be kell majd állítani. Ezekhez később bármikor hozzáférhet az jobb oldali fogaskerékre, majd API menüpontra(2) kattintva. 

Lépjen be a SalesAutopilot fiókjába, válassza ki azt a Megrendelés listáját  amelyiknél szeretné használni a Braintree fizetési módot, kattintson megrendelés lista Beállítások (1) fülén lévő Integráció (2) opcióra.

Kattintson a Braintree integrációnál lévő szerkesztés ikonra.

Az Environment beállításnál válassza a Sandbox opciót, ha most kezdi az integrációt (ezt majd később át kell állítani Live-ra ha élesben fogja használni). Másolja át a Merhant ID, Public key és Private key adatokat Braintree-ből a megfelelő mezőkbe. A szoftver által jelenleg használt úgynevezett "hosted fields" Braintree integrációnál nem szükséges megadni a CSE key értékét. A Sikertelen terhelés esetén meghívandó adatmódosító űrlap opció arra szolgál, hogy sikertelen terhelés esetén az adott adatmódosító űrlaphoz beállíthat egy műveletet (amely pl. frissít bizonyos adatokat a megrendelőnél) illetve beállíthat hozzá időzítést, amellyel információkat küldhet a megrendelőnek a sikertelen terhelésről és hogy mi a teendője (pl. ellenőrizze a kártya adatait és módosítsa ha szükséges vagy lépjen kapcsolatba Önnel).

FONTOS: Braintree fizetés esetén a Sikertelen terhelés esetén meghívandó adatmódosító űrlap minden sikertelen terhelés esetén lefut. Tehát amennyiben a megrendelő legelső fizetése sikertelen, akkor is meghívásra kerül. Amennyiben az űrlap lefutásához levelet időzít, a két esetet külön szeretné kezelni (első sikertelen terhelés vagy már folyamatban lévő ismétlődő terhelés esetén sikertelen levonás), egy külön feltétel beállításával tudja megtenni. Első rendelés esetén a “Következő esedékes terhelés dátuma” (mssys_next_recur_charge_date) nulla. Tehát az ismétlődő folyamatban felmerülő sikertelen terhelés esetén kiküldött levelekhez egy olyan feltételt kell beállítani, hogy “Következő esedékes terhelés dátuma” nem nulla.

A következő lépés, hogy hozzon létre egy szállítási / fizetési módot (Beállítások / eCommerce / Szállítási és fizetési mód), amelyen bekapcsolja Braintree fizetési módot.

Fontos: A Braintree fizetési módot nincs lehetőség más Bankkártyás fizetési integrációval együtt használni egy űrlapon. Más fizetési módokkal (átutalás, készpénz) alkalmazható. De bankkártyás fizetési módok közül csak a Braintree opciót jelölje be. 

Két lehetősége van: vagy egyszeri kártyás fizetési módot állít be vagy ismétlődő fizetési módot. A Fizetési mód legördülőből válassza ki az ennek megfelelő opciót. Mindkét esetben meg fog jelenni a Braintree opció.

Ismétlődő fizetési mód

Ismétlődő fizetési mód esetén a Braintree felületén létre kell hozni egy Plant. Ez a Braintree felületén a Subscriptions menüben a  Plans opcióra kattintva tudja megtenni. Kattintson a Create a plan gombra. Adjon meg egy Plan ID-t vagy hagyja üresen és a Braintree fogja generálni. Ezt a Plan ID-t kell megadni a SalesAutopilotban a fizetési mód beállításnál. Állítsa be a Plan további paramétereit. Az itt megadott adatok alapján fog történni a terhelés. A Plan ID-t másolja be a SalesAutopilotban a szállítási / fizetési módhoz.

FONTOS: a megrendelő űrlapon szereplő termék ára felülírja a Plannél beállított árat, tehát azzal kerül megterhelésre a megrendelő kártyája. 

Állítsa be a Szállítási / fizetési mód további paramétereit is, majd mentse el.

Ismétlődő fizetési mód esetén a Braintreeben be kell állítani az úgynevezett Webhook URL-t. Ezt az URL-t az integrációs adatok megadásra képernyőn a Braintree beállítások végén találja.

Másolja ki, majd a Braintreeben kattintson a felső menü jobb oldalán a Fogaskerékre, majd válassza az API opciót. Ezután kattintson a Webhooks menüpontban a Create New Webhook gombra.

Másolja be ide a SalesAutopilotból kimásolt URL-t és jelölje be a következő opciókat:

• Charged successfully
• Charged unsuccessfully

Végül kattintson a Save gombra.

Űrlap beállítása

A következő lépés, hogy a szállítási / fizetési módot rendelje egy megrendelő űrlaphoz. Attól függetlenül, hogy egyszeri vagy ismétlődő fizetési módról van-e szó, az űrlap végén meg fognak jelenni a kártyaadatok bekérésére szolgáló mezők. Az űrlapon a fizetési szolgáltatók közül csak a Braintree szerepelhet. Más fizetési módokat (készpénz, átutalás) van lehetősége felvenni, de más szolgáltatókkal (Barion, Simple) egy űrlapon belül nem alkalmazható. 

FONTOS: Braintree fizetés esetén, az űrlapon felvett legszükségesebb mezőket tegyük kötelezően kitöltendő mezővé. Ennek hiányában ugyanis lehetséges lesz minden adat megadása nélkül megrendelést leadni és sikeres fizetést végrehajtani. Ezáltal üres adatlappal rendelkező sikeresen fizetett megrendelések jöhetnek létre.

A kártyaadatok valójában úgynevezett iframe-n kerülnek bekérésre, tehát nem a SalesAutopiloton keresztül kerülnek elküldésre, hanem közvetlenül a Braintreenek amely garantálja a kártyatársaságok felé az úgynevezett PCI DSS megfelelőséget és a kártyaadatok maximális biztonságú kezelését. A kártyaadatok bekérésére szolgáló input mezők az űrlapsablonnál vagy az űrlapnál megadott CSS utasításokkal formázhatók.

Fontos korlátozás: Braintree fizetési mód esetén a megrendelő listáját úgy kell beállítani, hogy egy email címmel többször is lehessen rendelni. Ha egy email címmel csak egyszer adható le rendelés, akkor a Braintree fizetési mód nem fog működni.

Két fontos információs teszteléshez:

1. Amíg Sandbox üzemmódban használja a Braintreet, tehát amíg tesztel, csak a Braintree által megadott teszt kártyaadatokkal tudja kipróbálni a fizetést. A teszt kártyaadatokat ezen a linken találja.
2. Ha a teszt rendelése $2000 és $3000.99 közötti értékű, akkor a Braintree automatikusan elutasítja a kártyát Processor Declined hibaüzenettel. Tehát ha sikeres fizetést szeretne tesztelni, akkor $2000 alatti vagy $3000.99 feletti értékkel teszteljen.

Az űrlap feldolgozása után megjelenik a köszönőoldal, a megrendelő nem kerül átirányításra semmilyen köztes weboldalra.

Hogyan tud majd átállni az új működésre?

A PSD2 erős ügyfélhitelesítésnek megfelelő beállításokat a következőképpen tudja majd elvégezni.

FONTOS! A funkció még nem elérhető, és az alábbi leírás még nem végleges, a Braintree további tájékoztatása alapján megváltozhat, ezért kérem kövesse nyomon a Tudásbázis frissítéseinket. Ehhez kérjük iratkozzon fel "PSD2-SCA" értesítőnkre, így MINDEN változásról azonnal értesíteni fogjuk.

1. Braintree rendszerén belül:

A Braintree tájékoztatása szerint a Braintree-vel kell felvennie a kapcsolatot, és kérnie, hogy a fiókjában kapcsolják be a 3D Security 2.0 funkciót. Erről bővebb információt a Braintree oldalán talál.

2. A Salesautopilot fiókban: 

Ezt követően a SalesAutopilot fiókjában a megrendelés lista "Integrációk" menüpontjában tudja majd bekapcsolni a 3D Security opciót. 

Minden olyan űrlap esetében ahol Braintree integrációt használ, szükséges kötelezően kitöltendő mezőként felvenni az alábbi mezőket:

A mezők felvétele után menjen végig az űrlapvarázsló lépésein, ezzel újragenerálva űrlapját.

FONTOS: Az űrlap varázslón abban az esetben is szükséges végig menni, ha az összes fent említett mező már szerepelt rajta.

Ezt követően iframe-s űrlap beillesztés esetén nincs további teendője, teljes forráskód esetén az űrlap újbóli beillesztése szükséges. 

Miután ezeket a beállításokat elvégezte, az űrlap elküldésekor a PSD2-nek megfelelően, egy kártyaellenőrzés fog a háttérben megtörténni:

• Ha a kártya átmegy csalásellenőrző mechanizmuson, akkor az űrlap beküldésre kerül és a rendelés létrejön a SalesAutopilotban, a kártya megterhelődik és a rendelés fizetettre állítódik.
• Ha a csalásellenőrző úgy dönt, hogy extra azonosítás szükséges, akkor megjelenik egy új réteg, amelyen plusz adatot pl. SMS, jelszót kér. Ez a kártyatársaságtól is függ. 
• Ha a kártya nem felel meg a csalásellenőrzésen, akkor megjelenik a kártyaadatok bevitele alatt egy hibaüzenet és az űrlap beküldése megáll. Ez a hibaüzenet a megrendelés űrlap szerkesztés 2. lépésében személyre szabható. 

FONTOS: Ismétlődő fizetés esetén a 2019. szeptember 14-e előtti tokeneket nem érinti az új működés, ezek a tokenek továbbra is működőképesek maradnak. Tehát működő ismétlődő fizetések esetén nem szükséges a kártyák újra regisztrációja. 

Javaslatok teszteléshez:

1. Hozzon létre egy új megrendelés listát és hozzá egy új megrendelő űrlapot a teszteléshez. 
2. Braintree Sandbox fiókban végezze a tesztet.
3. A linkre kattintva kártyaszámokat talál, amikkel különböző eseteket lehet tesztelni.
4. Csak a teszt elvégzését követően érdemes éles rendszerben aktiválni a beállításokat.

Új működés

Az új működésről akkor tudunk majd végső leírást biztosítani, amikor a bankkártya szolgáltatók dokumentációja végleges lesz. 

Kapcsolódó bejegyzés

Braintree funkciók bemutatása