EPCard Type

Contains the customer's credit card information.

Remarks

This type contains the customer's credit card information.

Example: Setting the fields:

  EPCard card = new EPCard();
  card.Number = "4444333322221111";
  card.ExpMonth = 12;
  card.ExpYear = 2010;
  card.CVVData = "123";

  ICharge1.Card = card;

Example: Using the Constructors:

  ICharge1.Card = new EPCard("4444333322221111", 12, 2010, "123");

Fields

Aggregate
String

This field allows you to get or set an XML aggregate built from all of the fields from this type. "EPCardType" is the root element, and the names of the fields create the tags under the root. For instance:

<EPCardType>
  <Number>4444333322221111</Number>
  <CVV2Data>996</CVV2Data>
  <CVVIndicator>cvPresent</CVVIndicator>
  <ExpMonth>12</ExpMonth>
  <ExpYear>2010</ExpYear>	
  <CardType>ctVisa</CardType>
</EPCardType>

CardType
TCardTypes

Type of credit card being used in this transaction. This field contains the customer's credit card type. This is automatically computed after the Number is set, but it can also be changed manually. A list of valid card types is included below.


ctUnknown (0)	Invalid or unknown prefix, card type not known.
ctVisa (1)	Visa or Delta Card.
ctMasterCard (2)	MasterCard.
ctAMEX (3)	American Express Card.
ctDiscover (4)	Discover Card.
ctDiners (5)	Diners Club or Carte Blanche Card.
ctJCB (6)	JCB Card.
ctVisaElectron (7)	Visa Electron Card (runs as a Visa for most gateways)
ctMaestro (8)	Maestro Card
ctLaser (10)	Laser Card (Ireland)

CVVData
String

Three digit security code on back of card (optional).

This alphanumeric field contains the three digit Visa "Card Verification Value" (CVV), MasterCard "Card Verification Code" (CVC), or four-digit American Express "Card Identification Number" (CID). This value appears as additional characters embossed on the card signature line following the credit card account number on the back of the credit card. This is an optional field which can be used to determine if the customer is actually in possession of the credit card.

Even if the CVVData is incorrect, the transaction may still be authorized. It is up to the merchant to examine the ResponseCVVResult field and decide whether to honor the transaction or not.

Note: When set to a non-empty value, CVVPresence will be automatically set to cvpProvided. If set to empty string (""), CVVPresence will be automatically set to cvpNotProvided.

CVVPresence
CCCVVPresences

Indicates the presence of the card verification value.

This field is used to indicate the presence of CVVData.

The component will automatically set this value to cvpProvided when a CVVData value is specified. You can explicitly specify the CVVPresence indicator by setting this property.

Available values are:

cvpNotProvided (0)
cvpProvided (1)
cvpIllegible (2)
cvpNotOnCard (3)

ExpMonth
Integer

Expiration month of the credit card specified in Number.

This field contains the expiration date of the customer's credit card, and must be in the range 1 - 12.

ExpYear
Integer

Expiration year of the credit card specified in Number.

This field contains the expiration date of the customer's credit card. This field must be in the range 0 - 99, or 2000 - 2099. Any date before the year 2000 or after 2099 cannot be specified.

Number
String

Customer's credit card number for the transaction.

If you're sending the transaction with MagneticStripe data, this field should be left empty.

Constructors

[VB.NET]
Public EPCard()

[C#]
public EPCard();

[VB.NET]
Public EPCard(ByVal CardNumber As String, ByVal ExpMonth As Integer, ByVal ExpYear As Integer)

[C#]
public EPCard(string cardNumber, int expMonth, int expYear);

[VB.NET]
Public EPCard(ByVal CardNumber As String, ByVal ExpMonth As Integer, ByVal ExpYear As Integer, ByVal CVVData As String)

[C#]
public EPCard(string cardNumber, int expMonth, int expYear, string CVVData);