Class: MBS
Source Location: /lib/MBS.class.php
MBSBase
|
--MBS
WAP apmokėjimų klasė
Author(s):
|
|
|
Inherited Variables
|
Inherited Methods
|
Class Details
Class Variables
Class Methods
constructor MBS [line 84]
MBS MBS(
int
$service_id, [int
$channel_id = null], [string
$back_url = null], [string
$secret_key = null])
|
|
Wap paslaugų apmokėjimų klasės konstruktorius Konstruktoriu nustatome paslaugos identifikatorių $service_id ir kanalo identifikatorių $channle_id.
Jeigu $back_url nenurodyta gražinimui bus naudojami URL nurodyti paslaugos aprašymuose. Papildomai galima nurodyti $back_url, tokiu atvėju vartotojas iš Vero MBS sistemos ( po apmokęstinimo ) bus gražinamas nurodytą nuorodą.
Taip pat nuorodoje galima naudoti žymenis: - %t arba %{transaction_id}% - pakeistas į naudojamos transakcijos ID
- %s or %{service_id}% - pakeistas į naudojamos paslaugos(service) ID
- %c or %{channel_id}% - pakeistas į naudojamo kanalo (channel) ID
- %p or %{transaction_price} - pakeistas į paslaugos kainą
- %cur or %{transaction_currency} - pakeistas į paslaugos kainos valiutą
- %o or %{operator_id}%- pakeistas į vartotojo operatoriaus (operator) ID
- %a or %{account_id}%- pakeistas į vartotojo identifikatorių (account) ID
- %n or %{operator_name}% - pakeistas į vartotojo operatoriaus pavadinimą (pvz.: bite_lt, tele2_lv, ect.)
Šie žymenis bus pakeisti atitinkamomis reikšmėmis. Pvz.: $back_url nustatome į http://example.lt?trans=%t&s=%s&service=%{service_id}%&a=teĮvykdytos transakcijos id buvo 2456 naudotos paslaugos (service_id) 1 tokiu atveju vartotojas bus gražintas nuoroda: http://example.lt?trans=2456&s=1&service=1&a=te
Parameters:
method bill [line 125]
void bill(
array
$params, [string
$lang = null], [string
$ident = null], [integer
$price = null], [string
$currency = null])
|
|
Vykdomas vartotojo apmokestinimas. Atlikus šį metodą vartotojas bus nukreiptas į Vero sistemą ir programos darbas nutrauktas.
Parametras $params nusako kokie parametrai bus gražinami atgal (žiūrėti į konstruktorių apie $back_url.)
Parametras $lang nurodo kokia kalba vartotojas matys pranešimus Vero sistemoje. Jei paslaugos parametras rodyti klausymą nurodytas. Tai šis parametras nurodo kokia kalba rodyti klausymą.
Parametras $ident nenaudojamas, bet yra numatytas sistemoje. Ateityje gali būti tikrinama ar tas pats vartotojas už tokį ident jau mokėjo valandos bėgyje. Kad nebūtu daug kartiniai vartotojo apmokestinimai.
Parameters:
method billRedirect [line 149]
void billRedirect(
[array
$params = array()], [string
$ident = null], [integer
$price = null], [string
$currency = null], [string
$url_false = null])
|
|
Vartotojo WAP apmokestinims redirect būdu. Žiūrėkite Bill platesniam aprašymui.
Tags:
Parameters:
method commitTransaction [line 341]
boolean commitTransaction(
int
$transaction_id)
|
|
Apmokestinimo tvirtinimas tranzakcijos pabaigimas. Grąžinama ar pavyko patvirtinti tranzakciją. Skirtas parodyti, kad veiksmai su tranzakcija pilnai baigti. Sukuriant tranzakciją vartotojo pinigai nuskaičiuojami(rezervuojami). Suteikus vartotojui paslaugą reikia patvirtinti, kad pinigai būtu galutinai nuskaičiuoti.
Ateityje ruošiamas padaryti, kad šio veiksmo daryti nereiks ir jeigu tranzakcija nėra baigta "commit", tai po tam tikro laiko automatiškai pritaikomas šis veiksmas ( jeigu tranzakcija ne atšaukta ).
Parameters:
method createTransaction [line 419]
int|boolean createTransaction(
int
$service_id, [int
$channel_id = null], [string
$language_ident = null], [array
$options = array()], [string
$ident = null], [integer
$price = null], [string
$currency = null])
|
|
Kuriama tranzakcija Veiksmas atliekamas prieš apmokestinimą. Naudojama metode Bill Vykdoma tiesioginė SOAP užklausa. $options – parametrai kurie paduodami į tranzakciją ir vėliau galim juos pasiimti jeigu pasulaugos kūrimo metu į nuorodas yra įrašyti forma %{my_<parametro vardas>}%. Galima naudoti parametrą url kuris bus nurodo į kokią nuorodą grąžinti po apmokestinimo detaliau aprašyta prie MBS konstruktoriaus.
Norint paduoti toki masyva: array(
'key1'=>'value1',
'key2'=>'value2',
)
Reikia jį transformuoti į: array(
array('name'=>'key1', 'value'=>'value1'),
array('name'=>'key2', 'value'=>'value2'),
)
Tags:
Parameters:
method getBillInformation [line 177]
array getBillInformation(
)
|
|
Nustatoma ar vartotojo grąžintas iš MBS po apmokestinimo jei taip, apmokestinimo duomenys užkraunami.
Tags:
method getTransaction [line 255]
array|boolean getTransaction(
int
$transaction_id)
|
|
Pagal $transaction_id gražinama tranzakcijos informacija. Jeigu atitinkamos tranzakcijos nėra arba tranzakcijos parametrai - paslaugos ir kanalo arba paslaugos, kainos ir valiutos identifikatoriai nesutampa su reikalaujamos tranzakcijos, gražinama false reikšmė.
Grąžinamo masyvo struktūra 1.0 versijai: array(
'transaction_id' => <tranzakcijos ID>
'service_id' => <paslaugos ID>
'channel_id' => <kanalo ID>
'account_id' => < vartotojo identifikatorius (account_id Vero MBS sistemoje)>
'state' => < tranzakcijos < a href= "{ $subdir}MBSLib/MBSBase.html#methodgetStatusDescription"> būsena</ a> (galimos reikšmės aprašytos prie metodo getStatusDescription)>
)
Grąžinamo masyvo struktūra 1.1 versijai: array(
'transaction_id' => <tranzakcijos ID>
'service_id' => <paslaugos ID>
'account_id' => < vartotojo identifikatorius (account_id Vero MBS sistemoje)>
'price' => <paslaugos kaina centais>
'currency' => <paslaugos kainos valiutos kodas>
'state' => < tranzakcijos < a href= "{ $subdir}MBSLib/MBSBase.html#methodgetStatusDescription"> būsena</ a> (galimos reikšmės aprašytos prie metodo getStatusDescription)>
)
!SVARBU!Norint įsitikinti, kad vartotojas neapgaudinėja reiktu tikrinti ar vartotojo account_id tokia kaip tranzakcijos.
Tags:
Parameters:
method getTransactionInState [line 475]
array|boolean getTransactionInState(
int
$transaction_id, string
$state)
|
|
Grąžinama tranzakcija transaction_id jeigu jos būsena reikšmė yra $state. Grąžinamo masyvo struktūra 1.0 versijai: array(
'transaction_id' => <tranzakcijos ID>
'service_id' => <paslaugos ID>
'channel_id' => <kanalo ID>
'account_id' => < vartotojo identifikatorius (account_id Vero MBS sistemoje)>
'state' => < tranzakcijos < a href= "{ $subdir}MBSLib/MBSBase.html#methodgetStatusDescription"> būsena</ a> (galimos reikšmės aprašytos prie metodo getStatusDescription)>
Grąžinamo masyvo struktūra 1.1 versijai: array(
'transaction_id' => <tranzakcijos ID>
'service_id' => <paslaugos ID>
'account_id' => < vartotojo identifikatorius (account_id Vero MBS sistemoje)>
'price' => <paslaugos kaina centais>
'currency' => <paslaugos kainos valiutos kodas>
'state' => < tranzakcijos < a href= "{ $subdir}MBSLib/MBSBase.html#methodgetStatusDescription"> būsena</ a> (galimos reikšmės aprašytos prie metodo getStatusDescription)>
Tags:
Parameters:
method isBilled [line 292]
boolean isBilled(
int
$transaction_id)
|
|
Patikrinama ar už tranzakciją yra sumokėta. Užmokėta tranzakcija yra jeigu sutampa paslaugos identifikatorius ir kanalas su sukurto objekto ir tranzakcijos būsena yra "commit".
Tags:
Parameters:
method isCommited [line 313]
boolean isCommited(
int
$transaction_id)
|
|
Tikrinama ar tranzakcija sėkmingai baigta ir ar neįvyko klaidų tikrinant tranzakciją.
Parameters:
method rollBackTransaction [line 366]
boolean rollBackTransaction(
int
$transaction_id)
|
|
Atšaukiamas vartotojo apmokestinimas vartotojui pinigai gražinami. Jeigu veiksmas nepavyko grąžinamas rezultatas false jei viskas sėkmingai pavyko grąžinama true. Šį veiksmą reikia atlikti tuo atveju jeigu nepavyko suteikti vartotojui paslaugos pvz.: nepavyko pristatyti turinio vartotojui.
!SVARBU! Nevisiems operatoriams galima atlikti šį veiksmą.
Parameters:
|
|