MBSLib
[ class tree: MBSLib ] [ index: MBSLib ] [ all elements ]

Class: SBBS

Source Location: /lib/SBBS.class.php

Class Overview

MBSBase
   |
   --SBBS

Vartotojų valdymo Vero SBBS(MBS) prenumeratų sistemoje


Author(s):

Variables

Methods


Inherited Variables

Inherited Methods

Class: MBSBase

MBSBase::MBSBase()
Konstruktorius, neatliekantis jokiu konkrečių veiksmų
MBSBase::debug()
Kaupiame debug informaciją $msg jeigu klasės savybės $debug_level yra mažesnis arba lygus $need_level.
MBSBase::formatUrl()
Grąžina "suklijuotus" URL parametrus
MBSBase::getDebug()
Gražinama sukaupta debug informacija.
MBSBase::getError()
Grąžinami klaidų pranešimai
MBSBase::getStatusDescription()
Pagal tranzakcijos state reikšmę grąžiną state aprašymą.
MBSBase::initSoap()
Nustatoma naudojama SOAP klasė ir SOAP adresui priskiriama paduota reikšmė $url
MBSBase::isError()
Gražinama ar įvyko klaida
MBSBase::prepareParams()
Paruošia URL parametrus. Jeigu $this->back_url nustatytas, tuomet visi šie parametrais sudedami į $this->back_url
MBSBase::setBackUrl()
Nustatomas gražinimo url. Jis gali būti bet koks. Jeigu yra galimybė iš Vero(MBS) platformos bus bandom nukreipti vartotoją į šią nuorodą. Nuorodoje galima naudoti parametrus, gražinant vartotoją į nuorodą bus pakeisti reikšmėmis.
MBSBase::setDebug()
Nustatomas debug kaupimo lygis į $level ir kaupimo tipas į $type.
MBSBase::setError()
Nustatomas klaidos pranešimas su debug lygiu DEBUG_LEVEL_LOW
MBSBase::setSecretKey()
Nustatomas slaptas žodis, kuris bus naudojamas saugumo parašui
MBSBase::setSessionUse()
Nustatoma ar saugoti duomenis sesijoje
MBSBase::signArrayLow()
Pasirašo pateiktus parametrus žemo patikimumo parašu
MBSBase::signUrlLow()
Pasirašo pateiktą URL žemo patikimumo parašu
MBSBase::verifyArrayHigh()
Patikrina ar parametrai teisingai pasirašyti aukštu patikimumu
MBSBase::verifyArrayLow()
Patikrina ar parametrai teisingai pasirašyti žemu patikimumu
MBSBase::verifyUrlHigh()
Patikrina ar URL turi teisingą aukšto patikimumo parašą
MBSBase::verifyUrlLow()
Patikrina ar URL turi teisingą žemo patikimumo parašą
MBSBase::_CallNuSOAP()
SOAP metodo kvietimas naudojantis NuSOAP biblioteka
MBSBase::_CallSOAP()
SOAP metodo kvietimas naudojantis PHP SOAP moduliu.
MBSBase::_prepareParams()
Paruošiami parametrai pagal "JArray" tipą (naudojamas soap metoduose), kiekvienam masyvo $params elementui
MBSBase::_SOAPCall()
SOAP metodo kvietimas. Naudojantis nustatyta soap klasė

Class Details

[line 36]
Vartotojų valdymo Vero SBBS(MBS) prenumeratų sistemoje

Kuriant objektą reikia naudoti apmokestinimo wap paslaugos identifikatorių ir kanalą, nes registruojant į paslaugą naudojamas wap apmokestinimo parametrai. Tačiau atlikus reigistraciją vartotojas yra registruojamas į prenumeratinę paslaugą, kurios identifikatorius kitas

