developer:soap-1.6:methods:gettransactionprofile

Differences

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

Link to this comparison view

developer:soap-1.6:methods:gettransactionprofile [2012/08/04 10:06] (current)
tem created
Line 1: Line 1:
 +<embed ..:​contents/>​
  
 +====== getTransactionProfile ======
 +
 +Retrieve fraud profiling data for a transaction.
 +
 +===== Description =====
 +
 +This method retrieves the fraud profiling data for a given transaction. ​  
 +
 +Fraud profiling allows merchants to perform in depth analysis and business risk assessment using third party services such as Threat Metrix. ​  These premium services must be enabled on the merchants account before this method may be used.  ​
 +
 +If profiling data is available, ​ a TransactionProfile object is returned. ​ This object contains profile data such as the scoring and extended device data. 
 +
 +See also [[getSession]],​ [[developer:​threatmetrix|ThreatMetrix Guide]]
 +===== Syntax =====
 +
 +[[..:​objects:​TransactionProfile]] **getTransactionProfile** ( [[..:​objects:​ueSecurityToken]] Token, integer RefNum) ​
 +
 +
 +
 +===== Arguments =====
 +
 +^Type   ​^Name ​  ​^Description ​  ^
 +|[[..:​objects:​ueSecurityToken]] |Token |Merchant security token: used to identify merchant and validate transaction.|
 +|integer |RefNum |Transaction Reference number assigned by the gateway.|
 +
 +===== Return Value =====
 +
 +|[[..:​objects:​TransactionProfile]] |Returns fraud profile data. |
 +
 +===== Exceptions =====
 +
 +The following exceptions (errors) are applicable to this method. ​
 +
 +^Code ^Message ​ ^Advice ​ ^
 +|20001 |Specified transactions was not found |RefNum didn't match any of the merchants transactions. ​ |
 +|20035 |Merchant does not have fraud profiling enabled |The merchant'​s account must be configured for fraud profiling. ​ They should contact their reseller to sign up for the service. |
 +
 +
 +
 +===== Examples =====
 +
 +==== PHP ====
 +
 +For directions on how to set up the WSDL link, create "​$token"​ and "​$client",​ go to [[..:​howto:​php|PHP Soap How-to]].
 +
 +<code php>
 +<?​php ​
 +
 +try { 
 +  $RefNum='​12345678';​
 +  $data=$client->​getTransactionProfile($token,​ $RefNum);  ​
 +  print_r($data); ​             ​
 +
 +
 +catch (SoapFault $e) { 
 +  die("​Call failed :" .$e->​getMessage()); ​
 +  } 
 +
 +?> 
 +</​code>​
 +
 +==== .NET VB ====
 +<code vb>
 +        Dim response As usaepay.TransactionProfile
 +
 +        response = client.getTransactionProfile(token,​ 1234567)
 +
 +        MsgBox("​DeviceID:​ " & response.DeviceID);​
 +        ​
 +</​code>​
 +
 +==== .NET C# ====
 +<code c>
 +
 +            usaepay.TransactionProfile response;
 +
 +            try
 +                {
 +                   ​response = client.getTransactionProfile(token);​
 +
 +                   ​MessageBox.Show(response.DeviceID);​
 +
 +                }
 +                catch (Exception err)
 +                {
 +                    MessageBox.Show(err.Message);​
 +                }
 +</​code>​
 +
 +===== Change History =====
 +
 +^Version ^Change ^
 +|[[developer:​soap-1.5:​methods:​gettransactionprofile|1.5]] | Method added in this release |
developer/soap-1.6/methods/gettransactionprofile.txt ยท Last modified: 2012/08/04 10:06 by tem

Page Tools