NetPay technikai áttekintés partnereink számára

Átírás

1 NetPay technikai áttekintés partnereink számára Üdvözöljük NetPay partnereink között. Ebben a dokumentumban megtalálja azon alapinformációkat, amelyek segítenek az on-line fizettetés megvalósításában. Tájékoztatjuk, hogy jelen dokumentum bizalmas információkat és üzleti titkokat tartalmaz, amelyek nem juthatnak harmadik személy tudomására. Az itt leírt információk segítenek Önnek abban, hogy a NetPayt, mint fizetési megoldást műszaki oldalról áttekintse, valamint megtervezze a saját weboldalaiba való beépítését. Szótár A dokumentumban használatos kifejezések magyarázata. Partner: az, aki a NetPay használata, bezevetése céljából szerződik Vásárló: NetPay számla birtokos, aki azon elvásárolható egyenleggel rendelkezik Szolgáltatás: hozzáférés vagy egyéb értékesíthető tartalom, amelyet a Vásárló megvehet Termék: egyedi jellemzővel bíró, megvásárolható dolog Kód: egy HTML form, amely a NetPay vásárlási folyamat elindítója A NetPay beillesztése A Netpay számtalan módon biztosíthat fizetési lehetőséget. Leggyakrabban valamilyen hozzáférést oszt ki név és jelszó formában, illetve pénztárként funkcionál. Mindkét esetben a Partner weboldalába egy tőlünk kapott Kódot kell beillesszen. Ebben a Kódban definiált a Partner, a Szolgáltatás, amennyiben van, akkor Termék illetve egy mindezeket hitelesítő azonosító. Ezeken módosítani a szerződés értelmében a termékazonosítón kívül nem lehet. A Kód a Vásárló számára egy NetPay képként jelenik meg. A Kódban az egy Szolgáltatáshoz

2 tartozó Termékek jelölését Partner szabadon variálhatja. Azaz például ezer videofilm letöltéséhez adunk egy Kódot, amelyből a termék azonosító variálásával minden filmhez előállíthatja az egyedi Kódot. Amennyiben több árkategóriában vannak a filmek, úgy árkategóriánként kap egy-egy Kódot. A Kód A Kód egy HTML form, több hidden tipusú mezővel és egy image mezővel, amely egy NetPay kép. A Kódban Partner a PID értékét megváltoztathatja, amennyiben több szolgáltatáshoz ugyanazt a Kódot kapta - ilyen például filmek letöltésének árusítása. A Kód többi részét Partner a szerződésben szabályozottak szerint módosíthatja (általában az oldal jellegétől hangsúlyosan eltérő kódban a kép előzetes egyeztetés után kicserélhető). A Kódot a szerződéskötés adott fázisában a NetPay üzemeltető biztosítja Partnerének. Illustration 1: Html kód (bizonyos részek kitakarva szerepelnek) A vásárlás menete jelszókiadás esetében Vásárló a beillesztett Kóddal átjut a NetPay oldalára. Itt a fizetés sikerességétől függően kap hozzáférést a Partner védett tartalmához. Az adatok kiadása lehet lokális, amikor ezzel párhuzamosan Partner is megkapja az adatokat (https url meghívásával, háttérben). Ugyanakkor Partner is generálhat jelszót amit a NetPay vagy megkap, s ekkor kiír a fizetés végén, vagy nem kap meg, ekkor a fizetés eredményének kiírása után visszavezeti a Vásárót a Partner oldalára. A Partnernek

