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 property allows you to get or set an XML aggregate built from all of the Card properties.
"EPCardType" is the root element. The Card properties make up the tags under the root, but
without the beginning "Card". For instance:
<EPCardType> <Number>4444333322221111</Number> <CVV2Data>996</CVV2Data> <CVVIndicator>cvPresent</CVVIndicator> <ExpMonth>12</ExpMonth> <ExpYear>2010</ExpYear> <Type>ctVisa</Type> </EPCardType> | ||||||||||||||||||||
|
cardType TCardTypes |
Type of credit card being used in this transaction. This property 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.
| ||||||||||||||||||||
|
cvvData String |
Three digit security code on back of card (optional). This alphanumeric property 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 property 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 property 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 property is used to indicate the presence of CVVData. The class 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:
| ||||||||||||||||||||
|
expMonth Int32 |
Expiration month of the credit card specified in Number. This property contains the expiration date of the customer's credit card, and must be in the range 1 - 12.
| ||||||||||||||||||||
|
expYear Int32 |
Expiration year of the credit card specified in Number. This property contains the expiration date of the customer's credit card. This property must be in the range 0 - 99, or 2000 - 2099. Any date before the year 2000 or after 2099 cannot be specified.
| ||||||||||||||||||||
|
isEncrypted Bool |
Determines whether data set to the Number property is validated. By default, when the Number field is set, the value will be validated and normalized. For instance, "4444-33332222 1111" will be normalized as "4444333322221111". However, any other non-numerical data entered will cause an exception to be thrown. It may be useful in some gateways to send other data in the Number field, and this can be accomplished by setting IsEncrypted to true. However, please note that in doing so automatic calculation of the CardType may be affected, and the card number will not be verified.
| ||||||||||||||||||||
|
number String |
Customer's credit card number for the transaction. If you're sending the transaction with MagneticStripe data, this property should be left empty. |
Constructors
public init()
public init(number: String, expMonth: Int32, expYear: Int32)
public init(number: String, expMonth: Int32, expYear: Int32, cVVData: String)