getCustomerHistory

Pull details of all transactions run for CustNum.

Description

This method allows you to view all of the transactions completed for a particular customer.

This method requires the use of the CustNum, a unique customer number assigned by the gateway. If you have lost or cannot remember the customer's CustNum, use the searchCustomers method to find the correct CustNum.

See also runCustomerTransaction, enableCustomer, disableCustomer, deleteCustomer, searchCustomerID, getCustomer, searchCustomers, addCustomer, addCustomerPaymentMethod, deleteCustomerPaymentMethod, updateCustomer, quickUpdateCustomer

Syntax

TransactionSearchResult getCustomerHistory ( ueSecurityToken Token, string CustNum )

Arguments

Type	Name	Description
ueSecurityToken	Token	Merchant security token: used to identify merchant and validate transaction.
string	CustNum	A unique customer number assigned by the gateway.

Return Value

Type	Description
TransactionSearchResult	Returns the results of the customer transaction history search.

Examples

PHP

For directions on how to set up the WSDL link, create "$token" and "$client", go to PHP Soap How-to.

    try {

      $custnum='547';
      print_r($client->getCustomerHistory($token,$custnum));

    }

    catch(SoapFault $e) {

      echo $e->getMessage();

    }

    echo "\n\nRequest: " . $client->__getLastRequest();
    echo "\n\nResponse: " . $client->__getLastResponse();

Java

This example uses the Newtek Gateway Java library. For directions on how to install the library and create the token/client objects, go to the Java JAX-WS Howto.

    try {
      //Set CustNum to the Customer Number of customer you
      //want to retrieve a transaction history from.
      BigInteger CustNum = new BigInteger;

      TransactionSearchResult CustHist = new TransactionSearchResult();
      CustHist = client.getCustomerHistory(token, CustNum);
    } catch (Exception e) {
        System.out.println("Soap Exception: " + e.getMessage());
    }

.NET VB

    Dim CustNum As String
            CustNum = "103125"

            Dim tran As newtek.TransactionSearchResult
            tran = New newtek.TransactionSearchResult

            tran = client.getCustomerHistory(token, CustNum)
            MsgBox(tran.SalesCount)

.NET C

For directions on how to set up the WSDL link and create the "token" and "client" variables, go to the C Sharp .Net Soap How-to.

    string CustNum = "89147";

                newtek.TransactionSearchResult tran = new newtek.TransactionSearchResult();

                try
                {

                    tran = client.getCustomerHistory(token, CustNum);
                    MessageBox.Show(string.Concat(tran.SalesCount));

                }

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

Change Log

Version	Change
1.7	Changed CustNum to type string