developer:soap-1.6:methods:searchtransactionscount

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

developer:soap-1.6:methods:searchtransactionscount [2012/08/04 10:07] (current)
tem created
Line 1: Line 1:
 +<embed ..:​contents/>​
  
 +====== searchTransactionsCount ======
 +
 +Search transactions,​ only return transaction counts
 +
 +===== Description =====
 +
 +Identical to the [[searchTransactions]] method except only the transaction counts are returned. ​ Like [[searchTransactions]], ​ this method returns [[..:​objects:​TransactionSearchResult]]. ​ The only difference is that TransactionSearchResult.Transactions is left empty. ​ This method provides a quicker way to determine the size of the result set before starting to retrieve the full search results.
 +
 +
 +See also [[getTransaction]],​ [[getTransactionStatus]],​ [[getTransactionCustom]],​ [[searchTransactions]],​ [[getTransactionReport]] ​
 +
 +
 +
 +===== Syntax =====
 +
 +[[developer:​soap:​objects:​TransactionSearchResult]] **searchTransactionsCount** ( [[developer:​soap:​objects:​ueSecurityToken]] Token, [[developer:​soap:​objects:​SearchParam]] Search, boolean MatchAll, integer Start, integer Limit, string Sort)
 +
 +
 +
 +===== Arguments =====
 +
 +^Type   ​^Name ​  ​^Description ​  ^
 +|[[developer:​soap:​objects:​ueSecurityToken]] |Token |Merchant security token: used to identify merchant and validate transaction.|
 +|[[developer:​soap:​objects:​SearchParam]] |Search |Array of search parameters (SearchParam objects) available.|
 +|boolean |MatchAll |If set to "​true,"​ only results matching all search criteria will be returned, if set to "​false,"​ results matching any of the search criteria will be returned.|
 +|integer |Start |Sequence number to start returning on.|
 +|integer |Limit |Maximum number of transactions to return in result set. |
 +|string |Sort |Comma separated list of fields to sort by. |
 +
 +
 +===== Return Value =====
 +
 +|[[developer:​soap:​objects:​TransactionSearchResult]] |Returns the full transaction records for all transactions matching the specified search parameters. |
 +
 +===== Examples =====
 +
 +
 +
 +
 +==== PHP 5 ====
 +For directions on how to set up the WSDL link, create "​$token"​ and "​$client",​ go to [[developer:​soap:​howto:​php|PHP Soap How-to]].
 +
 +<code php>
 +
 +<?​php ​
 +
 +try { 
 +
 +  // Create search parameter list 
 +  $search=array( ​
 +    array( ​
 +      '​Field'​=>'​amount', ​  
 +      '​Type'​=>'​eq', ​
 +      '​Value'​=>'​4.00'​), ​
 +    array( ​
 +      '​Field'​=>'​created',  ​
 +      '​Type'​=>'​gt',  ​
 +      '​Value'​=>'​2007-03-21'​), ​
 +    array( ​
 +      '​Field'​=>'​created',  ​
 +      '​Type'​=>'​lt',  ​
 +      '​Value'​=>'​2007-03-22'​), ​
 +    array( ​
 +      '​Field'​=>'​response',  ​
 +      '​Type'​=>'​eq',  ​
 +      '​Value'​=>'​A'​) ​
 +    ); 
 +  $start=0; ​
 +  $limit=100; ​
 +  $matchall=true; ​
 +  $sort='​created';​
 +
 +  $res=$client->​searchTransactionsCount($token,​$search,​$matchall,​$start,​$limit,​$sort); ​
 +
 +  print_r($res); ​
 +             
 +
 +catch(SoapFault $e) { 
 +  echo $client->​__getLastResponse(); ​
 +  die("​Search Transaction Failed :"​.$e->​getMessage()); ​
 +
 +
 +?> 
 +</​code>​
 +
 +==== PHP 4 (NuSOAP) ====
 +
 +<code php>
 +<?​php ​
 +
 +include '​./​nusoap.php'; ​
 +
 +// Create Soap Client ​
 +$s=new soapclient("​./​usaepay.wsdl",'​wsdl'​); ​
 +$tran=$s->​getProxy(); ​
 +
 +// Source Key Setting ​
 +$sourcekey='​yQbOFkjD8wwlkZ3AhY248k3Lc9PH1l14'; ​
 +$pin='​1234'; ​
 +
 +// Prep source key 
 +$seed=mktime() . rand(); ​
 +$tmp=$sourcekey . $seed . $pin; 
 +$hash=sha1($tmp); ​
 +$token=array('​SourceKey'​=>​$sourcekey,​ '​PinHash'​=>​array('​Type'​=>'​sha1',​ '​Seed'​=>​$seed,'​HashValue'​=>​$hash)); ​
 +
 +
 +// Prep Request data 
 +$search=array( ​
 +      array('​Field'​=>'​amount',​ '​Type'​=>'​gt','​Value'​=>'​5.00'​), ​
 +      array('​Field'​=>'​created',​ '​Type'​=>'​gt',​ '​Value'​=>'​2005-01-01'​), ​
 +      array('​Field'​=>'​response',​ '​Type'​=>'​eq',​ '​Value'​=>'​A'​) ​
 +); 
 +$start=0; ​
 +$limit=10; ​
 +$matchall=true; ​
 +$sort='​created';​
 +
 +$res=$tran->​searchTransactionsCount($token,​$search,​$matchall,​$start,​$limit,​$sort); ​
 +
 +if(!$err=$tran->​getError()) { 
 +        print_r($res); ​
 +} else { 
 +
 +        echo "​Error:​ $err\n"; ​
 +        echo $tran->​request;  ​
 +
 +
 +</​code>​
 +
 +==== VB ====
 +For directions on how to set up the WSDL link and create the "​token"​ and "​client"​ variables, go to the [[..:​howto:​vb|Visual Basic .Net Soap How-to]].
 +<code vb>
 +  Dim client As usaepay.usaepayService = New usaepay.usaepayService
 +  Dim token As usaepay.ueSecurityToken
 +
 +  token = Me.CreateToken("​982lz9VsLm87MA54Sv8E582h8OZMArL6",​ "​443311"​)
 +
 +  Dim MatchAll As Boolean
 +
 +  MatchAll = False
 +
 +  Dim searchParams(1) As usaepay.SearchParam
 +    searchParams(0) = New usaepay.SearchParam
 +    searchParams(0).Field = "​Created"​
 +    searchParams(0).Type = "​eq"​
 +    searchParams(0).Value = "​2009-02-19"​
 +
 +  Dim SearchResults As usaepay.TransactionSearchResult = New usaepay.TransactionSearchResult
 +  SearchResults = client.searchTransactionsCount(token,​ searchParams,​ MatchAll, 0, 1000, "​created"​)
 +
 +  MsgBox(SearchResults.TransactionsMatched)
 +</​code>​
 +
 +==== .NET C# ====
 +For directions on how to set up the WSDL link and create the "​token"​ and "​client"​ variables, go to the [[..:​howto:​csharp|C Sharp .Net Soap How-to]].
 +<code c>
 +Boolean matchAll;
 +            matchAll = true;
 +
 +            string[] fields = new string[3];
 +            usaepay.SearchParam[] search = new usaepay.SearchParam[2];​
 +            search[0] = new usaepay.SearchParam();​
 +
 +            search[0].Field = "​Created";​
 +            search[0].Type = "​gt";​
 +            search[0].Value = "​2010-08-08";​
 +
 +            usaepay.TransactionSearchResult result = new usaepay.TransactionSearchResult();​
 +
 +            try
 +            {
 +                result = client.searchTransactionsCount(token,​ search, matchAll, "​0",​ "​10",​ "​created"​);​
 +
 +                MessageBox.Show(string.Concat(result.TransactionsMatched));​
 +
 +            }
 +
 +
 +            catch (Exception err)
 +            {
 +                MessageBox.Show(err.Message);​
 +            }
 +
 +</​code>​
 +
 +==== Coldfusion ====
 +
 +//NOTE//: this example has not been tested and is provided as is 
 +
 +<code cfm>
 +<​cfscript> ​
 +Start = 0; 
 +Limit = 10; 
 +MatchAll=1; ​
 +Sort='​created';​
 +Search=ArrayNew(1); ​
 +Search[1]=structnew(); ​
 +Search[1].Field='​created'; ​
 +Search[1].Type='​gt'; ​
 +Search[1].Value='​2006-09-01'; ​
 +
 +ws = createObject("​webservice",​ "​https://​www.usaepay.com/​soap/​gate/​AC5EA536/​usaepay.wsdl"​); ​
 +Output = ws.searchTransactionsCount(Token,​ Search, MatchAll, Start, Limit, Sort); ​
 +</​cfscript> ​
 +</​code>​
 +==== XML ====
 +
 +<code xml>
 +<?xml version="​1.0"​ encoding="​UTF-8"?> ​
 +<​SOAP-ENV:​Envelope xmlns:​SOAP-ENV="​http://​schemas.xmlsoap.org/​soap/​envelope/" ​
 +xmlns:​ns1="​urn:​usaepay"​ xmlns:​xsd="​http://​www.w3.org/​2001/​XMLSchema" ​
 +xmlns:​xsi="​http://​www.w3.org/​2001/​XMLSchema-instance" ​
 +xmlns:​SOAP-ENC="​http://​schemas.xmlsoap.org/​soap/​encoding/" ​
 +SOAP-ENV:​encodingStyle="​http://​schemas.xmlsoap.org/​soap/​encoding/"> ​
 +<​SOAP-ENV:​Body> ​
 +<​ns1:​searchTransactionsCount> ​
 +<Token xsi:​type="​ns1:​ueSecurityToken">​
 +<​ClientIP xsi:​type="​xsd:​string">​192.168.0.1</​ClientIP>​
 +<PinHash xsi:​type="​ns1:​ueHash">​
 +<​HashValue xsi:​type="​xsd:​string">​11ac55b0a0b59f8f028dbf85bc32266fa973dd0e</​HashValue>​
 +<Seed xsi:​type="​xsd:​string">​12678150211876663375</​Seed>​
 +<Type xsi:​type="​xsd:​string">​sha1</​Type>​
 +</​PinHash>​
 +<​SourceKey xsi:​type="​xsd:​string">​HB4P7C4K2w2ZCQQQXRqrxDj6agrS2NIT</​SourceKey>​
 +</​Token>​
 +<Search SOAP-ENC:​arrayType="​ns1:​SearchParam[1]"​ xsi:​type="​ns1:​SearchParamArray"> ​
 +<item xsi:​type="​ns1:​SearchParam"> ​
 +<Field xsi:​type="​xsd:​string">​amount</​Field> ​
 +<Type xsi:​type="​xsd:​string">​eq</​Type> ​
 +<Value xsi:​type="​xsd:​string">​29.00</​Value> ​
 +</​item> ​
 +</​Search> ​
 +<​MatchAll xsi:​type="​xsd:​boolean">​true</​MatchAll> ​
 +<Start xsi:​type="​xsd:​integer">​0</​Start> ​
 +<Limit xsi:​type="​xsd:​integer">​10</​Limit> ​
 +<Sort xsi:​type="​xsd:​string">​created</​Sort> ​
 +</​ns1:​searchTransactionsCount> ​
 +</​SOAP-ENV:​Body> ​
 +</​SOAP-ENV:​Envelope>​
 +</​code>​
 +
 +
 +
 +===== Change History =====
 +
 +^Version ^Change ^
 +|[[developer:​soap-1.2:​methods:​searchtransactionscount|1.2]]| Function added in 1.2 release |
developer/soap-1.6/methods/searchtransactionscount.txt ยท Last modified: 2012/08/04 10:07 by tem

Page Tools