# Braintree fizetési átjáró

> A Braintree beállítása: kulcsok, előfizetési tervek, webhook, 3D Secure és tesztelés.

A Braintree-átjáróval a tagok közvetlenül a regisztrációs űrlapon fizethetnek bankkártyával. Braintree-fiók kell hozzá. A fiók elbírálása néhány munkanapig is eltarthat.

## Beállítás

1. Ha még nincs Braintree-fiókod, hozz létre egyet a Braintree oldalán.
2. A Braintree vezérlőpultján generálj API-kulcsot.
3. A **Restrict → Settings → Payments** fülön add meg a nyilvános (public) és a titkos (private) kulcsot.
4. Add meg a kereskedői azonosítót (Merchant ID).
5. Add meg a kliensoldali titkosítási kulcsot (Client-Side Encryption, CSE).
6. Ajánlott bekapcsolni a CVV-támogatást a Braintree **Settings → Processing → Fraud Tools → CVV** részén.
7. Mentsd a beállításokat.

A tesztüzemhez kapcsold be a „Use Braintree sandbox to test your transactions” beállítást.

## Előfizetési tervek létrehozása a Braintree-ben

A Braintree minden ismétlődő előfizetési tervet kézzel kér a saját felületén. A tervek ára és időtartama megegyezik a tagsági szintekével.

1. Előbb hozd létre a tagsági szintet a bővítményben.
2. Jegyezd fel a szint azonosítóját: a **Restrict → Membership Levels** listában, ha a szint fölé viszed az egeret, megjelenik az azonosító száma. Például a 7-es azonosítójú szintnél a Braintree-ben a „Plan ID” mezőbe 7-et kell írni.
3. Lépj be a Braintree-fiókodba, és a bal oldalon a **Recurring Billing** alatt kattints a **Plans** pontra.
4. A **New** gombbal hozz létre új tervet.
5. A **Plan ID**, a terv neve, az ár és a számlázási ciklus egyezzen a tagsági szintben megadottakkal.
6. Ha a szinthez ingyenes próbaidőszak tartozik, jelöld be az **Include Trial Period** négyzetet, és töltsd ki a hozzá tartozó mezőket.

Ha később a bővítményben módosítod a szint adatait, a Braintree-ben is át kell írnod.

## A fizetés menete

A vásárló a regisztrációs űrlapon kapja a bankkártya-mezőket. Kitöltés után folyamatjelző látszik. Sikeres terhelés esetén a sikeres oldalra kerül, sikertelen terhelésnél hibaüzenetet kap.

## Webhook

A webhookon keresztül jelzi a Braintree a webhelynek, ha egy előfizetés változik (befizetés, lemondás stb.). Kézzel kell beállítani:

1. A Braintree-ben nyisd meg a **Settings → API → Webhooks** oldalt.
2. Kattints a **Create new webhook** gombra.
3. A **Destination URL** mezőbe a webhelyed főcíme kerüljön, a végén `/?listener=braintree` taggal:

```text
https://sajatoldal.example/?listener=braintree
```

4. A **Subscription** kategóriában jelöld ki az összes értesítést.

Ha sandbox módban használod a Braintree-t, a sandbox-fiókban is be kell állítanod a webhookot.

## 3D Secure 2.0

Az átjáró támogatja a 3D Secure 2.0-t. A Braintree-fiókban be kell kapcsolni: a sandbox-fiókoknál ez magától megvan, az éles fiókhoz a Braintree ügyfélszolgálatától kell kérni. Bekapcsolás után egyes vásárlók a kártya feldolgozása közben hitelesítési ablakot látnak.

## Tesztelés

1. Ha még nincs, regisztrálj sandbox-fiókot a Braintree-nél.
2. A **Restrict → Settings → Payments** fülön add meg a teszt kereskedői azonosítót, a nyilvános és a titkos kulcsot, valamint a sandbox kliensoldali titkosítási kulcsot.
3. Kapcsold be a sandbox módot.
4. Nyisd meg a regisztrációs oldalt kijelentkezve.
5. Add meg a felhasználó adatait (érdemes olyan e-mail-címet használni, amelyhez hozzáférsz).
6. Válassz fizetős tagsági szintet.
7. Válaszd ki, hogy legyen-e automatikus megújítás.
8. Fizetési módnak válaszd a bankkártyát.
9. Kártyaszámnak írd be: `4111111111111111`. További tesztkártyákat a Braintree tesztelési leírásában találsz.
10. Lejáratnak bármilyen jövőbeli dátum jó.
11. Kattints a **Register** gombra.
12. A sikeres oldalra kell érkezned, az új felhasználóval bejelentkezve.
13. A Braintree tranzakciólistájában látszik a tesztfizetés. Ismétlődő fizetésnél az előfizetések listájában is megjelenik.

Az új felhasználó fiókja ekkor teljesen aktív.