addCustomerPaymentMethod

This method allows you to add a new payment method to a customer record.

 

Description

Multiple payment methods may be stored for each customer. There is no limit to the number of payment methods that can be stored, but only one of these methods may be marked as the default payment method for all future transactions including recurring billing and manual charges.

To set a payment method as default, pass “true” for the MakeDefault parameter. Setting a payment method to default overrides the SecordarySort parameter and sets it to 0. If another method is currently set to default, it will have its SecondarySort changed to 1.

All new payment methods will be validated by the system to be sure that the information entered fits the required format for the specified payment method. (ie: Does the credit card have 16 digits and a future expiration date? Does the check routing number have 9 digits?)

To further verify that a credit card is “good”, set the Verify parameter to “true” (available for credit cards only). This setting will cause the gateway to run an AuthOnly transaction for $0.05. Any fraud modules that are configured for the source will be run. If the transaction is declined the payment method will not be stored and a fault will be thrown with the decline or error message.

If the Verify parameter is set to “false,” the payment data will still be checked to ensure that it is formatted correctly, but the credit card validity will not be verified.

If any errors are detected or the Verify fails, a fault will be thrown. 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.

 

Syntax

integer addCustomerPaymentMethod ( ueSecurityToken Token, integer CustNum, PaymentMethod PaymentMethod, boolean MakeDefault, boolean Verify )

 

Arguments

 

Return Value

 

Examples

 

PHP

 

try {

 $CustNum='113701';

 $PaymentMethod=array(

   'MethodName'=>'Example',

     'CardNumber'=>'4444555566667779',

     'CardExpiration'=>'1212',

     'CardType'=>'',    

     'CardCode'=>'',

     'AvsStreet'=>'',

     'AvsZip'=>'',  

   'SecondarySort'=>0

   );

 $Default=true;

 $Verify=false;

 $MethodID=$client->addCustomerPaymentMethod($token, $CustNum, $PaymentMethod,

                                        $Default, $Verify);

}

catch(SoapFault $e) {

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

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

 echo "SoapFault: " .$e->getMessage();

}

 

Java

 

try {

//Setting Customer Number

BigInteger custnum = new BigInteger("12345678");

//Setting up New Payment Method

PaymentMethod paymethod = new PaymentMethod();

       paymethod.setExpires("2012-09-01");

       CreditCardData ccdata = new CreditCardData();

               ccdata.setCardNumber("4000100011112224");

               ccdata.setCardExpiration("0912");

               ccdata.setAvsStreet("123 Main");

               ccdata.setAvsZip("12345");

       paymethod.setCreditCardData(ccdata);

       paymethod.setMethodName("My Visa");

//Adding Payment Method

BigInteger PaymentMethodID = client.addCustomerPaymentMethod(token, custnum, paymethod, true, true);

} catch (Exception e) {

       System.out.println("Soap Exception: " + e.getMessage());

}

 

.NET VB

 

Dim CustNum As String

       CustNum = "103125"

       Dim payMethod As eBizCharge.PaymentMethod = New eBizCharge.PaymentMethod

       payMethod.CardExpiration = "1212"

       payMethod.CardNumber = "4000100011112224"

       payMethod.AvsStreet = "123 Main st."

       payMethod.AvsZip = "90046"

       payMethod.MethodName = "My Visa"

       Dim response As String

       response = client.addCustomerPaymentMethod(token, CustNum, payMethod, False, True)

       MsgBox(response)

 

 

.NET C#

 

           string CustNum = "89792";            

           eBizCharge.PaymentMethod payMethod = new eBizCharge.PaymentMethod();

           payMethod.CardExpiration = "1212";

           payMethod.CardNumber = "4000100011112224";

           payMethod.AvsStreet = "123 Main st.";

           payMethod.AvsZip = "90046";

           payMethod.MethodName = "My Visa";

           string response;

           try

           {

               response = client.addCustomerPaymentMethod(token, CustNum,payMethod,false,true);

               MessageBox.Show(string.Concat(response));

           }

           catch (Exception err)

           {

               MessageBox.Show(err.Message);

           }

: