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);
        }