Money

Platebni systém o.s. HKfree

Je známá též pod krycím názvem money

Slouží k informacim o virtuálních účtech uživatelů HKfree a správcovský přístup pro aktivaci/deaktivaci jednotlivých uživatelských účtů.

Běží na stroji igw3.hkfree.org, který je fyzicky umístěn v centralni serverovne na PMV
Přístup do ní mají všichni nesmazaní uživatelé
Technickým správcem databáze je kendy (Jabber ID: kendy@jabber.hkfree.org).
Nove pozadavky zadavejte na https://jira.hkfree.org/browse/MNY (komponenta Money)

Je v provozu ode dne oficiálního založení sdružení, tj. od 10.4.2004.

WWW přístup

Na adrese http https://money.hkfree.org/
login: ID z tvojí přihlášky
heslo: heslo z tvojí přihlášky (bacha na malá/velká písmena)

SOAP přístup (vývoj 12/2008-xxx)

Přístup mají výhradně jen správci

Technologie

Linux, Perl 5.8.8, modul SOAP::Lite, FastCGI, Apache 2.2.x, MySQL 5.0.x

WSDL

https://money.hkfree.org/wsdl/moneyAPI.wsdl

pro přístup k wsdl souboru pouzijte vase ID a heslo

specifikace API

API obsahuje či by mělo obsahovat tyto možnosti (metody):

všechny výstupy jsou vraceny v poli.

---

Funkce ktere se jsou jiz v provozu:

1) Výpis stavu uživatele
funkce:hkfree_money_userIsActive();
vstup - int [id]

• id ID uzivatele o kterem chceme pozadovane info

výstup - bool,bool,string [result, isActive, text]

• result vrací true ci false zda se funkce zdarila ci nezdarila (1|0)
• isActive stav uzivatele v systemu
• errormessage pripadna error hlaska (pri probehnuti vseho v poradku je zde text OK)

2) Výpis zda je uzivatel nastaven k automatické deaktivaci
funkce:hkfree_money_userIsDisabled();
vstup - int [id]

• id ID uzivatele o kterem chceme pozadovane info

výstup - bool,bool,string [result, isDisabled, text]

• result vrací true ci false zda se funkce zdarila ci nezdarila (1|0)
• isDisabled stav uzivatele zda je ci neni nastaven k automaticke deaktivaci
• errormessage pripadna error hlaska (pri probehnuti vseho v poradku je zde text OK)

3) Stav uzivatelova virtualniho uctu v Kc
funkce:hkfree_money_userGetAccountBalance();
vstup - int [id]

• id ID uzivatele o kterem chceme pozadovane info

výstup - bool,int,string [result, balance, text]

• result vrací true ci false zda se funkce zdarila ci nezdarila (1|0)
• balance stav uzivatelova virtualniho uctu v Kc
• errormessage pripadna error hlaska (pri probehnuti vseho v poradku je zde text OK)

---

Funkce ktere se budou vyvijet:

4) Odstranit/nastavit disablovani usera
funkce:hkfree_money_userSetDisabled();
vstup - int [id]

• id ID uzivatele kteremu chceme nastavit/zrusit stav Disabled

výstup - bool,bool,string [result, isDisabled, text]

• result vrací true ci false zda se funkce zdarila ci nezdarila (1|0)
• isDisabled stav uzivatele zda je ci neni nastaven k automaticke deaktivaci
• errormessage pripadna error hlaska

5) Aktivace usera
funkce:hkfree_money_userSetActivate();
vstup - int [id]

• id ID uzivatele kteremu chceme nastavit/zrusit stav Disabled

výstup - bool,bool,int,string [result, isActivated, zustatek, text]

• result vrací true ci false zda se funkce zdarila ci nezdarila (1|0)
• isActivated stav uzivatele zda je ci neni nastaven k automaticke deaktivaci
• zustatek aktualni zustatek penez v Kc (po provedene aktivaci) - vypise se pouze pokud byla provedena uspesna aktivace i s odectem penez
• errormessage pripadna error hlaska

6) Seznam aktivnich/neaktivnich ID do netu
funkce:hkfree_money_userGetStateIDs();
vstup - int [id]

• type 1 - pro ziskani vsech aktivnich ID; 0 - pro ziskani vsech neaktivnich ID

výstup - bool,string,string [result, idList, text]

• result vrací true ci false zda se funkce zdarila ci nezdarila (1|0)
• idList seznam IDcek oddelenych strednikem (1;3;4;5...)
• errormessage pripadna error hlaska

Příklad přístupu z perlu

#!/usr/bin/perl
# 
# 

use Data::Dumper;
use SOAP::Lite;
use SOAP::WSDL;

#My credentials
my $id = 1234; #Moje ID
my $heslo = 'mojetajneheslo'; #Moje heslo (pokud jsem si heslo zmenil v money, tak pouziji to)

#Init soap object
my $soap = SOAP::Lite
   -> service("https://$id:$heslo\@money.hkfree.org/wsdl/moneyAPI.wsdl");

#Set my credentials to the soap object
sub SOAP::Transport::HTTP::Client::get_basic_credentials {
    return "$id" => "$heslo";
}


my $info_about_this_id = 1234;
#call function with one parameter
@res =  $soap->hkfree_money_userIsActive($info_about_this_id);
#Display Result
print Dumper \@res;

Příklad přístupu z PHP

<?php

$id = 'mojeID';
$heslo = 'mojeTajneHeslo';

$client = new SoapClient(
        'https://' . $id . ':' . $heslo . '@money.hkfree.org/wsdl/moneyAPI.wsdl',
        array(
                'login'         => $id,
                'password'      => $heslo,
                'trace'         => 1,
                )
        );

echo "FUNCTIONS:\n";
var_dump( $client->__getFunctions() );
echo "TYPES:\n";
var_dump( $client->__getTypes() );

$id=144;

var_dump( $client->hkfree_money_userIsActive($id) );
var_dump( $client->hkfree_money_userIsDisabled($id) );
var_dump( $client->hkfree_money_userGetAccountBalance($id) );

echo "END:\n";

?>