# PayPal és az előfizetések

> A PayPal Standard beállítása, a referencia-tranzakciók (Billing Agreement) és a PayPalban nem lemondott vagy felfüggesztett előfizetések okai.

A PayPal Standard támogatása nagyon korlátozott: ha a hibaelhárítás nem old meg egy jelentett hibát, a PayPal Payments használatára való áttérésre kérhetnek. A WooCommerce 5.5.0 óta a PayPal Standard új telepítéseknél rejtett (a meglévő boltokat ez nem érinti). Mindenkinek, aki még használja vagy fontolgatja a PayPal Standardot, a PayPal Payments bővítményt érdemes használnia: az a teljes körű megoldás (kártyás fizetés, PayPal-pénztár, előfizetések, később fizetés).

## Két PayPal-fizetési mód

A bővítmény beépítetten két PayPal-módot támogat:

- PayPal Standard
- PayPal referencia-tranzakciók (Reference Transactions) az Express Checkouton keresztül

Alapból a PayPal Standardot használja, mert az a legegyszerűbb beállítani. Előfizetéses termékeket azonnal értékesíthetsz vele. Hozzá kell egy PayPal üzleti fiók, helyesen beállított IPN (azonnali fizetési értesítés) és érvényes PayPal API-hitelesítő adatok a WooCommerce-ben. Más beállítás nem kell az ismétlődő fizetések fogadásához.

Ha a bővítmény haladó funkcióit szeretnéd használni (például az előfizetések fel- és lefelé váltását), vagy ki akarod kerülni a PayPal Standard korlátait, a PayPaltól referencia-tranzakciókat kell kérned. Ez nem szabványos termék, a jóváhagyás teljes körű elbíráláson alapul, amely az üzleti modell és a pénzügyek vizsgálatát is jelentheti.

Ha a fiókodat jóváhagyják, a bővítmény magától észleli, hogy a referencia-tranzakciók támogatottak, és átvált erre a módra. Ha a fiókodon nincs engedélyezve, a PayPal Standardot használja tovább az előfizetéses vásárlásokhoz és az ismétlődő fizetésekhez.

## IPN beállítása

A PayPal Standarddal és a referencia-tranzakciókkal is a PayPal IPN-en (azonnali fizetési értesítésen) keresztül követi a bővítmény az ismétlődő fizetéseket és az előfizetések státuszváltozásait. Az IPN beállítását a PayPal Standard fizetési átjáró beállításai között végezheted el.

### IPN és több weboldal

A PayPal egy fiókban nem enged több IPN URL-t, és azt sem, hogy egy alkalmazás (a bővítmény ilyennek számít) weboldalanként más IPN URL-t adjon meg. Emiatt a PayPal Standarddal egy fiókkal csak egy weboldalon értékesíthetsz előfizetést. Ha több oldalon szeretnél, használj PayPal Payments vagy Stripe átjárót, vagy másikat az előfizetéseket támogatók közül (lásd [Fizetési átjárók](https://hub.hellowp.io/hu/plugins/woocommerce-subscriptions/elso-lepesek-fizetesi-atjarok/)).

Ha karbantartási mód bővítmény aktív, a PayPal IPN nem biztos, hogy működik: sok ilyen bővítmény minden látogatót, így a PayPal IPN-üzenetét is átirányítja. Kapcsold ki a bővítményt, hogy az IPN működjön.

## API-hitelesítő adatok

Az előfizetések lemondásához és felfüggesztéséhez a bővítménynek kommunikálnia kell a PayPallal az API-n keresztül. A PayPal kétféle API-hitelesítést ad: API-tanúsítványt és API-aláírást. **API-aláírást** kell használnod, a tanúsítvány nem működik.

1. Jelentkezz be a PayPal üzleti fiókodba, és nyisd meg a fiókbeállítások hozzáférési részét (**Account Settings → Account access**).
2. Az **API Access** résznél válaszd a frissítést.
3. Az **NVP/SOAP API integration (Classic)** résznél válaszd az API-hitelesítők kezelését.
4. Írd be az API-felhasználónevet, a jelszót és az aláírást a PayPal-beállítások API-hitelesítők részébe a WooCommerce-ben.
5. Mentsd a változtatásokat.

A mentés után az előfizetést le tudod mondani vagy fel tudod függeszteni az előfizetések kezelő oldalán (lásd [Meglévő előfizetés szerkesztése](https://hub.hellowp.io/hu/plugins/woocommerce-subscriptions/webaruhaz-kezeles-elofizetes-szerkesztese/)).

## Tesztelés a PayPal sandboxban

Ha a PayPal oldalára érve ezt a hibaüzenetet kapod: „The link you have used to enter the PayPal system is invalid. Please review the link and try again”, valószínűleg az éles PayPal-környezet e-mail-címét használod a sandbox helyett.

1. Keresd meg egy PayPal sandbox-fiók adatait a PayPal fejlesztői oldalán.
2. Nyisd meg a **WooCommerce → Beállítások → Fizetési módok → PayPal** oldalt.
3. Írd át a **PayPal-e-mail-címet** a sandbox-fiók e-mail-címére.

Ha az áruházad olyan pénznemet használ, amelyet a sandbox-fiók alapból nem fogad el, a PayPal-tranzakciók függőben lesznek, a rendelés nem teljesül, és az előfizetés nem aktiválódik, amíg a fizetést el nem fogadod. Az elfogadás:

1. Nyisd meg a sandbox.paypal.com oldalt.
2. Jelentkezz be az áruházban használt sandbox-fiókba (nem az éles PayPal-fiókodba).
3. Kattints az elfogadásra (**Accept**).
4. Válaszd azt a lehetőséget, amellyel elfogadod a fizetést, és egyenleget hozol létre ebben a pénznemben.

## Referencia-tranzakciók: gyakori kérdések

A bővítmény beépítetten támogatja a PayPal referencia-tranzakciókat a PayPal Payments bővítménnyel, ha a tárolt fizetési mód (vaulting) be van kapcsolva. A referencia-tranzakció olyan kiegészítő funkció, amellyel a PayPal-vásárlók további fizetéseit automatikusan megkapod anélkül, hogy a vásárlónak jóvá kellene hagynia a tranzakciót. Referencia-tranzakció kell ahhoz, hogy a vásárlót számlázási megállapodással (Billing Agreement) terhelhesd, beleértve a PayPal-fiókokat a tárolóban, akkor is, ha a vásárló nincs az oldalon.

### Hogyan kérheted a referencia-tranzakciókat?

Hívd fel a helyi PayPal-ügyfélszolgálatot. Jelentkezz be a PayPal-fiókodba, és ott megtalálod a tárcsázási útmutatót. Mondd meg, hogy kifejezetten a referencia-tranzakciók engedélyezése miatt hívsz, hogy egy PayPal-szakértő be tudja kapcsolni a fiókodon. Megpróbálhatnak ismétlődő fizetést gombbal beállítani, de az nem az, amit akarsz. Kérd az átkapcsolást egy szakértőhöz, aki elkéri a PayPal-fiókod adatait (e-mail-cím), és azt mondja, hogy jegyet nyitott. A jóváhagyásról e-mailben értesítenek.

### Milyen feltételei vannak?

A PayPal nem publikálja a feltételeket, és a boltvezetők tapasztalatai szerint üzletenként eltérőek lehetnek. Amit a boltvezetők említettek:

- magas személyes hitelminősítés (FICO) az amerikai PayPal üzleti fiókoknál,
- üzleti terv,
- átlagos tranzakcióérték,
- visszatérő vásárlók száma,
- referencia-tranzakciók száma vásárlónként,
- bevételi előrejelzés és/vagy a referencia-tranzakciókból várt teljes forgalom,
- világos üzleti indok a kéréshez,
- a feliratkozási folyamat bemutatása a referencia-tranzakciókhoz,
- bizonyíték arra, hogy világos feltételeket mutatsz a vásárlóknak a referencia-tranzakciókról és a lemondás módjáról,
- írásos nyilatkozat arról, miért van szükséged referencia-tranzakciókra, és hogyan használod őket.

Jelentések szerint az Egyesült Királyságban működő PayPal-fiókoknál havi 6000 font vagy annál nagyobb előrejelzett bevétel lehet a minimum.

### Mit tud a PayPal Payments referencia-tranzakció nélkül?

A PayPal Payments referencia-tranzakciók nélkül is el tud menteni fizetési módot a PayPal tárolóban (Vault). Így a vásárlók a WordPress-fiókjukba bejelentkezve egy kattintással, kézzel hagyhatják jóvá a megújítási fizetést.

A PayPal Payments emellett a PayPal Subscriptions lehetőséget is kínálja, amellyel minden PayPal-kereskedő használhat automatikus megújítási fizetéseket: az előfizetéses WooCommerce-termékeket a PayPal fix ütemezéssel és fix összeggel kezelt ismétlődő fizetéséhez lehet kötni.

### Miben más a PayPal Standard és a referencia-tranzakció?

A PayPal Standard az előfizetések PayPal-ban való megvalósításának régi módját használja: az előfizetést a PayPalnál hozzák létre, és tükrözik a WooCommerce-ben. A számlázási időközt, az összeget stb. a PayPal platformja határozza meg, és a bővítményen keresztül nem módosíthatók.

A számlázási megállapodás (Billing Agreement) rugalmas fizetési felhatalmazás jövőbeli fizetésekre. A PayPal Payments a tárolt fizetési móddal (vaulting) számlázási megállapodást hoz létre. Ha a referencia-tranzakciók be vannak kapcsolva, a kereskedő a tárolt fizetési móddal akkor is terhelheti a vásárlót, ha az nincs az oldalon. A referencia-tranzakciók lehetővé teszik az automatikus megújítási fizetést és azt, hogy az előfizetést teljesen a bővítmény vezérelje.

### A meglévő PayPal Standard előfizetések átállnak?

Nem. A meglévő PayPal Standard előfizetések addig újulnak meg, amíg le nem mondják őket. A referencia-tranzakciókat csak azok az előfizetések használják, amelyeket a funkció PayPal-fiókon való bekapcsolása után vásároltak. A haladó előfizetés-kezelési funkciók (például az ismétlődő összeg módosítása) ezért csak az újonnan vásárolt előfizetéseknél érhetők el, a meglévő PayPal-előfizetéseknél nem.

A meglévő PayPal-előfizetések átállításának egyetlen módja, hogy lemondod a régit, és a vásárlók a fizetési módjuk megváltoztatásával újra feliratkoznak a PayPal Payments bővítménnyel.

### Miért marad aktív a számlázási megállapodás a PayPalnál?

Ha egy régi PayPal Standard előfizetést lemondanak vagy felfüggesztenek a boltban, az előfizetés státusza a PayPalnál is megváltozik. Ha viszont egy referencia-tranzakcióval létrehozott előfizetést mondanak le vagy függesztenek fel a boltban, a hozzá tartozó számlázási megállapodás a PayPalnál nem változik, aktív marad. Ez normális, mert a számlázási megállapodások alapvetően mások, mint a PayPal-előfizetések.

A PayPal Standard előfizetést fel kell függeszteni vagy le kell mondani, mert különben a jövőbeli fizetések továbbra is feldolgozódnának rajta. Számlázási megállapodásnál ez nincs így: a boltban lemondott előfizetésre a bővítmény nem kér több fizetést, így a megállapodásra sem terhelődik semmi.

A megállapodás azért marad aktív, mert:

- A számlázási megállapodások boltonként léteznek, nem előfizetésenként. Ha a vásárló több előfizetést vett a boltban, mindegyik ugyanazt a megállapodás-azonosítót használja. Ha az egyik lemondásával a megállapodás is megszűnne, a többi előfizetés sem tudna folytatódni.
- A számlázási megállapodás kézzel hozzáadható egy kézzel létrehozott előfizetéshez, vagy akár egy lemondott előfizetés lemondásának visszavonásához is használható (PayPal Standard előfizetésnél ez lehetetlen), de csak ha a megállapodás aktív a PayPalnál.

Ezért nem javasolt a számlázási megállapodásokat kézzel lemondani a PayPalnál. Ha a vásárló maga mondja le a megállapodást a PayPalnál, a bővítmény ezt kezeli, és lemond minden előfizetést a boltban, amely azt a megállapodást használja. A legnagyobb rugalmasság érdekében azonban nem ajánlott lemondani.

### Fizethet a vásárló PayPal-fiók nélkül?

Nem, a PayPal referencia-tranzakcióknál nem ad lehetőséget PayPal-fiók nélküli fizetésre. Ha erre szükség van, a PayPal kártyás fizetése (hosted fields) elmenthet egy bank- vagy hitelkártyát. Alternatíva még sok más fizetési átjáró, amelyek támogatják az automatikus ismétlődő fizetést, például a Stripe vagy a Braintree.

### Használhatók a számlázási megállapodások különböző PayPal-bővítmények között?

Nem, a számlázási megállapodások jelenleg nem használhatók univerzálisan a különböző PayPal-bővítmények között. A PayPal Payments tartalmaz egy átállási réteget a PayPal Checkout bővítménnyel létrehozott előfizetésekhez: ezeket az új integráció is meg tudja újítani, amíg a régi számlázási megállapodás aktív. Ezalatt a PayPal Payments nem tudja a fiókot a PayPal tárolóba menteni, ami hatással lehet a további előfizetés-vásárlásokra.

Régi előfizetés PayPal Payments bővítményre váltásához előbb le kell mondani a régi számlázási megállapodást, mielőtt a vásárló vásárlással mentheti a fizetési módot. Miután a fizetési mód el van mentve, az előfizetés átváltható a PayPal-átjáróra a mentett fizetési móddal.

## Miért nem mondódik le vagy függesztődik fel az előfizetés a PayPalnál?

A PayPal és a bővítmény is nyilvántartja az előfizetéseket, ezért a státuszokat szinkronban kell tartani. Ez a rész konkrét, régebbi előfizetésekre vonatkozik, és nem biztos, hogy rád érvényes.

Előfordulhat, hogy ha a vásárló vagy a bolt kezelője felfüggeszt vagy lemond egy előfizetést a boltban, a státuszváltozás nem jelenik meg a PayPalnál. Hasonlóan, ha a vásárló módosítja a fizetési módot, vagy vált egy eredetileg PayPalnál vásárolt előfizetést, az eredeti előfizetés nem biztos, hogy lemondásra kerül a PayPalnál. Ezek a lehetséges okok:

### Helytelen API-hitelesítők

A PayPal-fiókod API-aláírására szükség van a PayPallal való kommunikációhoz. A hitelesítők több okból lehetnek hibásak:

1. Az API-aláírásod egy PayPal sandbox-fiókhoz tartozik, de a sandbox ki van kapcsolva a WooCommerce-beállításokban. Vagy éles fiók aláírását használod bekapcsolt sandbox mellett.
2. Hiányzó karakterek: az API-aláírásokban néha speciális karakterek vannak, amelyek másoláskor kimaradhatnak. Ellenőrizd, hogy minden karakter bekerült a WooCommerce beállítási oldalára.
3. A PayPal kétféle API-hitelesítést ad: tanúsítványt és aláírást. A bővítménnyel **API-aláírást** kell használnod, a tanúsítvány nem működik.

A PayPal nem tudja ellenőrizni az API-hitelesítőket, amikor először beírod őket a WooCommerce-be. Ha egy felfüggesztési vagy lemondási kérés érvénytelen hitelesítők miatt meghiúsul, a bővítmény feljegyzi a nem módosítható profil azonosítóját, és értesítést jelenít meg. Az értesítés elrejtéséhez frissítened kell a PayPal API-hitelesítőket.

### Régi PayPal-fiók (2009 előtti)

A 2009 előtt regisztrált PayPal-fiókokkal létrehozott előfizetések nem szinkronizálhatók a bolttal. A PayPal ezt nem dokumentálja, de ügyfelek tapasztalatai és a PayPal Merchant Technical Services információi alapján ez ismert probléma.

Ha régi PayPal-fiókod van, nézd meg az előfizetéseid PayPal-előfizetés-azonosítóját. A normál azonosítók nagy **I** betűvel kezdődnek, utána számok és betűk (például `I-nnnnnnnnnnnnnn`). A régi fiókokkal létrehozott előfizetések nagy **S** betűvel kezdődnek (`S-nnnnnnnnnnnnnn`).

Az azonosító ellenőrzése:

1. Nyisd meg a **WooCommerce → Előfizetések** oldalon egy olyan előfizetést, amely PayPal Standardot használ fizetési módként.
2. Nézd meg a **PayPal előfizetés-azonosítót** az előfizetés adatai között, a számlázási adatok részben.

Ha a PayPal-előfizetés-azonosítóid **S** betűvel kezdődnek, sem te, sem a vásárlóid nem tudják lemondani vagy felfüggeszteni az előfizetést a WooCommerce-ben. A megoldáshoz fel kell venned a kapcsolatot a PayPal Merchant Technical Services csapatával, jelezned kell, hogy a fiókod elavult előfizetés-azonosítókat használ, és kérned kell a frissítést.

Ha a PayPal **S** betűs azonosítót ad vissza, a bővítmény az admin felület tetején elavult fiókra figyelmeztető értesítést jelenít meg. Miután a fenti tanács szerint felvetted a kapcsolatot a PayPal Merchant Technical Services csapatával, biztonsággal elrejtheted az értesítést, és az többé nem jelenik meg.
