WAP paslaugos

Lietuva

1. Naršantis vartotojas partnerio portale spaudžia nuorodą, kuri vartotoją nukreipia į Vero sistemos pirkimo aplinką.

2. Vartotojui užduodamas klausimas ar jis sutinka apmokėti paslaugą.

3. Sutikus apmokėti Vero sistema atlieka pinigų nuskaitymą iš vartotojo.

4. Apie sėkmingą paslaugos apmokėjimą Vero sistema informuoja partnerį nukreipimo nuorodą (url) papildydama apmokėjimo parametrais.

5. Vartotojas grąžinamas atgal į partnerio svetainę.

Paslauga skirta vartotojo apmokestinimui mobiliuoju internetu. Prisijungus bevieliu (Wireless) ryšiu paslaugų apmokėti nepavyks - sistema negalės atpažinti vartotojo telefono numerio ir nuskaityti pinigų.

Prieš registraciją arba vartotojui vos apsilankius partnerio projekte, rekomenduojame panaudoti WAP identifikavimo paslaugą. Šitaip sužinosite detalią vartotojo informaciją (šalį, kalbą, operatorių ir kt.) ir galėsite suformuoti mokėjimo puslapį.

Plačiau apie vartotojo identifikavimą skaitykite skyriuje "Vartotojo identifikavimas"

Operatoriaus „Telia Lietuva“ atveju, vykdant apmokestinimą vartotojas patenka į laukimo puslapį, su tekstu: „Bandome apmokestinti. Gavus SMS, spauskite šią nuorodą: tęsti >“. Vartotojui siunčiama apmokestinamoji SMS žinutė, kurioje nurodytas paslaugos pavadinimas ir nuoroda į apmokėtą partnerio paslaugą. Taigi, net jei vartotojas paliks WAP naršyklę, jis galės tęsti registraciją, paspaudęs nuorodą gautoje SMS žinutėje.
Jei partneris gauna apmokestinimo klaidas, bet klaidos nėra tvarkingai apdorojamos (HTTP statusas ne 200), „Telia Lietuva“ vartotojų apmokestinimas neveiks.

1. Vartotojo nukreipimas į Vero mokėjimo sistemą

Norint apmokestinti vartotoją, jis turi būti nukreiptas į Vero sistemą adresu http://bill.vero.lt/wap/register su suformuotais GET parametrais:

Suformuoto adreso, kur bus nukreipiamas vartotojas, pavyzdys (saugumo paraše naudojamas slaptažodis „test“):

http://bill.vero.lt/wap/register?session_id=debaf588e8ebadfe97a6ae38ff95beef&after_register=yes&
s=2&si=&i=1255530969&u=http%3A%2F%2Fmbs.vero.lt%2Fsimple%2Fwap_register.php&s1=01cb763307dd28851
f8ccf3192b5fcbfd8ccd858

Papildomai galima pridėti bet kiek parametrų, vėliau jie bus pridėti prie adreso kuriuo vartotojas grįš į projektą, kartu su pirkimo (apmokėjimo) duomenimis. Tačiau parametrai negali būti su pavadinimais: 's', 'si', 'i', 'p', 'pc', 'u', 'un', 's1', 's2', nes šie parametrai naudojami pagrindinei informacijai perduoti.

Kad išvengtų dvigubų apmokėjimų, neužtenka sugeneruoti mokėjimo nuorodos, kai paspaudžiamas pirkimo mygtukas. Tokiu atveju, spaudžiant tą patį mygtuką 2 kartus iš eilės, sugeneruosite 2 skirtingas pirkimo užklausas, ir jos abi bus apmokėtos. Rekomenduojame, kad pirkimo mygtukas jau ir būtų sugeneruota pirkimo nuoroda su unikaliu parametru i.

Jei naudojate WAP pirkimo inicijavimą per SOAP, detalius aprašymus, kaip pradėti pirkimo įvykius rasite "Nuotolinių metodų aprašo" puslapyje.

Wap/register GET parametrai kreipiantis į Vero sistemą

