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

Class: Bank

Source Location: /lib/Bank.class.php

Class Overview

MBSBase
   |
   --Bank

WEB apmokėjimų klasė


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 22]
WEB apmokėjimų klasė

Naudojimo pavyzdžiai:

  1. <?php
  2. /**
  3.  * Raw WEB billing example (using redirect)
  4.  * 
  5.  * @see MBSLib/examples/simple/bank_bill.php
  6.  *
  7.  * @package RawExamples
  8.  * @author Valdas Petrulis <vpe@vero.lt>
  9.  */
  10.  
  11. include_once(dirname(__FILE__).'/../../lib/Bank.class.php');
  12.  
  13. // Inicijuojame WEB apmokėjimų biblioteką
  14. define('MBS_SERVICE_ID'70646);
  15. define('MBS_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  16. define('MBS_SECRET_KEY''test-test-test-test');
  17.  
  18. // Apmokėjimo pabaiga ir GET rasti teisingi duomenys
  19. if (isset($_GET['after_bill']&& $transaction=$bank->getBillInformation()) {
  20.     // Tranzakcija sėkmingai apmokėta
  21.     if ($transaction['status']=='commit'{
  22.         /** ... cia suteikiama paslauga ... **/
  23.         $paslauga_suteikta true;
  24.     
  25.         echo sprintf("Jūs paaukojote %.2f %s"$transaction['price']/100$transaction['currency']);
  26.     // Tranzakcija neapmokėta
  27.     else {
  28.         echo "Tranzakcija neapmokėta. "$bank->getStatusDescription($transaction['state']);
  29.     }
  30. }
  31.  
  32. echo '<br/><a href="'$bank->getBillUrl(array('after_bill' => 'yes')time()100.'" >Aukoti (1 Lt)<a/>';
  33. echo '<br/><a href="'$bank->getBillUrl(array('after_bill' => 'yes')time()300.'" >Aukoti (3 Lt)<a/>';
  34. echo '<br/><a href="'$bank->getBillUrl(array('after_bill' => 'yes')time()1000.'" >Aukoti (10 Lt)<a/>';
  35.  
  36. ?>
  1. <?php
  2. /**
  3.  * Raw WEB billing example (using redirect)
  4.  * 
  5.  * @see MBSLib/examples/simple/bank_bill_goods.php
  6.  *
  7.  * @package RawExamples
  8.  * @author Valdas Petrulis <vpe@vero.lt>
  9.  */
  10.  
  11. include_once(dirname(__FILE__).'/../../lib/Bank.class.php');
  12.  
  13. // Inicijuojame WEB apmokėjimų biblioteką
  14. define('MBS_SERVICE_ID'70167);
  15. define('MBS_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  16. define('MBS_SECRET_KEY''test-test-test-test');
  17.  
  18. // Apmokėjimo inicijavimas
  19. $url $bank->getBillUrl(array('after_bill' => 'yes')time()null'Kiek auksinių trūksta?');
  20.  
  21. // Apmokėjimo pabaiga ir GET rasti teisingi duomenys
  22. if (isset($_GET['after_bill']&& $transaction=$bank->getBillInformation()) {
  23.     // Tranzakcija sėkmingai apmokėta
  24.     if ($transaction['status']=='commit'{
  25.         /** ... cia suteikiama paslauga ... **/
  26.         $paslauga_suteikta true;
  27.     
  28.         echo "Jūs nusipirkote "$transaction['value'." auksinių";
  29.     // Tranzakcija neapmokėta
  30.     else {
  31.         echo "Tranzakcija neapmokėta. "$bank->getStatusDescription($transaction['state']);
  32.     }
  33. }
  34.  
  35. echo '<br/><a href="'$url .'" >Pildyti auksinių<a/>';
  36.  
  37. ?>




Tags:

author:  Valdas Petrulis <vpe@vero.lt>


[ Top ]


Class Variables

$service_id =  0

[line 31]

Paslaugos identifikatorius. Apmokestinimo paslaugos, kuri turi konkrečias kainas



Tags:

access:  protected

Type:   int


[ Top ]



Class Methods


constructor Bank [line 64]

MBS Bank( int $service_id, [string $secret_key = null], [string $back_url = 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
  • %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:

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

[ Top ]

method billRedirect [line 95]

void billRedirect( [array $params = array()], [string $ident = null], [integer $price = null], [string $title = null])

Vartotojo apmokęstinimas redirect būdu.

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.)




Tags:

see:  Bill


Parameters:

array   $params   (nebūtina) Papildomi parametrai, kurie bus gražinami atgal
string   $ident   (nebūtina) Unikalus pirkimo identifikatorius partnerio sistemoje
integer   $price   (nebūtina) Apmokestinimo kaina (valiutos 1/100 dalimis - centais). Reikalinga, kai paslauga veikia be prekių sąrašo
string   $title   (nebūtina)

[ Top ]

method getBillInformation [line 143]

array getBillInformation( )

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



Tags:

return:  Billing transaction data


[ Top ]

method getBillUrl [line 118]

void getBillUrl( [array $params = array()], [string $ident = null], [integer $price = null], [string $title = null])

Gražinama nuoroda, į kurią vartotojas turi būti nukreipiamas (redirect), kad vartotojas būtų apmokęstintas

Parametrai identiški billRedirect metodui.




Tags:



Parameters:

array   $params   (nebūtina) Papildomi parametrai, kurie bus gražinami atgal
string   $ident   (nebūtina) Unikalus pirkimo identifikatorius partnerio sistemoje
integer   $price   (nebūtina) Apmokestinimo kaina (valiutos 1/100 dalimis - centais). Reikalinga, kai paslauga veikia be prekių sąrašo
string   $title   (nebūtina)

[ Top ]

method isBilled [line 198]

boolean isBilled( )

Patikrinama ar už tranzakciją yra sumokėta.

Užmokėta tranzakcija yra jeigu sutampa paslaugos identifikatorius ir tranzakcijos būsena yra "commit".




Tags:



[ Top ]


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