|
Raktiniai žodžiai yra naudojami tam, kad būtų galima adresuoti SMS žinutę tam
tikrai paslaugai. Pavyzdžiui, priskyrus raktinį žodį "ABC" interneto adresui
http://JusuServeris.lt/MicroPay.php, visos
SMS žinutės, siunčiamos numeriu 1398 ir prasidedančios "ABC" arba "abc" (pvz.
"ABC 123" arba "aBc xxx", bus readresuotos šiam adresui (t.y. bus iškviestas
http://JusuServeris.lt/MicroPay.php, kuriam GET
metodu bus perduoti žinutės parametrai).
SMS persiuntimo seka
MicroPay naudojama tokia SMS apdorojimo seka
1. Vartotojas siunčia žinutę numeriu 1398 (Pvz. "ABC xxx")
2. MicroPay nustato raktinį žodį (ABC) ir gali:
- persiųsti žinutę URL adresui (priskirtam prie šio raktinio žodžio),
nuskaityti šio URL specialiai suformatuota
atsakymą bei gražinti vartotojui tekstą (pateiktą URL atsakyme) ir
apmokestinti žinutę tam tikru tarifu (pateiktas URL atsakyme).
- gražinti vartotojui iš anksto įvestą statinį tekstą ir apmokestinti žinutę iš anksto nustatytu tarifu.
3. Esant įvestam "SMS patvirtinimo URL", MicroPay vėl kviečia partnerio serverį
ir informuoja apie sėkmingą/nesėkmingą žinutės gražinimą vartotojui.
SMS raktinio žodžio registravimas/redagavimas
Užregistruoti raktinį žodį galite partnerių srityje, skyriuje "Raktiniai
žodžiai".
Viršuje yra pateikta raktinio žodžio įvedimo forma. Šioje
formoje galite nustatyti šiuos parametrus:
1. "Raktinis
žodis". Tai turėtų būti 2-8 lotiniškos raidės (pvz. "ABCD", "PAY" arba kt.).
2.
Veiksmas "Kviesti URL". Pasirinkus šią opciją, SMS žinutės bus peradresuojamos
Jūsų nurodytam (3) URL. Šiam URL bus perduoti tokie parametrai:
- operator (nurodo operatorių, reikšmės gali būti "Omnitel",
"Bite" arba "Tele2");
- originator (siuntėjo mob. tel. numeris, formatu "370xxxzzzzz");
- message (pilnas SMS žinutės tekstas, įtraukiant raktinį žodį);
- mpid (MicroPay suteiktas unikalus žinutės ID. Kiekvienam partneriui
mpid yra skaičiuojamas nuo 1).
3. Kviečiamas URL
nurodo adresą, kuris bus kviečiamas pasirinkus "Kviesti URL" opciją.
Pavyzdžiui, įvedus URL http://JusuServeris.lt/MicroPay.php, jis bus kviečiamas
tokiu būdu:
http://JusuServeris.lt/MicroPay.php?operator=Omnitel&originator=370xxxzzzzz&
message=ABC&mpid=123
(jeigu žinutė "ABC" yra siunčiama Omnitel vartotojo "370xxxzzzzz" numeriu
1398)
[!] Kviečiamam URL gali būti
nustatytas Https:// būdas.
[!] Kviečiamas URL gali
turėti autorizacijos parametrus, pvz. "http://user:password@JusuServeris.lt/MicroPay.php".
[!]
Esant žinučių peradresavimui Jūsų URL, SMS žinutės tarifas yra nustatomas
Jūsų serverio atsakyme (kartu su SMS atsakymo vartotojui tekstu ir kt.
informacija). Plačiau apie tai rasite skyriuje SMS
atsakymo formatavimas.
4. Veiksmas "Gražinti SMS siuntėjui šį tekstą". Pasirinkus šią opciją, Jūs galite tiesiog įvesti tekstą, kurį vartotojas gaus kaip atsakymą į savo žinutę bei pasirinkti tarifą, kuriuo žinutė bus apmokestinta
5. Tekstas. Šis
tekstas bus gražintas siuntėjui jei yra nustatyta "Gražinti SMS siuntėjui šį
tekstą" opcija.
[!] Tekstas turi būti ne
ilgesnis kaip 160 simbolių.
6. Tarifas, kuriuo
bus apmokestinta žinutė jei yra nustatyta "Gražinti SMS siuntėjui šį tekstą"
opcija.
7.
"SMS patvirtinimas". Dėl tam tikrų priežasčių ne visos SMS žinutės būna
gražintos vartotojui ir apmokestintos. Pvz. jei vartotojas neturi pakankamai
lėšų savo operatoriaus sąskaitoje apmokėti 10 Lt žinutę (o tarifas nėra žinomas
iki kol Jūsų serveris negražins atsakymo ir nenustatys tarifo), atsakymas
tiesiog nebus persiųstas atgal vartotojui. Tokiu atveju Jūs galite sekti
sėkmingas ir nesėkmingas žinutes pasinaudojus SMS patvirtinimo opcija. SMS
patvirtinimo lauke tiesiog nurodykite URL, kuriam GET metodu bus perduoti šie
parametrai:
- mpid (MicroPay suteiktas unikalus žinutės ID);
- processed (nurodo ar sėkmingai buvo pristatyta žinutė. Reikšmės gali
būti "yes" arba "no");
- pam_id (Partner Assigned ID, unikalus žinutės ID, kurį, gavus
readresuotą žinutę ir atsakius į ją, galite suteikti patys. Plačiau apie savo ID
suteikimu rasite skyriuje SMS atsakymo
formatavimas).
Pavyzdžiui, įvedus URL
http://JusuServeris.lt/MicroPay_Confirm.php, jis bus kviečiamas tokiu
būdu:
http://JusuServeris.lt/MicroPay_Confirm.php?mpid=123&processed=yes&pam_id=456
[!] SMS
patvirtinimo URL gali gražinti bet kokį atsakymą.
|