3 biztosítania kell vagy valamilyen felületet amin átadhatjuk a fizetéskor generált jelszavakat, vagy egy olyan https url-t amit meghívva ki tudunk osztani egyet. A NetPay az URL-ekre adott válaszban OK: <üzenet> illetve ERR: <üzenet> tartalmat ad, és ugyanezt várja a túloldalról. A vásárlás menete pénztár szolgáltatás esetében A kosár összeállítása után Partner legenerálja ugyanazt a Kódot, amelyben a Termék azonosító egy tranzakció azonosító. A Kód megjelenítése előtt a NetPay rendszerbe https url hívásával felviszi a tranzakciót, az árat és egy dátumot. Vásárló a tranzakció azonosító birtokában eljut a NetPay oldalra, ahol megkapja az árat. A fizetés eredményéről a Partner is tájékoztatást kap, s a Vásárló fizetés után visszajut a kiinduló oldalra. A tranzakcióknak van timeout paraméterük amelyben a NetPay és a Partner technikai kapcsolattartói állapodnak meg. Ugyanez igaz a http kommunikáció részleteire is: port szám (ha nem default), paraméterek neve, száma és szintaxisa, esetleges egyéb kommunikációs részletek. A NetPay rendszerben egy tranzakció azonosító egyszer használható fel, és státusztól függetlenül öt naptári napig a rendszerben marad. Műszaki követelmények Partner csak és kizárólag SSL használatával kommunikálhat a NetPay rendszerrel, tehát mind a paraméter átadások mind azok fogadása csak SSL által biztosított úton történhetnek. Egyedi megoldáskor (pl. socketen keresztüli kommunikáció) Partner feladata a protokoll definiálása, s amennyiben a Netpay azt nem tartja elég biztonságosnak, Partnernek szigorítania kell azon. Gondoskodni kell továbbá arról, hogy az adatok átvitelét csak jogosultak kezdeményezhessék, jelszóvédelemmel, IP címre korlátozással vagy egyéb eszközzel. A forgalom ellenőrzése, elszámolás A forgalmat Partner a NetPay által biztosított weboldalon keresztül illetve napi és havi bontásban elektronikus levélben kapja, igény esetén. A weboldal tanúsítvány

4 alapú azonosítást igényel, a tanúsítvány kérelmet a NetPay üzemeltetőhöz kell eljuttatni, aki aláírás után azt visszaküldi. Innentől hiteles a tanúsítvány, s azt lehet használni. A tanúsítvány generálása és használata OpenSSL segítségével támogatott, de bármely program használható amely x509 szerint működik. A NetPay saját magát fogadja el hiteles CA-nak. A NetPay rendszerbe illeszkedés menete Önök a szerződéskor már tudják, hogy milyen terméket vagy termékeket szeretnének on-line értékesíteni. Ezekhez az adminisztrációtól Kódot kell kérjenek. Amint azokat megkapták, már el tudják kezdeni beilleszteni az oldalakba. Ahhoz, hogy a NetPay kiszolgálja az Önok vásárlóit, engedélyeztetni kell a Szolgáltatást. Ehhez a Kódokat a NetPay csapatának ki kell próbálnia néhány teszt fizetéssel amelyek közott kell legyen sikeres (sikertelen fizetésnek is kell lennie, letesztelve a Partner hibakezelését). Amennyiben az adott termék kifizethető, úgy a NetPay részéről a szolgáltatás-beüzemelés folyamata lezárult. Amennyiben hibákat tapasztaltunk, úgy a szolgáltatást nem engedélyezzük s a tapasztalatokat jelezzük a Partner technikai kontaktjánál. Az engedályezésnek szintén feltétele, hogy Önok a weboldalukon a Kód mellett tájékoztassák látogatóikat a Netpay fizetésről, illetve a fizetési eszközhöz jutás módjáról. Partner feladata Partner technikai kapcsolattartójának feladata leprogramozni vagy leprogramoztatni azokat a programokat, amelyek a https url hívásokat indítják illetve végződtetik (természetesen csak akkor, ha a konkrét műszaki megoldásnak ezek részei). Mivel http protokollt használunk, Partner tetszőleges programozási nyelvet használhat (C, C++, Perl, PHP stb). Felhívjuk figyelmét, hogy a NetPay üzemeltetése csak Unix alapú rendszerekhez illetve megoldásokhoz tud támogatást nyújtani. Maga a fizetési rendszer platformfüggetlen, bármilyen operációs rendszer használható amelyen fut olyan program, amely képes szabványos http kéréseket indítani és fogadni.

5 További információk Kérjük, hogy adminisztratív kérdéseket az címre, technikai, műszaki kérdéseket pedig a tech@netpay.hu címre küldjön. Hibabejelentés: support@lax.hu.