Pavadinimas	Tipas	Privalomas	Aprašymas	Pavyzdys
s	int	taip	WAP pirkimo paslaugos ID	2
si	string	ne	Vartotojo identifikatorius paslaugoje (pvz. slapyvardis). Naudojamas, jei į vieną paslaugą tas pats vartotojas registruojamas kelis kartus, bet su skirtingu identifikatoriumi.	-
i	string	taip	Išorinės sistemos identifikatorius unikaliai nusakantis vykdomą apmokėjimo įvykį (transakciją). Parametras taip pat naudojamas dvigubų apmokestinimų išvengimui, todėl kiekvieną kartą turi būti unikalus vienai paslaugai ar bent vartotojui. Jei nekaupiate apmokestinimo įvykių savo pusėje, galima nurodyti nuorodos sugeneravimo laiką.	1255530969
p	int	ne	Registracijos (pirmo periodo) kaina, nurodoma centais. Reikalinga, kai registracija turi kelias kainas.	-
pc	string	ne	Registracijos valiuta (ISO 4217 standartu). Reikalinga nurodinėjant kainą parametre p.	-
u	string	ne	Koduotas (urlencode) URL į kurį nukreipti vartotoją po registracijos. Jeigu šio parametro nėra, vartotojas bus nukreiptas į paslaugos URL, nurodytą paslaugos kūrimo metu	http%3A%2F%2F mbs.vero.lt%2F simple%2Fwap_register.php
un	string	ne	Koduotas (urlencode) URL, jei reikia nukreipti vartotoją į skirtingą URL po nesėkmingos registracijos. Jeigu šio parametro nėra, vartotojas bus nukreiptas į URL, nurodytą parametre u	-
s1	string	taip	Saugumo parašas (žemesnio patikimumo)	-

2. Vartotojo grąžinimas į partnerio sistemą

Tiek po sėkmingos, tiek po nesėkmingos registracijos vartotojas bus nukreipiamas į paslaugos adresą (nuorodoje bus prikabinti parametrai, kurių išorinė sistema „paprašė“ inicijuodama registraciją).

Pavyzdys (saugumo paraše naudojamas slaptažodis „test“):

http://mbs.vero.lt/simple/wap_register.php?session_id=debaf588e8ebadfe97a6ae38ff95beef&after_reg
ister=yes&s=2&si=&sr=active&srs=active&i=1255530969&t=2331494&a=1&s1=dfbb0af21a09516b73946bb9945
8499f1ef6b081&s2=HpwXNO%2Fr5Yhd3g00yIeHKEnZsuYJ7UdGTHnj06n5T%2FJQ%2BDGZG8tPaMYH6rCI9Febv8UDtNgQL
eXi7h21diQUxEirxNjb1AqdvSOi%2FbO3IqCvuvGS65t7EIom5E9tGL77wdtorKpwgNkbfszQAgBEjard7scWiwt0Jbhut9E
CDik%3D

Pavadinimas	Tipas	Privalomas	Aprašymas	Pavyzdys
s	int	taip	WAP pirkimo paslaugos ID	2
si	string	ne	Vartotojo identifikatorius prenumeratinėje paslaugoje (pvz. slapyvardis). Naudojamas, jei į vieną prenumeratą tas pats vartotojas registruojamas kelis kartus, bet su skirtingu identifikatoriumi.	-
sr	string	taip	Prenumeratoriaus pagrindinė būsena (status), kuri nusako vartotojo aktyvumą prenumeratoje. Galimų reikšmių sąrašą rasite "Prenumeratorių būsenos"	active
srs	string	taip	Prenumeratoriaus papildoma būsena (state), kuri patikslina vartotojo nepavykusio apmokėjimo (registracijos, pratęsimo ir kt.) priežastį. Galimų reikšmių sąrašą rasite Prenumeratorių būsenos	active
i	string	taip	Išorinės sistemos identifikatorius unikaliai nusakantis vykdomą apmokėjimo įvykį (transakciją).	1255530969
t	int	taip	Apmokėjimo įvykio (transakcijos) unikalus identifikatorius MBS sistemoje	2331494
a	int	taip	Apmokestinto vartotojo unikalus identifikatorius MBS sistemoje (account_id)	1
s1	string	taip	Saugumo parašas (žemesnio patikimumo)	-
s2	string	taip	Saugumo parašas (aukščiausio patikimumo)	-

Dėmesio!

Vartotojui grįžus į paslaugos adresą, būtina tikrinti saugumo parašą (parametras 's1' arba 's2'). Taip užtikrinama, jog kreipimąsi atliko MBS.

Vartotojui grįžus į paslaugos adresą, būtina tikrinti prenumeratoriaus būseną (parametras 'sr' arba 'srs'). Taip užtikrinama, jog nesuteiksite paslaugos už nesėkmingai pasibaigusią registraciją.

Vartotojui grįžus į paslaugos adresą, galite tikrinti, ar registruotas tas pats vartotojas, kuris naršo paslaugoje (parametras 'a'). Taip užtikrinama, jog nesuteiksite paslaugos net suimitavus svetimos registracijos grįžimą.

Pavyzdys (pavyzdinė biblioteka)

PHP biblioteką, naudojamą susijungti su MBS, galite parsisiųsti atsidarę šią nuorodą: MBS biblioteka

Paslaugų atsisakymas

Norėdami atsisakyti prenumeratinių paslaugų siųskite SMS numeriu 1679 su tekstu STOP. Žinutės kaina 0.09 Eur.

Skaityti daugiau

Klausimai - atsakymai