Class: Direct
Source Location: /lib/Direct.class.php
MBSBase
|
--Direct
Direct apmokėjimų klasė
Author(s):
|
|
|
Inherited Variables
|
Inherited Methods
|
Class Details
Class Variables
Class Methods
constructor Direct [line 63]
Direct Direct(
int
$service_id, [string
$url_delivery = null], [string
$secret_key = null])
|
|
Direct paslaugų apmokėjimų klasės konstruktorius Konstruktoriuje nustatome paslaugos identifikatorių $service_id. Taip pat, suteikiama galimybė sukonfiguruoti paslaugos apmokėjimo ataskaitų URL ir slaptažodį saugumui.
Parameters:
method bill [line 153]
struct|boolean bill(
int
$account_id, [string
$ident = null], [string
$mt_type = null], [string
$mt_text = null], [string
$mt_url = null], [integer
$price = null], [string
$currency = null], [string
$language = null], [array
$options = array()])
|
|
Vykdoma tiesioginė SOAP užklausa, kurios metu įvykdomas vartotojo apmokėjimas ir išsiunčimas nurodytas turininio vienetas (SMS, WapPush). Vartotojo apmokėjimą galima vykdyti, jei prieš tai jis užsiregistravo į paslaugą vienu iš MBS kanalų (siųsdamas SMS, WAP redirect ir pan.). Taip pat yra ribojamas turinio siuntimo dažnumas (pvz., ne daugiau kaip 2 SMS per savaitę, 1 SMS per dieną ir pan.). Jei reikalingas apmokėjimo rezultatas, jis bus perduotas vėliau į apmokėjimo ataskaitų URL. $ident - parametras naudojamas informatyvumo tikslais, bet yra numatyta, kad ateityje gali būti tikrinama ar tas pats vartotojas už tokį ident jau mokėjo valandos bėgyje. Kad nebūtu vykdomi daukartiniai vartotojo apmokestinimai. Parametras $language - Nepadavinėkite, jei nežinote vartotojo norimos kalbos. Parametras nurodo kokia kalba vartotojas matys pranešimus MBS sistemoje. Taip pat, šis parametras nurodo kokia kalba siųsti apmokestinimo SMS žinutę. $options – parametrai kurie paduodami į tranzakciją ir vėliau galim juos pasiimti jeigu paslaugos 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 billByMSISDN [line 198]
struct|boolean billByMSISDN(
string
$account_msisdn, [string
$operator = null], [string
$ident = null], [string
$mt_type = null], [string
$mt_text = null], [string
$mt_url = null], [integer
$price = null], [string
$currency = null], [string
$language = null], [array
$options = array()])
|
|
Vykdoma tiesioginė SOAP užklausa, kurios metu įvykdomas vartotojo apmokėjimas ir išsiunčimas nurodytas turininio vienetas (SMS, WapPush). Vartotojo apmokėjimą galima vykdyti, jei prieš tai jis užsiregistravo į paslaugą vienu iš MBS kanalų (siųsdamas SMS, WAP redirect ir pan.). Taip pat yra ribojamas turinio siuntimo dažnumas (pvz., ne daugiau kaip 2 SMS per savaitę, 1 SMS per dieną ir pan.). Jei reikalingas apmokėjimo rezultatas, jis bus perduotas vėliau į apmokėjimo ataskaitų URL.
Tags:
Parameters:
method commitTransaction [line 315]
boolean commitTransaction(
int
$transaction_id)
|
|
Apmokestinimo tvirtinimas. 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.
Tags:
Parameters:
method getBillInformation [line 355]
struct|boolean getBillInformation(
)
|
|
Metodas naudojamas apmokestinimo ataskaitos duomenims nuskaityti. Patikrinama ar apmokestinimo ataskaita atsiųsta iš MBS. Nustatomi ir užkraunami apmokestinimo įvykio (tranzakcijos) duomenys.
Tags:
method getTransaction [line 260]
struct|boolean getTransaction(
int
$transaction_id)
|
|
Gražinama norimos tranzakcijos informacija. Jeigu atitinkamos tranzakcijos nėra arba tranzakcijos parametrai - paslaugos identifikatoriai nesutampa su reikalaujamos tranzakcijos, gražinama false reikšmė. Tranzakcijos duomenų struktūra: array(
'transaction_id' - Unikalus transakcijos ID
'service_id' - Unikalus paslaugos ID
'ident' - Unikalus pirkimo identifikatorius išorinėje sistemoje
'operator' - Apmokestinamo vartotojo operatorius (bite_lt, tele2_lv ir tt.)
'account_id' - Unikalus vartotojo ID MBS sistemoje
'account_msisdn' - Apmokestinamo vartotojo telefono numeris (MSISDN), tarptautiniu formatu „370xxxyyyyy“
'account_ident' - WAP vartotojo identifikatorius operatoriaus sistemoje. Unikalus kiekvieno operatoriaus sistemoje.
'account_type' - Apmokestinamo vartotojo mokėjimo tipas (prepaid, postpaid, unknwon, testing)
'price' - Apmokestinimo suma, nurodoma centais
'tariff' - Apmokestinimo suma operatoriaus sistemoje, nurodoma centais
'currency' - Apmokestinimo valiuta (ISO 4217 standartu, EUR, LTL, LVL ir tt.)
'mt_type' - Vartotojo informavimo tipas (SMS, WapPush)
'mt_text' - Siunčiamo SMS tekstas (jei WapPush, nuorodos antraštė)
'mt_url' - Jei siuntinio tipas WapPush, siunčiamo WapPush nuoroda
'status' - Apmokestinimo transakcijos pagrindinė būsena (status), kuri nusako apmokėjimo sėkmingumą.commit
'state' - Apmokestinimo transakcijos papildoma būsena (state), kuri patikslina nepavykusio apmokėjimo priežastį (galimos reikšmės aprašytos prie metodo getStatusDescription)
'options' - Papildomi apmokestinimui naudoti parametrai, pvz. sesijos ID
)
Tags:
Parameters:
method getTransactionInStatus [line 287]
array|boolean getTransactionInStatus(
int
$transaction_id, string
$status, [string
$state = null])
|
|
Grąžinama tranzakcija transaction_id jeigu jos būsena yra lygi norimam $status
Tags:
Parameters:
method isBilled [line 416]
boolean isBilled(
int
$transaction_id)
|
|
Patikrinama ar už tranzakciją yra sumokėta. Užmokėta tranzakcija yra jeigu sutampa paslaugos identifikatorius bei sukurto objekto ir tranzakcijos būsena yra "commit".
Tags:
Parameters:
method isCommited [line 441]
boolean isCommited(
int
$transaction_id)
|
|
Tikrinama ar tranzakcija sėkmingai baigta ir ar neįvyko klaidų tikrinant tranzakciją.
Parameters:
method rollBackTransaction [line 337]
boolean rollBackTransaction(
int
$transaction_id)
|
|
Atšaukiamas vartotojo apmokestinimas, vartotojui pinigai grąžinami. Šį veiksmą reikia atlikti tuo atveju jeigu nepavyko suteikti vartotojui paslaugos pvz.: nepavyko pristatyti turinio vartotojui. !SVARBU! Nevisiems operatoriams galima atlikti šį veiksmą.
Tags:
Parameters:
method setUrlDelivery [line 100]
void setUrlDelivery(
string
$url_delivery)
|
|
Sukonfiguruojamas apmokėjimo ataskaitų URL. Taip pat nuorodoje $url_delivery galima naudoti žymenis: - %t arba %{transaction_id}% - pakeistas į naudojamos transakcijos ID
- %s or %{service_id}% - pakeistas į naudojamos paslaugos(service) 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 žymenys bus pakeisti atitinkamomis reikšmėmis. Pvz.: $url_delivery 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:
|
|