EPCustomer Type
Contains customer information.
Remarks
This type contains information about the customer which the merchant has collected. At the minimum, this should include the customer's name and address. You may also optionally include a merchant-generated customer Id, the customer's Email address, Phone number, and Fax number. This type is used by both the ICharge and ECheck components.
Example:
EPCustomer cust = new EPCustomer(); cust.FirstName = "John" cust.LastName = "Smith" cust.FullName = "John M. Smith" cust.Address = "123 Nowhere Ln." cust.City = "Beverly Hills" cust.State = "CA" cust.Zip = "90210" cust.Country = "USA" cust.Phone = "555-555-5555" cust.Email = "jsmith@fake.com" cust.Id = "123456" ICharge1.Customer = cust;
Fields
Address String |
Customer's street address. This field is used as part of the Address Verification Service (AVS) and contains the customer's street address as it appears on their monthly statement. Only the street number, street name, and apartment number are required in this field. City, state, and zip code are set in the City, State, and Zip fields. The length of this field varies by gateway. If the customer's address is very long, it is admissible to include only the street number in this field. NOTE: For the Moneris gateway, this field should contain only the customer's street number. The street name should be added via the AddSpecialField method. For example: component.Customer = new EPCustomer(); component.Customer.Address = "123"; component.AddSpecialField("avs_street_name, "Nowhere Ln"); |
Address2 String |
A specific detail on the customer's shipping address (such as building, suite, apartment, floor number etc.). |
Aggregate String |
This field allows you to get or set an XML aggregate built from all of the fields from this type.
"EPCustomer" is the root element, and the names of the fields create the tags under the root.
For instance:
<EPCustomer> <Address>123 Nowhere Ln.</Address> <Address2>Apt 3B.</Address2> <City>Beverly Hills</City> ... </EPCustomer> |
City String |
Customer's city. This field is used as part of the Address Verification Service (AVS) and contains the customer's city as it appears on their monthly statement. Other AVS fields include Address, State, and Zip.
|
Country String |
Customer's country. This field contains the country in which the customer is located. Most gateways use a two-letter country code, specified in ISO-3166. Note: If using this field with the PayFuse gateway, this field should contain the ISO-3166 numeric code instead of the standard two-letter code. For example, the ISO code for the US is "840".
|
Email String |
Customer's email address. This optional field contains the customer's email address. |
Fax String |
Customer's fax number. This optional field contains the customer's fax number. |
FirstName String |
Customer's first name. This field contains the customer's first name. |
FullName String |
Customer's full name. This field contains the customer's full name as it appears on the credit card or bank account. Many gateways use this field in addition to, or instead of, the FirstName and LastName fields. If a gateway requires a FullName and the field is empty, FullName will be constructed using the contents of FirstName and LastName. |
Id String |
Merchant-generated customer Id. This field contains a merchant-generated customer identification number. This number should be unique for each different customer that places an order with the merchant. |
LastName String |
Customer's last name. This field contains the customer's last name as it appears on their credit card.
|
Phone String |
Customer's phone number. This optional field contains the customer's phone number. |
State String |
Customer's state. This field is used as part of the Address Verification Service (AVS) and contains the two character postal abbreviation of the customer's state as it appears on their monthly statement. Other AVS fields include Address, City, and Zip. |
Zip String |
Customer's zip code (or postal code if outside of the USA). This field is used as part of the Address Verification Service (AVS), and contains the customer's zip code as it appears on their monthly statement. Other AVS fields include Address, City, and State.
|
Constructors
public EPCustomer();