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 |