getSession

Generate a session for fraud profiling.

Description

This method generates a fraud profiling session. 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.

The method returns a TransactionSession object which contains a session id and an org id. These variables are used to assemble the profiling html snippet that needs to be displayed to the end user. The session id is then passed in with the runTransaction, runSale, etc call.

See also ThreatMetrix Guide

Syntax

TransactionSession getSession ( ueSecurityToken Token)

Arguments

Type	Name	Description
ueSecurityToken	Token	Merchant security token: used to identify merchant and validate transaction.

Return Value

Name	Description
TransactionSession	Returns session data.

Exceptions

The following exceptions (errors) are applicable to this method.

Code	Message	Advice
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 {


      $res=$client->getSession($token);  
      print_r($data);

    }

    catch (SoapFault $e) {
      die("Get Session failed :" .$e->getMessage());
      }

    ?>

.NET VB

    Dim response As newtek.TransactionSession

    response = client.getSession(token, report, options, format)
    Dim binary_data As Byte() = Convert.FromBase64String(response)

    MsgBox("SessionID: " & response.SessionID);

.NET C

    newtek.TransactionSession response;

    try
        {
           response = client.getSession(token);

           MessageBox.Show(response.SessionID);

        }
        catch (Exception err)
        {
            MessageBox.Show(err.Message);
        }