Registravimo į prenumeratą pavyzdžiai:

  1. <?php
  2. /**
  3.  * Raw WAP registration example (using redirect)
  4.  * 
  5.  * @see MBSLib/examples/simple/wap_register.php
  6.  *
  7.  * @package RawExamples
  8.  * @author Valdas Petrulis <vpe@vero.lt>
  9.  */
  10.  
  11. include_once(dirname(__FILE__).'/../../lib/Identify.class.php');
  12. include_once(dirname(__FILE__).'/../../lib/SBBS.class.php');
  13.  
  14. // Inicijuojame MBS identifikavimo biblioteką
  15. define('IDENTIFY_SERVICE_ID'1);
  16. define('IDENTIFY_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  17. define('IDENTIFY_SECRET_KEY''test');
  18.  
  19. // Inicijuojame MBS apmokėjimų biblioteką
  20. define('SBBS_MBS_SERVICE_ID'2);
  21. define('SBBS_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  22. define('SBBS_SECRET_KEY''test');
  23.  
  24. // Identifikuojame vartotoją
  25. if (!$identify->isIdentified()) {
  26.     $identify->MakeIdentify(session_id()array());
  27. }
  28.  
  29. // Registracijos inicijavimas
  30. if (!isset($_GET['after_register'])){
  31.     // Registruojame, tik jei vartotojas dar nera registruotas
  32.     if (!$identify->getSubscriberStatus()!='active'{
  33.         // Čia vartotojas bus nukreipiamas į MBS registruotis
  34.         $sbbs->registerRedirect(array(
  35.             'session_id' => session_id(),
  36.             'after_register' => 'yes',
  37.         )time());
  38.     // Jau registruotas vartotojas
  39.     else {
  40.         echo "Vartotojas jau buvote registruotas";
  41.     }
  42. // Registracijos pabaiga ir GET rasti teisingi duomenys
  43. else if ($transaction=$sbbs->getRegisterInformation()) {
  44.     // Registracija sėkminga
  45.     if ($transaction['subscriber_status']=='active' {
  46.         echo 'Vartotojas sėkmingai užregistruotas';
  47.     // Registracija nepavyko
  48.     else {
  49.         echo 'Vartotojo užregistruoti nepavyko';
  50.     }
  51. // Registracijos pabaiga, bet GET duomenys neteisingi
  52. else {
  53.     echo "Registracijos klaida: ".$sbbs->getError();
  54. }
  55.  
  56. ?>
  1. <?php
  2. /**
  3.  * Raw WAP registration example (using SOAP service and redirect)
  4.  * 
  5.  * @see MBSLib/examples/simple/wap_register_soap.php
  6.  *
  7.  * @package RawExamples
  8.  * @author Šarūnas Davalga <sd@vero.lt>
  9.  */
  10.  
  11. include_once(dirname(__FILE__).'/../../lib/Identify.class.php');
  12. include_once(dirname(__FILE__).'/../../lib/SBBS.class.php');
  13.  
  14. // Inicijuojame MBS identifikavimo biblioteką
  15. define('IDENTIFY_SERVICE_ID'1);
  16. define('IDENTIFY_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  17. define('IDENTIFY_SECRET_KEY''test');
  18.  
  19. // Inicijuojame SBBS apmokėjimų biblioteką
  20. define('SBBS_MBS_SERVICE_ID'2);
  21. define('SBBS_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  22. $sbbs new SBBS(SBBS_MBS_SERVICE_IDnullSBBS_BACK_URL);
  23.  
  24. // Identifikuojame vartotoją
  25. if (!$identify->isIdentified()) {
  26.     $identify->MakeIdentify(session_id()array());
  27. }
  28.  
  29. // Registracijos inicijavimas
  30. if (!isset($_GET['after_register'])) {
  31.     // Registruojame, tik jei vartotojas dar nera registruotas
  32.     if (!$sbbs->isActive($identify->getAccount())) {
  33.         $sbbs->register(array(
  34.             'session_id' => session_id(),
  35.             'after_register' => 'yes',
  36.             't' => '%t'// čia MBS įrašys tranzakcijos ID
  37.             's' => '%s'// čia MBS įrašys paslaugos ID
  38.             'op' => '%n'// čia MBS įrašys operatoriaus ID
  39.             'a' => '%a'// čia MBS įrašys vartotojo ID
  40.         ));
  41.     // Jau registruotas vartotojas
  42.     else {
  43.         echo "Vartotojas jau buvote registruotas";
  44.     }
  45. // Registracijos pabaiga 
  46. else {
  47.     // Registracija sėkminga
  48.     if ($sbbs->isActive($identify->getAccount())) {
  49.         echo 'Vartotojas sėkmingai užregistruotas';
  50.         print_r($sbbs->GetInfo($identify->getAccount()));
  51.     // Registracija nepavyko
  52.     else {
  53.         echo 'Vartotojo užregistruoti nepavyko';
  54.     }
  55. }
  56.  
  57. ?>

Išregistravimo iš prenumeratos pavyzdžiai:

  1. <?php
  2. /**
  3.  * Raw WAP unregistration example (using redirect)
  4.  * 
  5.  * @see MBSLib/examples/simple/wap_unregister.php
  6.  *
  7.  * @package RawExamples
  8.  * @author Valdas Petrulis <vpe@vero.lt>
  9.  */
  10.  
  11. include_once(dirname(__FILE__).'/../../lib/SBBS.class.php');
  12.  
  13. // Inicijuojame SBBS apmokėjimų biblioteką
  14. define('SBBS_MBS_SERVICE_ID'2);
  15. define('SBBS_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  16. define('SBBS_SECRET_KEY''test');
  17.  
  18. // Išregistravimo inicijavimas
  19. if (!isset($_GET['after_unregister'])) {
  20.     $sbbs->unregisterRedirect(array(
  21.         'after_unregister' => 'yes',
  22.     )time());
  23. // Išregistravimo pabaiga ir GET rasti teisingi duomenys 
  24. else if ($transaction=$sbbs->getUnregisterInformation()) {
  25.     // Išregistravimas sėkmingas
  26.     if ($transaction['subscriber_status']=='removed' {
  27.         echo 'Vartotojas išregistruotas';
  28.     // Išregistravimas nepavyko
  29.     else {
  30.         echo 'Vartotojo išregistruoti nepavyko';
  31.     }
  32. // Išregistravimo pabaiga, bet GET duomenys neteisingi
  33. else {
  34.     echo "Išregistravimo klaida: ".$sbbs->getError();
  35. }
  36.  
  37. ?>
  1. <?php
  2. /**
  3.  * Raw WAP unregistration example (using SOAP service and redirect)
  4.  * 
  5.  * @see MBSLib/examples/simple/wap_unregister_soap.php
  6.  *
  7.  * @package RawExamples
  8.  * @author Šarūnas Davalga <sd@vero.lt>
  9.  */
  10.  
  11. include_once(dirname(__FILE__).'/../../lib/Identify.class.php');
  12. include_once(dirname(__FILE__).'/../../lib/SBBS.class.php');
  13.  
  14. // Inicijuojame MBS identifikavimo biblioteką
  15. define('IDENTIFY_SERVICE_ID'1);
  16. define('IDENTIFY_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  17. define('IDENTIFY_SECRET_KEY''test');
  18.  
  19. // Inicijuojame SBBS apmokėjimų biblioteką
  20. define('SBBS_MBS_SERVICE_ID'2);
  21. define('SBBS_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  22. $sbbs new SBBS(SBBS_MBS_SERVICE_IDnullSBBS_BACK_URL);
  23.  
  24. // Išregistravimo inicijavimas
  25. if (!isset($_GET['after_unregister'])) {
  26.     $sbbs->unregister(array(
  27.         'after_unregister' => 'yes',
  28.     ));
  29. // Išregistravimo pabaiga
  30. else {
  31.     // Išregistravimas sėkmingas
  32.     if ($sbbs->isActive($identify->getAccount())) {
  33.         echo 'Vartotojas išregistruotas';
  34.         print_r($sbbs->GetInfo($identify->getAccount()));
  35.     // Išregistravimas nepavyko
  36.     else {
  37.         echo 'Vartotojo išregistruoti nepavyko';
  38.     }
  39. }
  40.  
  41. ?>

Ataskaitų išorinei sistemai pavyzdžiai:

  1. <?php
  2. /**
  3.  * Raw subscribtion notify messages receiving example
  4.  * 
  5.  * @see MBSLib/examples/simple/notify_subscription.php
  6.  *
  7.  * @package RawExamples
  8.  * @author Valdas Petrulis <vpe@vero.lt>
  9.  */
  10.  
  11. // Inicijuojame MBS funkcijų biblioteką
  12. include_once(dirname(__FILE__).'/../../lib/MBS.class.php');
  13. $mbs_base new MBSBase();
  14. $mbs_base->setSecretKey('test');
  15.  
  16. // Konfigūracija
  17. $config['servers'array('213.226.139.33''213.226.139.42''213.226.139.43''193.105.49.4''193.105.49.5');
  18.  
  19. if in_array$_SERVER['REMOTE_ADDR']$config['servers') ) {
  20.     if$mbs_base->verifyArrayHigh($_GET) ) {
  21.         // Nusiskaitome pagrindinius pranesimo duomenis
  22.         $action $_GET['action'];
  23.         $mbs_service_id $_GET['serviceID'];
  24.         $mbs_account_id $_GET['mbs_account_id'];
  25.         $mbs_account_phone $_GET['mbs_account_phone'];
  26.         
  27.         // Paslaugos logika
  28.         switch ($action{
  29.             case 'register':
  30.             case 'resume':
  31.                 /** ... cia vartotojui suteikiama VIP prieiga ... **/
  32.                 $response array('OK');
  33.             break;
  34.  
  35.             case 'unregister':
  36.             case 'remove':
  37.             case 'suspend':
  38.                 /** ... cia vartotojui sustabdoma VIP prieiga ... **/
  39.                 $response array('OK');
  40.             break;
  41.  
  42.             case 'pay':
  43.             case 'renew':
  44.                 /** ... cia renkama statistika, kiek ivyko sekmingu pratesimu (VIP prieiga jau turetu butu suteikta) ... **/
  45.                 $response array('OK');
  46.             break;
  47.  
  48.             default:
  49.                 $response array('ERROR''Nezinomas pranesimo tipas');
  50.             break;
  51.         }
  52.     // Sufalsifikuoti GET parametrai
  53.     else {
  54.         $response array('ERROR''Siuntejas ne MBS');
  55.     }
  56. // Nežinomo serverio GET parametrai
  57. else {
  58.     $response array('ERROR''Nezinomas serveris');
  59. }
  60.  
  61. // Paslaugos atsakymas vartotojui
  62. echo implode(';'array_map('urlencode'$response));
  63.  
  64. ?>
  1. <?php
  2. /**
  3.  * Raw subscribtion notify messages receiving example (SBBS subsystem for foreign countries)
  4.  * 
  5.  * @see MBSLib/examples/simple/notify_sbbs.php
  6.  *
  7.  * @package RawExamples
  8.  * @author Valdas Petrulis <vpe@vero.lt>
  9.  */
  10.  
  11. define('SBBS_SUBSCRIPTION_SERVICE_ID'71);
  12. define('SBBS_SUBSCRIPTION_SECRET_KEY''test');
  13.  
  14. include_once(dirname(__FILE__).'/../../lib/SBBSNotify.class.php');
  15.  
  16. $notify_info $sbbs_notify->getNotifyInfo();
  17. if ($error=$sbbs_notify->getError()) {
  18.     return $sbbs_notify->showResponseError($error);
  19. }
  20.  
  21. // Saving got notification
  22. $result save_notify($notify_info);
  23. if ($result===true{
  24.     if user_exist($notify_info['subscribe_service_id']$notify_info['account_id']$notify_info['ident']) ) {
  25.         return $sbbs_notify->showResponse(true'User exist');
  26.     else {
  27.         return $sbbs_notify->showResponse(false'User does not exist');
  28.     }
  29. else {
  30.     return $sbbs_notify->showResponseError($result);
  31. }
  32.  
  33. /**
  34.  * Pseuto method for notification saving
  35.  *
  36.  * @param array $notify Notification data array
  37.  * 
  38.  * @bool|string TRUE or error string
  39.  */
  40. function save_notify($notify{
  41.     //return 'Failed to save';
  42.     return true;
  43. }
  44.  
  45. /**
  46.  * Pseudo method for subscriber existance checking
  47.  *
  48.  * @param int $service_id Subscription service id
  49.  * @param int $account_id Account id
  50.  * @param string $ident (optional) Extra account identifier for same service
  51.  * 
  52.  * @return bool 
  53.  */
  54. function user_exist($service_id$account_id$ident=''{
  55.     //return true;
  56.     return false;
  57. }
  58.  
  59. ?>




Tags:

author:  Liutauras Rickus <lr@vero.lt>


[ Top ]


Class Variables

$channel_id =  0

[line 53]

Kanalo identifikatorius



Tags:

access:  protected

Type:   int


[ Top ]

$service_id =  0

[line 45]

Paslaugos identifikatorius



Tags:

access:  protected

Type:   int


[ Top ]

$user_info = array()

[line 62]

Vartotojo informacija



Tags:

access:  protected

Type:   array


[ Top ]



Class Methods


constructor SBBS [line 94]

SBBS SBBS( int $service_id, [int $channel_id = null], [string $back_url = null], [string $secret_key = null])

SBBS klasės konstruktorius

Konstruktoriui 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. Jeigu jis nurodytas nusiustas vartotojas į Vero sistemą bus gražinamas šia nuorodą iš registracijos. 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
  • %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

Vartotojo išregistravimas neturi galimybės vartotoją gražinti į $bill_url. Ateityje planuojama tai pataisyti.




Parameters:

int   $service_id   WAP registracijos paslaugos identifikatorius
int   $channel_id   (nebūtina) Kanalo identifikatorius
string   $back_url   (nebūtina) URL kuriuo gražinti vartotoja po registracijos
string   $secret_key   (nebūtina) Slaptas žodis, kuris naudojamas saugumo parašui

[ Top ]

method getInfo [line 416]

array getInfo( int $account, [string $account_param = 'id'], [string $ident = null])

Grąžinama informacija apie vartotoją, kurio id yra $account_id.

Gražinam rasto vartotojo informaciją:

  1.  array(
  2.     'service_id' => paslauga (prenumeratos)
  3.     'channel_id' => paslaugos kanalas
  4.     'account_id' => vartotojo identifikatorius Vero sistemoje
  5.     'ident'  => Skirtas registruoti vartotoją į tą pačią paslaugą su skirtingais identifikatoriais
  6.     'state' => vartotojo Vero sistemos statusas galimos reikšmės ('open''subscribe''cancel''active',  'active_bill''suspended''remove''remove_op_wait''remove_wait')
  7.     'status' => vartotojų būsenos ('active' aktyvus'suspended' neaktyvus'removed' neaktyvus)
  8.     'register_date' => registracijos data>
  9.     'renew_date' => paskutinio atnaujinimo data
  10.     'next_renew_date' => sekančio apmokestinimo data
  11.     'valid_till' => vartotojo galiojimo periodas
  12.     'unregister_date' => išregistravimo data
  13.  )




Tags:

return:  Prenumeruoto vartotojo informacija


Parameters:

int   $account   Vartotojo identifikatorius Vero MBS sistemoje arba MSISDN ( telefono numeris )
string   $account_param   Nurodo ar buvo paduotas vartotojo identifikatorisu ( reikšmė 'id' ) ar MSISDN ( reikšmė 'phone' ), pagal nutylėjima paduodamas id
string   $ident   Vartotojo papildomas identifikatorius ( naudojamas su paslaugomis, kai galima registruoti vieną vartotoją daugiau negu vieną kartą į prenumeratą )

[ Top ]

method getRegisterInformation [line 152]

array getRegisterInformation( )

Nustatoma ar vartotojo grąžintas iš MBS po registracijos jei taip, apmokestinimo duomenys užkraunami.



Tags:

return:  Billing transaction data


[ Top ]

method getStatus [line 467]

string getStatus( int $account, [string $account_param = 'id'], [string $ident = null])

Grąžinamas vartotojo $account_id statusas prenumeratų sistemoje.

Statusai gali būti:




Tags:



Parameters:

int   $account   Vartotojo identifikatorius Vero MBS sistemoje arba MSISDN ( telefono numeris )
string   $account_param   Nurodo ar buvo paduotas vartotojo identifikatorisu ( reikšmė 'id' ) ar MSISDN ( reikšmė 'phone' ), pagal nutylėjima paduodamas id
string   $ident   Vartotojo papildomas identifikatorius ( naudojamas su paslaugomis, kai galima registruoti vieną vartotoją daugiau negu vieną kartą į prenumeratą )

[ Top ]

method getUnregisterInformation [line 229]

array getUnregisterInformation( )

Nustatoma ar vartotojo grąžintas iš MBS po išregistravimo jei taip, ivykio duomenys užkraunami.



Tags:

return:  Unregistration transaction data


[ Top ]

method getUserList [line 496]

array getUserList( int $account_id)

Gražinamas einamos paslaugos vartotojų sąrašas.

Sąrašas - masyvas kurio kiekviename elemente pateikima informacija:

  1.  array(
  2.     'service_id' => paslauga (prenumeratos)
  3.     'channel_id' => paslaugos kanalas
  4.     'account_id' => vartotojo identifikatorius Vero sistemoje
  5.     'ident'  => Skirtas registruoti vartotoją į tą pačią paslaugą su skirtingais identifikatoriais
  6.     'state' => vartotojo Vero sistemos statusas galimos reikšmės ('open''subscribe''cancel''active',  'active_bill''suspended''remove''remove_op_wait''remove_wait')
  7.     'status' => vartotojų būsenos ('active' aktyvus'suspended' neaktyvus'removed' neaktyvus)
  8.     'register_date' => registracijos data>
  9.     'renew_date' => paskutinio atnaujinimo data
  10.     'next_renew_date' => sekančio apmokestinimo data
  11.     'valid_till' => vartotojo galiojimo periodas
  12.     'unregister_date' => išregistravimo data
  13.  )




Tags:

return:  Vartotojo perenumeratų informacija


Parameters:

int   $account_id   Vartotojo identifikatorius Vero MBS sistemoje

[ Top ]

method isActive [line 447]

boolean isActive( int $account, [string $account_param = 'id'], [string $ident = null])

Patikrinama ar vartotojas $account_id gali naudotis paslaugomis (Ar yra aktyvus).



Parameters:

int   $account   Vartotojo identifikatorius Vero MBS sistemoje arba MSISDN ( telefono numeris )
string   $account_param   Nurodo ar buvo paduotas vartotojo identifikatorisu ( reikšmė 'id' ) ar MSISDN ( reikšmė 'phone' ), pagal nutylėjima paduodamas id
string   $ident   Vartotojo papildomas identifikatorius ( naudojamas su paslaugomis, kai galima registruoti vieną vartotoją daugiau negu vieną kartą į prenumeratą )

[ Top ]

method register [line 295]

void register( array $options, [string $lang_id = null], [string $ident = null], [string $valid_till = null])

Vykdomas registravimas į prenumeratą.

Atlikus šį metodą vartotojas bus nukreiptas į Vero sistemą ir programos darbas nutrauktas.

Parametras $options 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 taip pat nurodo kokia kalba rodyti klausimą. Kalbos kodas ISO 639-1 standartu.

Parametras $ident Skirtas vienam vartotojui būti registruotam vienoje prenumeratoje kelis kartus naudojant skirtingą šį parametrą.

Parametras $valid_till Skirtas nurodyti kiek laiko po registracijos vartotojui galios prenumerata.




Parameters:

array   $options   Papildomi parametrai, kuriuos MBS pridės prie atgalinio URL po registracijos
string   $lang_id   Kalbos kodas ISO 639-1 standartu ( naudojamas rodant klausimą )
string   $ident   Papildomas registruoto vartotojo identifikatorius ( kai norima viena vartotoja registruoti į prenumeratą daugiau negu vieną karta ) !Dar neveikia!
string   $valid_till   Data, iki kurios galios prenumerata

[ Top ]

method registerRedirect [line 123]

void registerRedirect( [array $params = array()], [string $ident = null], [string $subscriber_ident = null], [integer $price = null], [string $currency = null], [string $url_false = null])

Vartotojo registravimas į prenumeratą redirect būdu.



Parameters:

array   $params   (nebūtina) Papildomi parametrai, kurie bus gražinami atgal
string   $ident   (nebūtina) Unikalus pirkimo identifikatorius partnerio sistemoje
string   $subscriber_ident   (nebūtina) Prenumeratoriaus identifikatorius paslaugoje (jei galima registruotis į vieną paslaugą kelis kartus)
integer   $price   (nebūtina) Registracijos kaina, reikia nurodyti, kai paslauga turi kelias kainas (valiutos 1/100 dalimis - centais)
string   $currency   (nebūtina) Kainos valiuta
string   $url_false   (nebūtina) URL, į kurį nukreipiama po nesėkmingos registracijos

[ Top ]

method registerUrl [line 321]

string registerUrl( array $options, [string $lang_id = null], [string $ident = null], [string $valid_till = null])

Gražinama nuoroda, kurią vartotojas turi būti nukreipiamas, kad vartotojas būtu registruotas į prenumeratą.

Parametrai identiški register metodui.




Tags:



Parameters:

array   $options   Papildomi parametrai, kuriuos MBS pridės prie atgalinio URL po registracijos
string   $lang_id   Kalbos kodas ISO 639-1 standartu ( naudojamas rodant klausimą )
string   $ident   Papildomas registruoto vartotojo identifikatorius ( kai norima viena vartotoja registruoti į prenumeratą daugiau negu vieną karta ) !Dar neveikia!
string   $valid_till   Data, iki kurios galios prenumerata

[ Top ]

method SubscriptionGet [line 666]

array SubscriptionGet( [int $wap_service_id = null], int $service_id, int $account_id, [string $ident = null])

Gražinama informacija apie vartotoją $account_id.

Vienas parametras $wap_service_id arba $service_id turi būti netuščias.

  • Parametras $wap_service_id – paslaugos, kuri naudojama WAP registracijai/apmokestinimui.
  • Parametras $service_id – prenumeratinės paslaugos identifikatorius.
  • Parametras $ident – vartotojo identifikatorius paslaugoje (jei registruojamas į tą pačią paslaugą kelis kartus).
Grąžinamas vartotojo informacija kaip aprašyta getInfo metode.

Gražinama struktūra:

  1.  array(
  2.     'service_id' => paslauga (prenumeratos)
  3.     'channel_id' => paslaugos kanalas
  4.     'account_id' => vartotojo identifikatorius Vero sistemoje
  5.     'ident'  => Skirtas registruoti vartotoją į tą pačią paslaugą su skirtingais identifikatoriais
  6.     'state' => vartotojo Vero sistemos statusas galimos reikšmės ('open''subscribe''cancel''active',  'active_bill''suspended''remove''remove_op_wait''remove_wait')
  7.     'status' => vartotojų būsenos ('active' aktyvus'suspended' neaktyvus'removed' neaktyvus)
  8.     'register_date' => registracijos data>
  9.     'renew_date' => paskutinio atnaujinimo data
  10.     'next_renew_date' => sekančio apmokestinimo data
  11.     'valid_till' => vartotojo galiojimo periodas
  12.     'unregister_date' => išregistravimo data
  13.  )




Parameters:

int   $wap_service_id   Wap paslaugos identifikatorius
int   $service_id   Prenumeratinės paslaugos identifikatorius
int   $account_id   Vartotojo identifikatorius Vero MBS sistemoje
string   $ident   Skirtas vienam vartotojui būti registruotam vienoje prenumeratoje kelis kartus naudojant skirtingą šį parametrą.

[ Top ]

method SubscriptionGetByMSISDN [line 694]

array SubscriptionGetByMSISDN( [int $wap_service_id = null], int $service_id, $account_phone, [string $ident = null], int $account_id)

Metodas analogiškas SubscriptionGet, tik gražina informaciją ne pagal vartotojo identifikatorių o pagal MSISDN ( telefono numerį ) Vienas parametras $wap_service_id arba $service_id turi būti netuščias.



Tags:

return:  Vartotojo informacija tokia pati kaip SubscriptionGet metodo
see:  SBBS::SubscriptionGet()


Parameters:

int   $wap_service_id   Wap paslaugos identifikatorius
int   $service_id   Prenumeratinės paslaugos identifikatorius
int   $account_id   Vartotojo identifikatorius Vero MBS sistemoje
string   $ident   Skirtas vienam vartotojui būti registruotam vienoje prenumeratoje kelis kartus naudojant skirtingą šį parametrą.
   $account_phone  

[ Top ]

method SubscriptionGetList [line 744]

array SubscriptionGetList( int $account_id, [int $wap_service_id = null], int $service_id, int $channel_id)

Gražinami visi paslaugos vartotojai.

Vienas parametras $wap_service_id arba $service_id turi būti netuščias.

  • Parametras $wap_service_id – paslaugos, kuri naudojama WAP registracijai/apmokestinimui.
  • Parametras $service_id – prenumeratinės paslaugos identifikatorius.
$channel_id – paslaugos kanalas, kuri yra įvesta.

Grąžinamas vartotojų sąrašas ( masyvas ) kurio kiekvieno elemento struktūra:

  1.  array(
  2.     'service_id' => paslauga (prenumeratos)
  3.     'channel_id' => paslaugos kanalas
  4.     'account_id' => vartotojo identifikatorius Vero sistemoje
  5.     'ident'  => Skirtas registruoti vartotoją į tą pačią paslaugą su skirtingais identifikatoriais
  6.     'state' => vartotojo Vero sistemos statusas galimos reikšmės ('open''subscribe''cancel''active',  'active_bill''suspended''remove''remove_op_wait''remove_wait')
  7.     'status' => vartotojų būsenos ('active' aktyvus'suspended' neaktyvus'removed' neaktyvus)
  8.     'register_date' => registracijos data>
  9.     'renew_date' => paskutinio atnaujinimo data
  10.     'next_renew_date' => sekančio apmokestinimo data
  11.     'valid_till' => vartotojo galiojimo periodas
  12.     'unregister_date' => išregistravimo data
  13.  )




Tags:

return:  Vartotojų sąrašas


Parameters:

int   $account_id   Vartotojo identifikatorius Vero MBS sistemoje
int   $wap_service_id   Wap paslaugos identifikatorius
int   $service_id   Prenumeratinės paslaugos identifikatorius
int   $channel_id   Kanalo identifikatorius

[ Top ]

method SubscriptionGetListByMSISDN [line 773]

array SubscriptionGetListByMSISDN( int $account_phone, [int $wap_service_id = null], int $service_id, int $channel_id)

Atlika tą patį ka ir SubscriptionGetList metodas, tik vietoj vartotojo identifikatoriaus galima naudoti MSISDN ( telefono numerį )

Vienas parametras $wap_service_id arba $service_id turi būti netuščias.




Tags:

return:  Vartotojų sąrašas, detaliau žiūrėkite SubscriptionGetList metodo aprašymą
see:  SBBS::SubscriptionGetList()


Parameters:

int   $account_phone   Vartotojo telefono numeris
int   $wap_service_id   Wap paslaugos identifikatorius
int   $service_id   Prenumeratinės paslaugos identifikatorius
int   $channel_id   Kanalo identifikatorius

[ Top ]

method SubscriptionRegister [line 583]

string SubscriptionRegister( int $service_id, int $account_id, [int $channel_id = null], [string $lang_identi = null], [array $options = array()], [string $ident = null], [string $valid_till = null])

Registruojamas vartotojas į paslaugą.

Metodas grąžina URL, kuriuo reikia nukreipti vartotoją, kad galutinai jis būtu užregistruotas. Jei URL negražino, vartotojas jau užregistruotas.




Tags:

return:  URL


Parameters:

int   $service_id   Prenumeratinės paslaugos identifikatorius
int   $account_id   Vartotojo identifikatorius Vero MBS sistemoje
int   $channel_id   Kanalo identifikatorius
string   $lang_identi   kalbos kodas ,kuria bus rodomi pranešimai ISO 639-1 standartu.
array   $options   parametrai kurie bus grąžinami.
string   $ident   Skirtas vienam vartotojui būti registruotam vienoje prenumeratoje kelis kartus naudojant skirtingą šį parametrą.
string   $valid_till   Nurodo data ir laiką, iki kada galios vartotojo prenumerata

[ Top ]

method SubscriptionUnregister [line 613]

void SubscriptionUnregister( int $service_id, int $account_id, [string $lang_identi = null], [array $options = array()], [string $ident = null], [string $unregister_reason = null])

Vartotojo išregistravimas.

Metodas grąžina URL, kuriuo reikia nukreipti vartotoją, kad galutinai jis būtu išregistruotas. Jei URL negrazino, vartotojas jau išregistruotas.




Parameters:

int   $service_id   Prenumeratinės paslaugs identifikatorius
int   $account_id   Vartotjo identifikatorius Vero MBS sistemoje
string   $lang_identi   kalbos kodas ,kuria bus rodomi pranešimai ISO 639-1 standartu.
array   $options   parametrai kurie bus grąžinami.
string   $ident   Skirtas vienam vartotojui būti registruotam vienoje prenumeratoje kelis kartus naudojant skirtingą šį parametrą.
string   $unregister_reason   Why user is unregistering or identifier of system that unregisters

[ Top ]

method SubscriptionWapRegister [line 516]

array SubscriptionWapRegister( int $service_id, [int $channel_id = null], [string $lang_identi = null], [array $options = array()], [string $ident = null], [string $valid_till = null])

Paruošiama vartotojo registravimui.

Kad vartotojas taptu registruotas reikia jį nukreipti gautu adresu. Gražinami parametrai: transaction_id – sukurtos tranzakcijos id url – adresas kur nukreipti vartotoją, kad įvyktu registracija




Parameters:

int   $service_id   Wap paslaugos identifikatorius
int   $channel_id   Kanalo identifikatorius
string   $lang_identi   kalbos kodas ,kuria bus rodomi pranešimai ISO 639-1 standartu.
array   $options   parametrai kurie bus grąžinami.
string   $ident   Skirtas vienam vartotojui būti registruotam vienoje prenumeratoje kelis kartus naudojant skirtingą šį parametrą.
string   $valid_till   Nurodo data ir laiką, iki kada galios vartotojo prenumerata

[ Top ]

method SubscriptionWapUnregister [line 551]

string SubscriptionWapUnregister( int $service_id, [string $lang_ident = null], [array $options = array()], [string $ident = null], [string $unregister_reason = null])

Pasiruošimas vartotojo išregistravimui.

Metodas grąžina URL, kuriuo reikia nukreipti vartotoją, kad galutinai jis būtu išregistruotas.




Tags:

return:  URL


Parameters:

int   $service_id   WAP apmokestinimo paslaugos id
string   $lang_ident   kalbos kodas ,kuria bus rodomi pranešimai ISO 639-1 standartu.
array   $options   parametrai, kurie bus grąžinami.
string   $ident   Skirtas vienam vartotojui būti registruotam vienoje prenumeratoje kelis kartus naudojant skirtingą šį parametrą.
string   $unregister_reason   Why user is unregistering or identifier of system that unregisters

[ Top ]

method unregister [line 350]

void unregister( array $options, [string $lang_id = null], [string $ident = null], [string $unregister_reason = ''])

Išregistruojamas vartotojas iš prenumeratos.

Išregistravimas vyksta Vero sistemoje, todėl vartotojas siunčiamas į Vero sistema iš registravimui įvykdžius šį metodą programos darbas nutraukiamas.

Vartotojas po išregistravimo nukreipiamas adresu nurodytu prie prenumeratos paslaugos užsakymo.

!SVARBU! Vartotojas nėra grąžinamas į $back_url.




Parameters:

array   $options   Papildomi parametrai, kuriuos MBS pridės prie atgalinio URL po registracijos
string   $lang_id   Kalbos kodas ISO 639-1 standartu ( naudojamas rodant klausimą )
string   $ident   Papildomas registruoto vartotojo identifikatorius ( kai norima viena vartotoja registruoti į prenumeratą daugiau negu vieną karta ) !Dar neveikia!
string   $unregister_reason  

[ Top ]

method unregisterRedirect [line 204]

void unregisterRedirect( [array $params = array()], [string $ident = null], [string $subscriber_ident = null], [string $url_false = false])

Vartotojo išregistravimas iš prenumeratos redirect būdu.



Parameters:

array   $params   (nebūtina) Papildomi parametrai, kurie bus grazinami atgal
string   $ident   (nebūtina) Unikalus pirkimo identifikatorius partnerio sistemoje
string   $subscriber_ident   (nebūtina) Prenumeratoriaus identifikatorius paslaugoje (jei galima registruotis į vieną paslaugą kelis kartus)
string   $url_false   (nebūtina) URL, į kurį nukreipiama po nesėkmingos registracijos

[ Top ]

method unregisterUrl [line 375]

string unregisterUrl( array $options, [string $lang_id = null], [string $ident = null], [string $unregister_reason = ''])

Gražinama nuoroda, kurią vartotojas turi būti nukreipiamas, kad vartotojas būtu išregistruotas iš prenumeratos.

Parametrai identiški unregister metodui. Veikimas identiškas tik gražinamas URL ir darbas nenutraukiamas.




Tags:

return:  URL kur reikia nukreipti vartotoja kad jis būtų išregistruotas iš prenumeratos
see:  SBBS::unregister()


Parameters:

array   $options   Papildomi parametrai, kuriuos MBS pridės prie atgalinio URL po registracijos
string   $lang_id   Kalbos kodas ISO 639-1 standartu ( naudojamas rodant klausimą )
string   $ident   Papildomas registruoto vartotojo identifikatorius ( kai norima viena vartotoja registruoti į prenumeratą daugiau negu vieną karta ) !Dar neveikia!
string   $unregister_reason  

[ Top ]


Documentation generated on Fri, 05 Nov 2010 11:25:47 +0200 by phpDocumentor 1.4.3