CustomerObject

Contains customer data.

Description

This object contains all relevant customer data including the CustNum (a unique customer number assigned by the gateway), CustID (a merchant assigned customer ID), as well as customer name, address, recurring billing status and schedule, and any other relevant data.

Properties

Type	Name	Description
string	CustNum	Customer Number (System assigned)
string	CustomerID	Customer ID (Merchant assigned)
Address	BillingAddress	Customer Address information. (Uses Address object.)
PaymentMethod	PaymentMethods	Array of PaymentMethod objects. Multiple credit cards or ACH accounts may be stored for each customer.
string	Notes	Notes (visible to merchant only).
string	CustomData	Custom data is a raw text field, please serialize and encode (ie: base64) your data so that complex types are stored and retrieved correctly.
FieldValue	CustomFields	Array of field values containing the merchant defined customer fields. These fields are defined in the merchant console.
string	URL	URL for customers website
datetime	Created	Date/Time customer was created (Read Only)
datetime	Modified	Date/Time customer was last changed (Read Only)
Recurring Billing
boolean	Enabled	Notes whether or not a customer has been enabled for a recurring billing cycle. The customer billing does not need to be enabled to run one time transactions via the runCustomcuerTransaction method.
string	Schedule	Recurring billing schedule, if any. Possible values include: daily, weekly, bi-weekly (every two weeks), monthly, bi-monthly (every two months), quarterly, bi-annually (every six months), annually, first of month, last day of month.
integer	NumLeft	Number of transactions remaining in customer's recurring billing cycle. ”-1” indicates unlimited transactions.
string	Next	Date of customer's next scheduled transaction.
double	Amount	Total Amount to be billed in recurring billing cycle.
double	Tax	Portion of “Amount” that is Tax
string	Currency	Numeric currency code for Amount. (Only needed if multicurrency merchant account)
string	Description	Description of transaction.
string	OrderID	Transaction Order ID
string	User	Merchant username assigned to billing.
string	Source	Name of source key assigned to billing.
boolean	SendReceipt	Send client a receipt.
string	ReceiptNote	Note to send on receipt.
int	Failures	Number of failures since last approval.
Point of Sale
string	PriceTier	Name of customer price tier
string	TaxClass	Tax Class (Group)
string	LookupCode	Lookup code from customer/member id card. Either barcode or Magnetic stripe. Can be assigned by merchants. Defaults to system assigned if left blank.

Examples

PHP

<?php

// for directions on how to set up the

// WSDL link and create "$token" and "$client,"

// see: http://wiki.eBizCharge.com/developer/soap/howto/php

