PayPal Standard előfizetések hibaelhárítása
Hogyan működnek a PayPal Standard előfizetések, hogyan ismerheted fel őket, milyen idővonalat várhatsz, és miért duplázódhatnak vagy akadhatnak meg a megújítások.
A PayPal Standard az új telepítéseknél a WooCommerce 5.5.0 óta rejtett, a meglévő boltokat ez nem érinti. Új boltokhoz inkább a PayPal Payments bővítmény ajánlott, amely a bankkártyás fizetést, a PayPal-pénztárat, az előfizetéseket és a későbbi fizetési lehetőségeket is lefedi.
Ez a fejezet azoknak szól, akik még a régi PayPal Standard fizetési átjárót használják az Előfizetésekkel, kifejezetten olyan előfizetésekhez, amelyek referenciatranzakciók nélkül jöttek létre a csatlakoztatott PayPal-fiókon. A fejezet ezeket PayPal Standard előfizetéseknek nevezi.
Ha a PayPal Standard előfizetés létrehozásakor a referenciatranzakciók be voltak kapcsolva, az előfizetést az Action Scheduler működteti az oldalon. Azokra az előfizetésekre a hibakeresési keretrendszer vonatkozik. Ha még csak választasz fizetési átjárót az Előfizetésekhez, a PayPal Standard jelentős korlátai miatt (a referenciatranzakciókkal együtt is) nem ajánlott. A támogatott átjárók listáját az átjárókról szóló fejezet tartalmazza, a PayPalról általánosságban pedig a PayPal Standard fejezet.
Hogyan ismered fel, melyik típus az előfizetésed
Szekció neve “Hogyan ismered fel, melyik típus az előfizetésed”A PayPal Standarddal a bővítmény referenciatranzakcióval és anélkül is működhet. Egy PayPal Standardot használó boltban ezért vegyesen lehetnek különböző típusú előfizetések, mindegyik a saját szabályai szerint. A típus a PayPal előfizetés-azonosító előtagjából ismerhető fel:
I-előtag: régi típusú PayPal Standard előfizetés.B-előtag: referenciatranzakciós előfizetés.
A hibakeresés három lépése
Szekció neve “A hibakeresés három lépése”A folyamat a hibakeresési keretrendszer PayPal Standardra szabott változata:
- A PayPal Standard előfizetés felépítésének megértése: ismerd fel a típust, és nézd meg, hogyan épül fel és van beállítva az adott előfizetés.
- Az elvárt működés meghatározása: állapítsd meg, mit kell történnie a kezdeti rendelésnél és a megújításnál.
- Idővonal készítése: jegyezd fel, mi történt valójában.
Ha a hibát megtaláltad vagy továbbra sem jutsz előrébb, két kapcsolódó téma segít: az, hogy miért nincs lemondva vagy felfüggesztve az előfizetés a PayPalnál (a WooCommerce és a PayPal állapotának eltérése), valamint a PayPal IPN-hibák (az értesítések és visszaigazolások problémái).
1. A PayPal Standard előfizetés felépítése
Szekció neve “1. A PayPal Standard előfizetés felépítése”A PayPal Standard előfizetések számlázását az átjáró irányítja, és ez jelentősen eltér a rugalmasabb, Action Scheduler által működtetett előfizetésektől, amelyeket gyakorlatilag minden más fizetési átjáró létrehoz. Ezért hibakeresésnél a más átjárókról tanultak többségét figyelmen kívül hagyhatod.
A számlázási ütemezést és az idővonalat teljes egészében a PayPal oldala vezérli. Ennek fontos következményei vannak az előfizetés szerkesztőoldalán:
- A PayPal előfizetés azonosítója
I-előtaggal kezdődik. - Az ütemezés doboz nem szerkeszthető (zárolt).
- Az előfizetés tételei, az adó és az összeg területe nem szerkeszthető (zárolt).
A kezdeti vásárlás jegyzetei
Szekció neve “A kezdeti vásárlás jegyzetei”Sikeres kezdeti vásárlásnál az előfizetés jegyzetei egy percen belül négy bejegyzést tartalmaznak ebben a sorrendben: az IPN-előfizetés feliratkozása befejeződött, az IPN-előfizetés fizetése befejeződött, a fizetés állapota késznek jelölve, az állapot Függőben állapotról Aktív-ra változott.
A megújítások jegyzetei
Szekció neve “A megújítások jegyzetei”Sikeres megújításnál öt bejegyzést látsz egy percen belül: az állapot Aktív-ról Felfüggesztve állapotra változott, a rendelés létrejött a megújítás rögzítésére, az IPN-előfizetés fizetése befejeződött, a fizetés állapota késznek jelölve, az állapot Felfüggesztve-ról Aktív-ra változott.
A szülőrendelés lezárása PDT és/vagy IPN útján történik. A megújítási rendelések fizetése mindig IPN-en keresztül zárul le.
2. Az elvárt működés
Szekció neve “2. Az elvárt működés”Így működik a PayPal Standard az Előfizetésekkel. A folyamat eléggé technikai, ezért segít, ha ismered mind az Előfizetések, mind a PayPal Standard általános működését.
- Az előfizetés első megvásárlásakor:
- A WooCommerce-ben létrejön a kezdeti (szülő) rendelés és az előfizetés.
- A kezdeti rendelés fizetési visszaigazolása IPN-nel (azonnali fizetési értesítés) vagy PDT-vel (fizetési adatátvitel) érkezik.
- A számlázási megállapodás (a PayPal oldali előfizetés) visszaigazolása kizárólag IPN-nel érkezik.
- Amikor a PayPal feldolgoz egy megújítási fizetést, IPN visszaigazolást küld az oldalnak (a megújítás mindig IPN-nel jön, soha nem PDT-vel).
- Amikor az Előfizetések IPN visszaigazolást kap a PayPaltól:
- Megkeresi az egyező előfizetést az előfizetés azonosítója alapján.
- Megnézi, van-e kifizetett szülőrendelés, korábbi megújítási rendelés, vagy nincs korábbi rendelés.
- Ha fizetetlen szülőrendelést talál, kifizetettnek jelöli.
- Ha kifizetett szülőrendelést, korábbi megújítási rendelést vagy semmilyen korábbi rendelést talál, úgy veszi, hogy a visszaigazolás új megújítási rendelésre vonatkozik.
- Ez elindítja a megújítási rendelés létrehozását, amelyet kifizetettnek jelöl.
- Újraszámolja és megjeleníti az előfizetés Következő fizetés dátumát.
Az Action Scheduler egyik lépésben sem szerepel, mert a PayPal Standard előfizetéseknél nem vesz részt a folyamatban. A PayPal irányítja az ütemezést, és IPN-visszaigazolásokkal jelzi a megújításokat az oldalnak.
Más, harmadik féltől származó átjárók is lehetnek úgy megtervezve, hogy távolról irányítsák az előfizetés számlázási ütemezését. Ezt a fejlesztőik a saját átjárójukba építik, nem az Előfizetések kódjába. Ha ilyen átjáróval van gondod, az átjáró fejlesztőjéhez fordulj.
3. Idővonal készítése
Szekció neve “3. Idővonal készítése”A hibakereséskor segít az idővonal, amelyet összevetsz az elvárttal. Ebből gyakran kiderül a válasz, vagy legalább az, merre keress tovább.
Információforrások
Szekció neve “Információforrások”- Előfizetés jegyzetei: az életciklus minden jelentős eseménye időbélyeggel.
- Rendelés jegyzetei: a szülőrendelésnek és a megújítási rendeléseknek külön jegyzetei vannak, a fizetésről és az állapotváltásokról.
- A szerver hibanaplói: a tárhelyszolgáltatód hibanaplói a hiba időpontjára.
- WooCommerce-naplók: a WooCommerce → Állapot → Naplók alatt az előfizetéses és az átjárós naplók.
- PayPal-naplók: a PayPal tranzakciós előzményei és IPN-előzményei is hasznosak, mert olyan részleteket is tartalmazhatnak, amelyek nem jutottak vissza az oldalra.
PayPal Standard esetén az idővonal készítéséhez nem kell az Action Schedulert nézned.
Idővonal-minta
Szekció neve “Idővonal-minta”A PayPal Standard idővonalak lényegesen összetettebbek a megszokott megújítási idővonalnál. Érdemes jelölni, hol rögzült az egyes esemény, mert így látszik, hol egyezik vagy tér el a PayPal és az oldal információja.
Ez egy sikeres PayPal Standard megújítás mintája:
| Időpont | Mi történt | Hol látszik |
|---|---|---|
| 2022-01-17 16:49 | A szülőrendelés létrejött | Rendelések |
| 2022-01-17 16:50 | IPN-előfizetés fizetése befejeződött | Előfizetés jegyzetei, PayPal-naplók |
| 2022-01-17 16:50 | A fizetés állapota késznek jelölve | Rendelés és előfizetés jegyzetei, PayPal-naplók |
| 2022-01-17 16:50 | IPN-előfizetés feliratkozása befejeződött | Előfizetés jegyzetei, PayPal-naplók |
| 2022-01-17 16:50 | Az előfizetés állapota Függőben → Aktív | Előfizetés jegyzetei |
| 2022-02-17 14:13 | Az előfizetés állapota Aktív → Felfüggesztve | Előfizetés jegyzetei |
| 2022-02-17 14:13 | Megújítási rendelés létrejött | Rendelések, előfizetés jegyzetei |
| 2022-02-17 14:13 | IPN-előfizetés fizetése befejeződött | Előfizetés jegyzetei, PayPal-naplók |
| 2022-02-17 14:13 | A fizetés állapota késznek jelölve | Előfizetés és rendelés jegyzetei, állapotváltás |
| 2022-02-17 14:13 | Az előfizetés állapota Felfüggesztve → Aktív | Előfizetés jegyzetei |
Ez csak minta. A pontos események sora kissé eltérhet a PayPal feldolgozásától és az oldal beállításaitól függően. A legjobb módszer a saját elvárt idővonal megismerésére, ha létrehozol egy PayPal Standard próbaelőfizetést az oldaladon.
Az IPN nem azonnali fizetési mód, ezért 5-7 perc késés is lehet a szülőrendelés létrehozása és az IPN-nel érkező fizetési visszaigazolás között. Ennek kiküszöbölésére ne használj olyan bővítményt vagy egyedi kódot, amely automatikusan befejezi az előfizetéses rendeléseket (lásd lent).
A megújítási rendelés létrehozása ezzel szemben azonnalinak látszik, mert az IPN indítja a létrehozást. Ez eshet más napszakra, mint a szülőrendelés.
Az idővonal elemzése
Szekció neve “Az idővonal elemzése”Ha elkészült az idővonal, hasonlítsd össze az elvárttal. Az elemzés szabályai ugyanazok, mint a hibakeresési keretrendszernél: keress hézagokat, vesd össze az elvárttal, keress mintákat, és kezeld időrendben a több hibát. Az átjáró által irányított számlázásra vonatkozó útmutatás ugyanott van leírva. Ha sehogy sem jutsz tovább, kérj segítséget a támogatástól vagy fejlesztőtől, a leleteiddel (hibaüzenetek, azonosítók) együtt.
Duplikált vagy felfüggesztett PayPal Standard megújítások
Szekció neve “Duplikált vagy felfüggesztett PayPal Standard megújítások”Ha az oldalon duplikált PayPal Standard megújítások jelennek meg, vagy a megújítási rendelések Felfüggesztve vagy Fizetésre vár állapotban vannak, a leggyakoribb ok a rendelések automatikus befejezése a fizetés visszaigazolása előtt.
Tünetek
Szekció neve “Tünetek”- A megújítás közvetlenül a vásárlás után feldolgozódik: szülőrendelés, majd azonnali megújítás. Ez általában duplikált rendelésnek látszik.
- A szülőrendelés állapota Teljesítve.
- A megújítási rendelés állapota néha Fizetésre vár, néha Feldolgozás alatt.
- Ha Fizetésre vár, az előfizetés Felfüggesztve állapotba kerül.
Mit ellenőrizz
Szekció neve “Mit ellenőrizz”- PayPal Standard előfizetések-e az érintettek? (Szinte biztosan igen.)
- A szülőrendelés állapota Teljesítve-re változik-e, mielőtt a fizetési visszaigazolás megérkezne az oldalra?
- Ha igen, az oldalon valószínűleg automatikus befejezés működik, vagyis egy bővítmény vagy módosítás, amely magától lezárja a rendeléseket. Ez okozza a duplikált rendeléseket.
Megoldás
Szekció neve “Megoldás”A diagnózis után keresd meg és kapcsold ki az automatikus befejezést az oldalon.
Műszaki magyarázat
Szekció neve “Műszaki magyarázat”A PayPal Standard előfizetések másként működnek, mint az Action Scheduler által működtetettek. Amikor a fizetést visszaigazoló IPN megérkezik a PayPaltól, az Előfizetések:
- megnézi, hogy létezik-e kifizetettnek jelölt szülőrendelés,
- ha a szülőrendelés nincs kifizetettnek jelölve, kifizetettnek jelöli,
- ha a szülőrendelést túl korán jelölték kifizetettnek, azt feltételezi, hogy a fizetés megújítási rendelésre vonatkozik, és új megújítási rendelést hoz létre,
- a fizetési visszaigazolás azonban a szülőrendelésre kerül, mert oda tartozik, az újonnan létrehozott megújítási rendelés pedig Fizetésre vár állapotban marad.
Általánosságban az oldalak ne módosítsák, hogyan kezeli az előfizetés a rendelések állapotait, mert ez váratlan viselkedést okozhat.
Készült: