E-Payment Integrator 2020 Kotlin Edition

Questions / Feedback?

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
Int

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
Int

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.

IsEncrypted
Boolean

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 field should be left empty.

Constructors

public constructor()



public constructor(number: String?, expMonth: Int, expYear: Int)



public constructor(number: String?, expMonth: Int, expYear: Int, cvvData: String?)



Copyright (c) 2021 /n software inc. - All rights reserved.
E-Payment Integrator 2020 Kotlin Edition - Version 20.0 [Build 7941]