developer:soap-1.4:methods:searchcustomerid

Soap API v1.4

searchCustomerID

Find a CustNum (assigned by the gateway) using a CustID (assigned by merchant).

Description

This method allows you to use the CustID - a customer identification number assigned by the merchant at the time the customer account is created - to find the gateway assigned CustNum associated with the customer's stored data.

The CustNum is required for several customer data storage management methods, including addCustomerPaymentMethod, updateCustomer, and deleteCustomer.

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

Syntax

integer searchCustomerID ( ueSecurityToken Token, string CustID )

Arguments

Type Name Description
ueSecurityToken Token Merchant security token: used to identify merchant and validate transaction.
string CustID Merchant assigned Customer ID.

Return Value

integer Returns the requested CustNum.

Examples

PHP

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

<?php 
 
try { 
 
  $CustID = "21021"; 
 
  $CustNum = $client->searchCustomerID($token, $CustID); 
 
  $this->assertEquals($CustNum, "1222"); 
 
  } 
 
catch(SoapFault $e) { 
 
  die("soap fault: " .$e->getMessage());         
 
  } 
 
?> 

.NET VB

Dim custID As String
        custID = "123456"
 
        Dim response As String
 
        response = client.searchCustomerID(token, custID)
        MsgBox(response)

.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 custID = "123456";
 
            string response;
 
            try
            {
                response = client.searchCustomerID(token, custID);
 
                    MessageBox.Show(string.Concat("CustNum: ",response));
 
 
            }
 
            catch (Exception err)
            {
                MessageBox.Show(err.Message);
            }

Change History

Version Change
1.1 Method added prior to soap-1.1
developer/soap-1.4/methods/searchcustomerid.txt · Last modified: 2012/04/11 16:44 by jpresley

Page Tools