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

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

Skaityti daugiau