$CustomerObject=array(

'BillingAddress'=>array(

'FirstName'=>'John',

'LastName'=>'Doe',

'Company'=>'Acme Corp',

'Street'=>'1234 main st',

'Street2'=>'Suite #123',

'City'=>'Los Angeles',

'State'=>'CA',

'Zip'=>'12345',

'Country'=>'US',

'Email'=>'support@eBizCharge.com',

'Phone'=>'333-333-3333',

'Fax'=>'333-333-3334'

'PaymentMethods' =>

array(

'CreditCardData' =>

array(

'CardNumber'=>'4444555566667779',

'CardExpiration'=>'0908',

'CardType'=>'',

'CardCode'=>'',

'AvsStreet'=>'',

'AvsZip'=>'',

'CardPresent'=>'',

'MagStripe'=>'',

'TermType'=>'',

'MagSupport'=>'',

'XID'=>'',

'CAVV'=>'',

'ECI'=>'',

'InternalCardAuth'=>'',

'Pares'=>''

"Expires"=>"",

"MethodName"=>"My Visa",

"SecondarySort"=>1

)

'CustomData'=>base64_encode(serialize(array("mydata"=>"We could put anything in here!"))),

'CustomFields'=>array(

array('Field'=>'Foo', 'Value'=>'Testing'),

array('Field'=>'Bar', 'Value'=>'Tested')

'CustomerID'=>123123 + rand(),

'Description'=>'Weekly Bill',

'Enabled'=>false,

'Amount'=>'44.93',

'Tax'=>'0',

'Next'=>'2012-01-21',

'Notes'=>'Testing the soap addCustomer Function',

'NumLeft'=>'50',

'OrderID'=>rand(),

'ReceiptNote'=>'addCustomer test Created Charge',

'Schedule'=>'weekly',

'SendReceipt'=>true,

'Source'=>'Recurring',

'CustNum'=>'C'.rand()

);

$CustomerNumber=$this->client->addCustomer($this->token,$CustomerObject);

$CustomerObject= $this->client->getCustomer($this->token, $CustomerNumber);

echo $CustomerObject->CustNum;

.NET VB

Dim customer As eBizCharge.CustomerObject = New eBizCharge.CustomerObject

Dim address As eBizCharge.Address = New eBizCharge.Address

address.FirstName = "John"

address.LastName = "Doe"

address.Company = "Acme"

address.Street = "123 main st."

address.City = "Hollywood"

address.State = "ca"

address.Zip = "91607"

address.Country = "USA"

customer.BillingAddress = address

customer.Enabled = True

customer.Amount = 5.0

customer.Next = "2010-08-15"

customer.Schedule = "monthly"

Dim payMethod(0) As eBizCharge.PaymentMethod

payMethod(0) = New eBizCharge.PaymentMethod

payMethod(0).CardExpiration = "1212"

payMethod(0).CardNumber = "4444555566667779"

payMethod(0).AvsStreet = "123 Main st."

payMethod(0).AvsZip = "90046"

payMethod(0).MethodName = "My Visa"

customer.PaymentMethods = payMethod

.NET C#

eBizCharge.CustomerObject customer = new eBizCharge.CustomerObject();

eBizCharge.Address address = new eBizCharge.Address();

address.FirstName = "John";

address.LastName = "Doe";

address.Company = "Acme";

address.Street = "123 main st.";

address.City = "Hollywood";

address.State = "ca";

address.Zip = "91607";

address.Country = "USA";

customer.BillingAddress = address;

customer.Enabled = true;

customer.Amount = 5.00;

customer.Next = "2010-08-15";

customer.Schedule = "monthly";

eBizCharge.PaymentMethod[] payMethod = new eBizCharge.PaymentMethod[1];

payMethod[0] = new eBizCharge.PaymentMethod();

payMethod[0].CardExpiration = "1212";

payMethod[0].CardNumber = "4444555566667779";

payMethod[0].AvsStreet = "123 Main st.";

payMethod[0].AvsZip = "90046";

payMethod[0].MethodName = "My Visa";

customer.PaymentMethods = payMethod;

XML

<City xsi:type="xsd:string">Los Angeles</City>

<Company xsi:type="xsd:string">eBizCharge</Company>

<Email xsi:type="xsd:string">support@eBizCharge.com</Email>

<FirstName xsi:type="xsd:string">Example</FirstName>

<LastName xsi:type="xsd:string">Generator</LastName>

<Street2 xsi:type="xsd:string">Suite #123</Street2>

</BillingAddress>

</CustomData>

<Field xsi:type="xsd:string">Example</Field>

<Value xsi:type="xsd:string">Field</Value>

</item>

</CustomFields>

<Description xsi:type="xsd:string">Weekly Bill</Description>

<Enabled xsi:type="xsd:boolean">false</Enabled>

<Notes xsi:type="xsd:string">Any notes go here</Notes>

</CheckData>

<CardNumber xsi:type="xsd:string">XXXXXXXXXXXX7779</CardNumber>

</CreditCardData>

</item>

</PaymentMethods>

<ReceiptNote xsi:type="xsd:string">Example Receipt Note</ReceiptNote>

<Schedule xsi:type="xsd:string">Weekly</Schedule>

<Source xsi:type="xsd:string">Recurring</Source>

</getCustomerReturn>