Soap API v1.4


Disable the recurring billing for a customer specified by CustNum.


This method allows you to stop a customer's recurring billing cycle using the CustNum (unique customer number assigned by the gateway) as a reference. If you have lost or cannot remember the customer's CustNum, use the searchCustomerID method to retrieve it.

You can resume a customer's recurring billing cycle at any time using the enableCustomer method.

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


boolean disableCustomer ( ueSecurityToken Token, integer CustNum )


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

Return Value

boolean Returns confirmation of the disable recurring billing request only if request is successful. If request fails, an exception will be thrown.



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

try { 
catch(SoapFault $e) { 
  echo $e->getMessage(); 


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

try {
  //Set CustNum for the Customer that you want to disable
  BigInteger CustNum = new BigInteger("12345678");
  client.disableCustomer(token, CustNum);
} catch (Exception e) {
    System.out.println("Soap Exception: " + e.getMessage());


 Dim custNum As String
        custNum = "103125"
        Dim response As Boolean
        response = client.disableCustomer(token, custNum)

.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";
            Boolean response;
                response = client.deleteCustomer(token, custNum);
                if (response)
            catch (Exception err)

Change History

Version Change
1.1 Method added prior to soap-1.1
developer/soap-1.4/methods/disablecustomer.txt · Last modified: 2010/09/09 11:17 by irina

Page Tools