TLWWW / Simplepay online fizetés
Ezen opciót megvásárló könyvtár olvasóinak lehetősége van tartozásaik online kifizetésére. Az OTP Mobil Simplepay.hu rendszer segítségével lehet bankkártyával fizetni.
1. Használata - olvasók
A tartozások rendezését a TextLib webes felületén lehet intézni a belépést követően az Olvasói állapot táblázatában. Ha van tartozása, akkor megjelenik az Összesen sorban a Online fizetés gomb.
A gombra kattinva eljut a fizetési oldalra. Innen elérheti a SimplePay vásárlói és adatkezelési tájékoztatót. Itt újra megnézheti a tartozásait. Ha ad a könyvtár engedményt a tartozásból (pl. megbocsátás hete), az a tartozások listájának végén látszik.
Itt el kell fogadni az adattovábbítási nyilatkozatot, csak ezután lesz használható a Tovább a fizetésre gomb. Ezzel átlép az olvasó a SimplePay fizető oldalra.
A Simplepay oldalon történik a tényleges fizetés.
A fizetés befejeztével visszakerül az olvasó a TextLib webes katalógusába, ahol a fizetés sikerességéről kap információt.
1.1. Email visszajelzés
A SimplePay rendszer az online fizetésről emailt küld az olvasónak emailt. Ebben látjuk az olvasó adatait, a SimplaPay és a TextLib tranzakció azonosítókat is.
A textlib.hu és az InfoKer helyett természetesen a könyvtár weblapja és neve fog szerepelni az emailekben!
2. Rendszergazda tudnivalók
2.1. Beállítások
Az opciót megvásárló könyvtár az InfoKertől megkapja a futtatáshoz szükséges .php fájlokat. Ezeket a TLWWW fájlok mellé (pl. /var/www/tlwww/) érdemes tenni. De megoldható az is, hogy másik szerveren legyenek.
Példáinkban a kvt.hu-t használjuk a TLWWW domain neveként.
Első feladat a SimplePay beállítása. Az src/config.php fájlban kell ezt megtenni. A teszt rendszer beállítás (sandbox) kezdetben még maradjon true. Ilyesmi lesz:
'HUF_MERCHANT' => "DEV121212", // SimplePay azonosítónk 'HUF_SECRET_KEY' => "5rAm230q", // SimplePay API kulcsunk ... 'SANDBOX' => true,
Utána a TextLibhez tartozó beállításokat kell megtenni. Az adatkezelőt, az online kedvezmény mértékét és a hozzá tartozó szöveget a tlconfig.php fájlban állíthatjuk be. Ha nem akarunk kedvezményt adni, a $TLdiscount sort kommentezzük ki, vagy állítsuk nullára.
// könyvtár név, cím - UTF8 karakterkészletben! $TLteszt = false; // Teszteléskor pl.: TESZT_KIIR + TESZT_NOTART; $TLadatkezelo = "XXX könyvtár (1212 Budapest, Kiss utca 45.)"; $TLdiscount = 0; // kedvezmény - ennyi százalék $TLdiscountTXT="Megbocsátás hete okt. 10-17: <a href=kvt.hu/mbhet.html>info</A>"; $tlwwwurl='https://tlwww.kvt.hu'; // TLWWW url
A tlwww.cfg-ben is be kell állítani pár dolgot:
- A tlwwwsets értékhez hozzá kell adni 64-et. Ez jelzi azt, hogy meg kell jelenjen az Online fizetés gomb a tartozásoknál.
- A .php fájlok elérési útját meg kell adni, pl.:
paypath=/simplepay
A fenti beállítás esetén a https://kvt.hu/simplepay/tlpay.php URL kell működjön!
A tlwww.css fájlban csak akkor kell módosítani, ha a weboldalakon a gombok kinézetét változtatnánk. A css fájl végén a .paybutton beállításokat kell átírni.
Az OTP Mobilnál kezdeményezni kell, hogy próbálják ki az online fizetést. Ha ők jóváhagyják, hogy mehet a dolog élesben is, akkor kell az src/config.php-ban beállítani:
'SANDBOX' => false,
2.2. Tesztelés
A tesztelés idejére a tlconfig.php fájlban be lehet állítani a TLteszt változót. A TESZT_KIIR a weboldalra kiiírja a küldött és kapott paramétereket. A TESZT_NOTART esetén a sikeres fizetés után nem történik meg a tartozások rendezése. Ily módon egyetlen olvasóval lehet többször is próbálni a fizetési tranzakciót magát.
$TLteszt = TESZT_KIIR + TESZT_NOTART;
A TLWWW online fizetés oldalain a legfelső sorban látszik, hogy a teszt beállítások közül melyek vannak érvényben:
A tesztelés befejeztével a TLteszt változót false-ra kell állítani.
2.3. Olvasók adatai
- Csak olyan olvasó fizethet online, akinek a lakcímét tudjuk.
- Ha az olvasónak nem ismert az email címe, attól még fizethet.
Kap figyelmeztetést, hogy a SimplePay oldalon mindenképp kell
majd megadnia egy email címet. Ahova az értesítést kapja a fizetésről.
9. ábra: Olvasónak nincs email címe
2.4. Fájlok
- --- módosíthatók ---
- src/config.php - SimplePay config fájl
- tlconfig.php - TextLib config fájl
- --- ne módosítsuk! ---
- tlpay.php - Ez hívódik az Online fizetés gomb megnyomásakor. Lekérdezi az aktuális olvasó adatait és tartozásait. Ezeket meg is mutatja. Létrehozza a SimplePay tranzakciót. Az adattovábbítási nyilatkozat elfogadása után engedélyezi a Tovább a fizetésre gombot, aminek a megnyomása a SimplePay fizetés oldalát hozza be.
- tlback.php - ez hívódik a fizetési tranzakció végén. Megkapja, hogy a fizetés sikeres volt, vagy sem. Utóbbi esetben egy hibakód is jön. Megmutatja az eredményt. A lap alján levő Vissza az olvasói állapot oldalra gombbal meg lehet nézni az aktuális állapotot.
- src/SimplePayV21.php - A SimplePay API V2.1 része!
2.5. Rekordok
A tartozás rekordokba új mezők kerültek:
- PAYID - Tranzakció azonosítója a SimplePay renszerben
- PAYREF - TextLib tranzakcio azonosító. Ez "TL"-lel kezdődik, ezután jön a tranzakció dátuma és időpontja, majd az olvasó rekordazonosítója. Pl: TL20250414_121314_ac1234
2.6. Log bejegyzések
A tlwww.log-ban minden tartozásrendezésről lesznek bejegyzések. A dátummal kezdődők a tlwww.log sorai, a -- kezdetűek megjegyzések.
[04-09 15:29:47] --Fizet: ac48559 indul... -- Az ac48559 olvasó online fizetést indított [04-09 15:29:47] -- AddTart: ca3843461 960 -- A 960 Ft-os ca3843461 tartozás fel lett véve a fizetendők listájába [04-09 15:29:47] -- AddTart: ca3843460 960 [04-09 15:29:47] -- AddTart: ca3828039.2 30 [04-09 15:30:03] --Fizetett: TrId:504894794 - TL20250409_152947_ac48559 / 0% -- Online fizetés lezárult, a SimplePay tranzakció azonosító: 504894794 -- A TextLib tranzakció azon: TL20250409_152947_ac48559 -- Az olvasó nem kapott kedvezményt (0%) [04-09 15:30:03] ca3828039.2: T29: Tartozas rendezve (errNothing) -- Sikeres volt (errNothing) a ca3828039.2 tartozás rekord módosítása [04-09 15:30:03] ca3843460: T29: Tartozas rendezve (errNothing) [04-09 15:30:03] ca3843461: T29: Tartozas rendezve (errNothing) [04-09 15:30:03] TartozasRendezes status=errNothing -- Minden tartozás rekord módosítása sikeres volt [04-09 15:30:03] --PayTart ret: 0 -- Nem volt hiba a fizetés során (hibakód:0)
2.7. Email visszajelzés
A SimplePay rendszer a könyvtárnak is küld emailt minden online fizetésről.
A textlib.hu és az InfoKer helyett természetesen a könyvtár weblapja és neve fog szerepelni az email-ekben!
Vissza: Kiegészitő programok TextLib honlap