developer:soap-1.6:methods:gettransactionprofile

Soap API v1.6

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, ThreatMetrix Guide

Syntax

TransactionProfile getTransactionProfile ( ueSecurityToken Token, integer RefNum)

Arguments

Type Name Description
ueSecurityToken Token Merchant security token: used to identify merchant and validate transaction.
integer RefNum Transaction Reference number assigned by the gateway.

Return Value

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 PHP Soap How-to.

<?php 
 
try { 
  $RefNum='12345678';
  $data=$client->getTransactionProfile($token, $RefNum);  
  print_r($data);              
} 
 
catch (SoapFault $e) { 
  die("Call failed :" .$e->getMessage()); 
  } 
 
?> 

.NET VB

        Dim response As usaepay.TransactionProfile
 
        response = client.getTransactionProfile(token, 1234567)
 
        MsgBox("DeviceID: " & response.DeviceID);
 

.NET C#

            usaepay.TransactionProfile response;
 
            try
                {
                   response = client.getTransactionProfile(token);
 
                   MessageBox.Show(response.DeviceID);
 
                }
                catch (Exception err)
                {
                    MessageBox.Show(err.Message);
                }

Change History

Version Change
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