Partner login

 

. . . . .

Emelt Dijas SMS technikai leírás

A fizetési folyamat röviden a következő lépésekből áll:

1. A szolgáltatást igénybevevő felhasználó küld egy emeltdíjas SMS-t a meghirdetetttelefonszámra, az SMS szövege pedig a következő formájú: <partner prefix> <szoveg>
Minden partnerünk kap egy (vagy több) prefixet. Ebből fogja tudni a rendszer, hogy melyik partnernek kell küldeni az értesítést. (pl. pay bela)

2. A rendszer egy, a partner által megadott URL-re elküldi az SMS szövegét, a küldő telefonszámát, az SMS értékét és egy tranzakciós azonosítót.

3.a A partner a 2. lépésben történt hívásra megadja a válasz SMS szövegét, amit kiküldünk a szolgáltatást igénybevevőnek.

3.b Amennyiben a partner által megadott URL-re sikertelen a kapcsolódás, akkor a válasz SMS egy előre meghatározott szöveg (pl: A szolgáltatás jelenleg nem érhető el, ha újra működni fog, akkor értesítést kap). Ilyen esetben a rendszer 10 percenként megpróbálja újra elküldeni a partnernek a beérkezett SMS adatait. Ha a partner igényli, akkor lehetőség van ilyenkor egy újabb válasz SMS küldésére, ez azonban újabb költséget jelent.

4. Amint a szolgáltatást igénybe vevő megkapta a válasz SMS-t, a rendszer ismét meghívja a partner által megadott URL-t és jelzi ezt. Fontos, hogy a szolgáltatást csak ezután a lépés után szabad engedélyezni, mert a mobil szolgáltatók csak akkor írják jóvá az SMS-t, ha a válasz SMS-t is megkapta a felhasználó. A kommunikáció tehát két fázisban zajlik a partner és a fizetési rendszer között. Első lépésben az SMS küldésekor hívjuk meg a partner URL-jét, második lépésben pedig a válasz SMS
megérkezésekor.

Felmerülő kérdéseit kérjük e-mailben jelezze nekünk!

részletesebben:

1. fázis
Beérkezik az SMS, mondjuk 160+ÁFA értékű, az SMS szövege pl pay bela. A rendszer, ennek hatására meghívja a következő URL-t:

http://partneráltalmegadotturl?status=1&id=1234567&text=pay+bel
a&tel=36201234567&value=200&type=sms&prefix=pay&provider=1

ahol:
id: tranzakciós azonosító, ami minden fizetésnél különböző. Ezzel az azonosítóval hivatkozik a rendszer a későbbi fázisokban az adott fizetésre. tel: az SMS küldőjének a telefonszáma 11 jegyű formában (pl. 36201234567) value: az SMS bruttó értéke prefix: az SMS előtagja, ami a partner prefixe provider: mobil szolgáltató azonosítója A HTTP kérésre a válasz SMS szövegét kell megadni, mindenféle html tag nélkül. A válasz hossza maximum 160 karakter lehet. Az ékezetes karaktereket célszerű kerülni, mivel lehetnek kompatibilitási problémák a telefonon történő megjelenítésnél.

2. fázis
Ha az előző fázis sikeres volt és a válasz SMS sikeresen megérkezett, akkor következik a második fázis, ahol az alábbi formájú URL-t hívjuk meg:

http://partneráltalmegadotturl?status=2&id=123456&text=pay+bel
a&tel=36201234567&value=200&type=sms&prefix=pay&provider=1

Tehát lényegében ugyanazt, mint az első fázisban, csak a status értéke 2 lesz. Itt válaszként az OK szöveget várjuk, ha rendben volt minden, egyébként pedig az ERROR üzenetet. Ha nem sikerült elérni a partner URL-t, akkor 10 percenként újra megpróbáljuk átadni az SMS adatait az alábbi hívással:

http://partneráltalmegadotturl?status=3&id=123456&text=pay+bel
a&tel=36201234567&value=200&type=sms&prefix=pay&provider=1

Teszteléshez nem kell fölöslegesen SMS-eket küldeni, hanem ehhez teszt felületet biztosítunk, ahol lehetőség van megadott értékű és szövegű SMS „küldésére”. Az így küldött SMS a forgalmi adatok között nem fog megjelenni. A teszt SMS a Netfizetés és az Ön rendszere közti helyes kommunikáció tesztelésére szolgál.