FDMSRcDetailRecord Module

Properties   Methods   Events   Config Settings   Errors  

The FDMSRcDetailRecord module is a tool used to create off-line Refund or Force/VoiceApproved transactions to be settled by the FDMSRcSettle module. The FDMSRcDetailRecord module may also be used to modify the XML aggregates returned by the FDMSRcRetail or FDMSRcECommerce module's GetDetailAggregate method.

Syntax

DPaymentsSDK.Fdmsrcdetailrecord

Remarks

Creating off-line transactions means that there is no authorization of funds using the FDMSRcECommerce, or FDMSRcRetail classs. Instead, you must manually add these transactions to the settlement batch. The FDMSRcDetailRecord class can be used to create these transactions, which can then be added to the FDMSRcSettle class's DetailRecord array property.

To create an off-line Refund, first set the TransactionType to fttRefundCredit, and then set the IndustryType and CardEntryDataSource based on whether you have a card reader, and how your customer is authenticated. The following example shows how this should be set for MOTO:

FDMSRcDetailRecord.TransactionType = fttRefundCredit FDMSRcDetailRecord.IndustryType = fitRcMOTO FDMSRcDetailRecord.CardEntryDataSource = edsManualEntryNoCardReader

Next, set the CardNumber, CardExpMonth, CardExpYear, TotalAuthorizedAmount, and SettlementAmount. Note that since this is an off-line transaction, the TotalAuthorizedAmount MUST be zero.

FDMSRcDetailRecord.CardNumber = "371030089111114" FDMSRcDetailRecord.CardExpMonth = 12 FDMSRcDetailRecord.CardExpYear = 2025 FDMSRcDetailRecord.TotalAuthorizedAmount = "0" FDMSRcDetailRecord.SettlementAmount = "5000" ' $50.00

Finally, set the FDMSRcSettle class's DetailRecord array property with the value returned by the GetDetailAggregate method. You've just added a Refund to the settlement.

FDMSRcSettle.DetailRecordCount = 1 FDMSRcSettle.DetailRecordAggregate(0) = FDMSRcDetailRecord.GetDetailAggregate()

Forced/VoiceApproved transactions are similar to refunds, with the exception that a Forced transaction requires a Voice Authorization code obtained from your acquiring bank's call center. Generally, the purchase of large high-dollar items (cars, appliances, etc) will require the merchant to call and receive a voice authorization. Once this code is received, it should be set to the ApprovalCode property. The following example shows a Force/VoiceApproved transaction in a Retail environment.

FDMSRcDetailRecord.TransactionType = fttVoiceApproved FDMSRcDetailRecord.IndustryType = fitRcRetail FDMSRcDetailRecord.CardEntryDataSource = edsTrack1 FDMSRcDetailRecord.CardNumber = "4444333322221111" FDMSRcDetailRecord.CardExpMonth = 12 FDMSRcDetailRecord.CardExpYear = 2025 FDMSRcDetailRecord.TotalAuthorizedAmount = "0" FDMSRcDetailRecord.SettlementAmount = "500000" '$5000.00 FDMSRcDetailRecord.ApprovalCode = "123456" FDMSRcSettle.DetailRecordCount = 1 FDMSRcSettle.DetailRecord(0) = FDMSRcDetailRecord.GetDetailAggregate()

In addition to creating off-line Refund and Force transactions, the FDMSRcDetailRecord class can be used to adjust the Detail Records returned from the FDMSRcECommerce and FDMSRcRetail classs. For instance, one reason to modify these detail records is to add Installment payment info (fitRcDirectMarketing or fitRcMOTO IndustryType) to the detail record.

To settle an Installment transaction, you must use the FDMSRcDetailrecord class to add the number of this installment and the total count of all installments to be made. For instance, if the purchase was for "Three easy payments of $19.95", and this is the first payment, then the installment number will be 1, and the installment count 3. An example is included below:

FDMSRcECommerce.Config("BillPaymentType=3") // 3=Installment FDMSRcECommerce.TransactionAmount = "1995" FDMSRcECommerce.AuthOnly() FDMSRcDetailRecord.ParseAggregate(FDMSRcECommerce.GetDetailAggregate()) FDMSRcDetailRecord.InstallmentCount = 3 FDMSRcDetailRecord.InstallmentNumber = 1 FDMSRcSettle.DetailRecordAggregate(5) = FDMSRcDetailRecord.GetDetailAggregate()

Property List


The following is the full list of the properties of the module with short descriptions. Click on the links for further details.

ApprovalCodeApproval code of the Voice/Force transaction to be sent for settlement.
ArrivalDateThe arrival date of the guest.
CardEntryDataSourceThis property identifies the source of the customer data.
CardExpMonthExpiration month of the credit card specified in CardNumber .
CardExpYearExpiration year of the credit card specified in CardNumber .
CardholderNameThe name of the Cardholder.
CardNumberCustomer's credit card number from the original authorization request.
CashBackAmount of cash that was returned to the customer.
DepartureDateThe departure date of the guest.
DurationLength of hotel stay in days.
ECIIdentifies the security level of the ECommerce transaction.
ExtraChargesList of extra charges for hotel transactions.
FolioNumberThe Folio or Room Agreement number assigned by the hotel.
HotelNoShowIndicates whether the guest did not show.
IndustryTypeThe merchant's industry type.
InstallmentCountTotal number of installments (installment transactions only).
InstallmentNumberCurrent installment number (installment transactions only).
Level2Specifies Level 2 (purchasing card information).
LodgingChargeTypeType of charge made at a hotel.
LodgingPhoneNumberPhone number of the property the customer stayed at.
LodgingReferenceNumberA reference number assigned by the hotel/lodging establishment.
MerchantServicePhoneThe merchant's phone number, used to assist cardholders.
MerchantURLThe URL of the site performing the ECommerce transaction.
OrderNumberA merchant assigned order number to uniquely reference the transaction.
ProgramIndicatorIndicates the reason for the charge in a hotel transaction.
ReferenceNumberA value assigned by the merchant to uniquely reference a transaction and any subsequent related transactions.
RoomNumberThe Room Number assigned by the hotel.
RoomRateThe daily room rate in a hotel transaction.
RoomTaxThe daily room tax amount.
SettlementAmountThe amount that the customer will be charged.
STANThe merchant assigned System Trace Audit Number(STAN).
TotalAuthorizedAmountSum total of all the original authorization and all subsequent incremental authorizations.
TransactionTypeIndicates transaction type for this detail record.

Method List


The following is the full list of the methods of the module with short descriptions. Click on the links for further details.

ConfigSets or retrieves a configuration setting.
GetDetailAggregateReturns a detail aggregate containing details of this transaction, which is used for Capture or Reverse transactions or settlement when using Terminal Capture mode.
ParseAggregateParses the aggregate returned from another module's GetDetailAggregate method.
ResetClears all properties to their default values.

Event List


The following is the full list of the events fired by the module with short descriptions. Click on the links for further details.

ErrorFired when information is available about errors during data delivery.

Config Settings


The following is a list of config settings for the module with short descriptions. Click on the links for further details.

ACIAuthorization Characteristics Indicator.
CardInputModeThe method used to input the card details.
CurrencyCodeCurrency Code for this transaction.
LocalTransactionDateThe local date of the transaction.
MOTOIndicatorIndicates whether the transaction is Mail Order or Telephone Order.
POSConditionCodeThe POS condition code.
TerminalCardCapabilityThe terminal's card capture capability.
TerminalCategoryCodeThe Terminal Category Code.
TerminalEntryCapabilityThe terminal's entry mode capability.
TerminalLocationIndicatorThe terminal's location.
TerminalPinCapabilityThe terminal's PIN capability.
UTCTransactionDateThe UTC date of the transaction.
BuildInfoInformation about the product's build.
CodePageThe system code page used for Unicode to Multibyte translations.
LicenseInfoInformation about the current license.
MaskSensitiveWhether sensitive data is masked in log messages.
UseInternalSecurityAPIWhether or not to use the system security libraries or an internal implementation.

ApprovalCode Property (FDMSRcDetailRecord Module)

Approval code of the Voice/Force transaction to be sent for settlement.

Syntax

public var approvalCode: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=approvalCode,setter=setApprovalCode:) NSString* approvalCode;

- (NSString*)approvalCode;
- (void)setApprovalCode :(NSString*)newApprovalCode;

Default Value

""

Remarks

This property should be set with the approval code the merchant gets over the phone for a Voice/Force transaction.

ArrivalDate Property (FDMSRcDetailRecord Module)

The arrival date of the guest.

Syntax

public var arrivalDate: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=arrivalDate,setter=setArrivalDate:) NSString* arrivalDate;

- (NSString*)arrivalDate;
- (void)setArrivalDate :(NSString*)newArrivalDate;

Default Value

""

Remarks

Date the guest checked in, or the expected arrival date when authorizing a reservation. The date specified should be in the format "MMDDYY".

Note: The Arrival Date must be a date that precedes the Departure Date.

CardEntryDataSource Property (FDMSRcDetailRecord Module)

This property identifies the source of the customer data.

Syntax

public var cardEntryDataSource: FdmsrcdetailrecordCardEntryDataSources {
  get {...}
  set {...}
}

public enum FdmsrcdetailrecordCardEntryDataSources: Int32 { case edsTrack1 = 0 case edsTrack2 = 1 case edsManualEntryTrack1Capable = 2 case edsManualEntryTrack2Capable = 3 case edsManualEntryNoCardReader = 4 case edsTrack1Contactless = 5 case edsTrack2Contactless = 6 case edsManualEntryContactlessCapable = 7 case edsIVR = 8 case edsKiosk = 9 }

@property (nonatomic,readwrite,assign,getter=cardEntryDataSource,setter=setCardEntryDataSource:) int cardEntryDataSource;

- (int)cardEntryDataSource;
- (void)setCardEntryDataSource :(int)newCardEntryDataSource;

Default Value

0

Remarks

Allowable values include: This property contains a 1-character code identifying the source of the customer data.

edsTrack1 (0) Full Magnetic stripe read and transmit, Track 1.
edsTrack2 (1) Full magnetic stripe read and transmit, Track 2.
edsManualEntryTrack1Capable (2) Manually keyed, Track 1 capable.
edsManualEntryTrack2Capable (3)Manually keyed, Track 2 capable.
edsManualEntryNoCardReader (4)Manually keyed, terminal has no card reading capability (use this for e-commerce and MOTO transactions).
edsTrack1Contactless (5)Full magnetic stripe read (Track 1 only), Chip Card capable terminal (Visa, Mastercard, and JCB Transactions only).
edsTrack2Contactless (6)Full magnetic stripe read (Track 2 only), Chip Card capable terminal (Visa, Mastercard, and JCB Transactions only).
edsManualEntryContactlessCapable (7)Manually keyed, Chip Card read capable terminal (Visa, MasterCard, and JCB transactions only).

CardExpMonth Property (FDMSRcDetailRecord Module)

Expiration month of the credit card specified in CardNumber .

Syntax

public var cardExpMonth: Int32 {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=cardExpMonth,setter=setCardExpMonth:) int cardExpMonth;

- (int)cardExpMonth;
- (void)setCardExpMonth :(int)newCardExpMonth;

Default Value

1

Remarks

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

CardExpYear Property (FDMSRcDetailRecord Module)

Expiration year of the credit card specified in CardNumber .

Syntax

public var cardExpYear: Int32 {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=cardExpYear,setter=setCardExpYear:) int cardExpYear;

- (int)cardExpYear;
- (void)setCardExpYear :(int)newCardExpYear;

Default Value

2000

Remarks

This field 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 cannot be specified.

CardholderName Property (FDMSRcDetailRecord Module)

The name of the Cardholder.

Syntax

public var cardholderName: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=cardholderName,setter=setCardholderName:) NSString* cardholderName;

- (NSString*)cardholderName;
- (void)setCardholderName :(NSString*)newCardholderName;

Default Value

""

Remarks

This property is used to specify the name of the cardholder.

CardNumber Property (FDMSRcDetailRecord Module)

Customer's credit card number from the original authorization request.

Syntax

public var cardNumber: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=cardNumber,setter=setCardNumber:) NSString* cardNumber;

- (NSString*)cardNumber;
- (void)setCardNumber :(NSString*)newCardNumber;

Default Value

""

Remarks

This field contains the customer's credit card number used in the original authorization request. This alphanumeric field can be a maximum of 22 characters long, excluding whitespace and dashes which are stripped out when the property is set.

CashBack Property (FDMSRcDetailRecord Module)

Amount of cash that was returned to the customer.

Syntax

public var cashBack: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=cashBack,setter=setCashBack:) NSString* cashBack;

- (NSString*)cashBack;
- (void)setCashBack :(NSString*)newCashBack;

Default Value

""

Remarks

This property should reflect the cash back amount from the original debit or EBT card sale. The value sent in the settlement MUST be identical to the amount approved in the sale.

DepartureDate Property (FDMSRcDetailRecord Module)

The departure date of the guest.

Syntax

public var departureDate: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=departureDate,setter=setDepartureDate:) NSString* departureDate;

- (NSString*)departureDate;
- (void)setDepartureDate :(NSString*)newDepartureDate;

Default Value

""

Remarks

Date the guest checked out, or the expected departure date when authorizing a reservation. The date specified should be in the format "MMDDYY".

Note: The Departure Date must be a date that is after the Arrival Date.

Duration Property (FDMSRcDetailRecord Module)

Length of hotel stay in days.

Syntax

public var duration: Int32 {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=duration,setter=setDuration:) int duration;

- (int)duration;
- (void)setDuration :(int)newDuration;

Default Value

1

Remarks

The number of days the guest stayed in the hotel, or the expected duration of stay when authorizing a reservation. This field must be between 1 and 99 days.

ECI Property (FDMSRcDetailRecord Module)

Identifies the security level of the ECommerce transaction.

Syntax

public var eci: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=ECI,setter=setECI:) NSString* ECI;

- (NSString*)ECI;
- (void)setECI :(NSString*)newECI;

Default Value

""

Remarks

This setting specifies the security level of the ECommerce transaction. In most cases this does not need to be changed. A common reason for modifying this value is when supplying 3-D secure values. Possible values are:

01 Merchant is 3-D Secure capable and the cardholder information is fully authenticated.
02 Merchant is 3-D Secure capable but the cardholder was not authenticated. Use this value when authentication was attempted but the issuer is not participating in 3-D Secure, the cardholder is not participating in 3-D Secure, or the authentication server was not available.
03 3-D Secure was not attempted.
This is only applicable when IndustryType is set to fitRcDirectMarketing or fitRcHotel.

ExtraCharges Property (FDMSRcDetailRecord Module)

List of extra charges for hotel transactions.

Syntax

public var extraCharges: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=extraCharges,setter=setExtraCharges:) NSString* extraCharges;

- (NSString*)extraCharges;
- (void)setExtraCharges :(NSString*)newExtraCharges;

Default Value

""

Remarks

This property contains a six-character numeric value used to identify any additional ancillary charges that are booked to the cardholder's card after the transaction was completed. The merchant may enter one or more codes on each transaction being settled. If extra charges are being submitted, this field must contain value(s) as defined below.

Value Hotel Definition
0 None.
2 Restaurant.
3 Gift Shop.
4 Mini Bar.
5 Telephone.
6 Other.
7 Laundry.

For example, to indicate charges in both the gift shop and mini bar, ExtraCharges should equal "34".

This field is only applicable to Visa card transactions when IndustryType is Hotel and will not be sent for any other industry types.

FolioNumber Property (FDMSRcDetailRecord Module)

The Folio or Room Agreement number assigned by the hotel.

Syntax

public var folioNumber: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=folioNumber,setter=setFolioNumber:) NSString* folioNumber;

- (NSString*)folioNumber;
- (void)setFolioNumber :(NSString*)newFolioNumber;

Default Value

""

Remarks

This is a 12 alphanumeric code assigned by the hotel during the transaction.

HotelNoShow Property (FDMSRcDetailRecord Module)

Indicates whether the guest did not show.

Syntax

public var hotelNoShow: Bool {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=hotelNoShow,setter=setHotelNoShow:) BOOL hotelNoShow;

- (BOOL)hotelNoShow;
- (void)setHotelNoShow :(BOOL)newHotelNoShow;

Default Value

False

Remarks

This property can be set to 'True' to indicate that the guest did not show.

IndustryType Property (FDMSRcDetailRecord Module)

The merchant's industry type.

Syntax

public var industryType: FdmsrcdetailrecordIndustryTypes {
  get {...}
  set {...}
}

public enum FdmsrcdetailrecordIndustryTypes: Int32 { case fitRcUnknown = 0 case fitRcRetail = 1 case fitRcRestaurant = 2 case fitRcGroceryStore = 3 case fitRcDirectMarketing = 4 case fitRcHotel = 5 case fitRcMOTO = 6 }

@property (nonatomic,readwrite,assign,getter=industryType,setter=setIndustryType:) int industryType;

- (int)industryType;
- (void)setIndustryType :(int)newIndustryType;

Default Value

0

Remarks

The merchant's industry type. Possible values are:

fitRcUnknown (0) Unknown or unsure.
fitRcRetail (1) Retail store.
fitRcRestaurant (2) Food / Restaurant.
fitRcGroceryStore (3) Grocery store or supermarket.
fitRcDirectMarketing (4) eCommerce or Direct Marketing
fitRcHotel (5) Hotel / Lodging.
fitRcMOTO (6) Mail Order / Telephone Order

InstallmentCount Property (FDMSRcDetailRecord Module)

Total number of installments (installment transactions only).

Syntax

public var installmentCount: Int32 {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=installmentCount,setter=setInstallmentCount:) int installmentCount;

- (int)installmentCount;
- (void)setInstallmentCount :(int)newInstallmentCount;

Default Value

0

Remarks

This property is used when charging installment payments. The InstallmentCount indicates the total number of installments to be charged to the customer, and the InstallmentNumber indicates the current installment which is being charged. Installment payments can only be made for card-not-present transactions initiated by the FDMSRcEcommerce class.

To settle an Installment transaction, you must use the FDMSRcDetailrecord class to add the number of this installment and the total count of all installments to be made. For instance, if the purchase was for "Three easy payments of $19.95", and this is the first payment, then the installment number will be 1, and the installment count 3. An example is included below:

FDMSRcECommerce.Config("BillPaymentType=3") // 3=Installment FDMSRcECommerce.TransactionAmount = "1995" FDMSRcECommerce.AuthOnly() FDMSRcDetailRecord.ParseAggregate(FDMSRcECommerce.GetDetailAggregate()) FDMSRcDetailRecord.InstallmentCount = 3 FDMSRcDetailRecord.InstallmentNumber = 1 FDMSRcSettle.DetailRecordAggregate(5) = FDMSRcDetailRecord.GetDetailAggregate()

InstallmentNumber Property (FDMSRcDetailRecord Module)

Current installment number (installment transactions only).

Syntax

public var installmentNumber: Int32 {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=installmentNumber,setter=setInstallmentNumber:) int installmentNumber;

- (int)installmentNumber;
- (void)setInstallmentNumber :(int)newInstallmentNumber;

Default Value

0

Remarks

This property is used when charging installment payments. The InstallmentCount indicates the total number of installments to be charged to the customer, and the InstallmentNumber indicates the current installment which is being charged. Installment payments can only be made for card-not-present transactions initiated by the FDMSRcEcommerce class.

To settle an Installment transaction, you must use the FDMSRcDetailrecord class to add the number of this installment and the total count of all installments to be made. For instance, if the purchase was for "Three easy payments of $19.95", and this is the first payment, then the installment number will be 1, and the installment count 3. An example is included below:

FDMSRcECommerce.Config("BillPaymentType=3") // 3=Installment FDMSRcECommerce.TransactionAmount = "1995" FDMSRcECommerce.AuthOnly() FDMSRcDetailRecord.ParseAggregate(FDMSRcECommerce.GetDetailAggregate()) FDMSRcDetailRecord.InstallmentCount = 3 FDMSRcDetailRecord.InstallmentNumber = 1 FDMSRcSettle.DetailRecordAggregate(5) = FDMSRcDetailRecord.GetDetailAggregate()

Level2 Property (FDMSRcDetailRecord Module)

Specifies Level 2 (purchasing card information).

Syntax

public var level2: FDMSRcLevel2 {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=level2CustomerReferenceNumber,setter=setLevel2CustomerReferenceNumber:) NSString* level2CustomerReferenceNumber;

- (NSString*)level2CustomerReferenceNumber;
- (void)setLevel2CustomerReferenceNumber :(NSString*)newLevel2CustomerReferenceNumber;

@property (nonatomic,readwrite,assign,getter=level2DestinationCountryCode,setter=setLevel2DestinationCountryCode:) NSString* level2DestinationCountryCode;

- (NSString*)level2DestinationCountryCode;
- (void)setLevel2DestinationCountryCode :(NSString*)newLevel2DestinationCountryCode;

@property (nonatomic,readwrite,assign,getter=level2DestinationPostalCode,setter=setLevel2DestinationPostalCode:) NSString* level2DestinationPostalCode;

- (NSString*)level2DestinationPostalCode;
- (void)setLevel2DestinationPostalCode :(NSString*)newLevel2DestinationPostalCode;

@property (nonatomic,readwrite,assign,getter=level2DiscountAmount,setter=setLevel2DiscountAmount:) NSString* level2DiscountAmount;

- (NSString*)level2DiscountAmount;
- (void)setLevel2DiscountAmount :(NSString*)newLevel2DiscountAmount;

@property (nonatomic,readwrite,assign,getter=level2DutyAmount,setter=setLevel2DutyAmount:) NSString* level2DutyAmount;

- (NSString*)level2DutyAmount;
- (void)setLevel2DutyAmount :(NSString*)newLevel2DutyAmount;

@property (nonatomic,readwrite,assign,getter=level2FreightAmount,setter=setLevel2FreightAmount:) NSString* level2FreightAmount;

- (NSString*)level2FreightAmount;
- (void)setLevel2FreightAmount :(NSString*)newLevel2FreightAmount;

@property (nonatomic,readwrite,assign,getter=level2MerchantTaxId,setter=setLevel2MerchantTaxId:) NSString* level2MerchantTaxId;

- (NSString*)level2MerchantTaxId;
- (void)setLevel2MerchantTaxId :(NSString*)newLevel2MerchantTaxId;

@property (nonatomic,readwrite,assign,getter=level2ProductDescription,setter=setLevel2ProductDescription:) NSString* level2ProductDescription;

- (NSString*)level2ProductDescription;
- (void)setLevel2ProductDescription :(NSString*)newLevel2ProductDescription;

@property (nonatomic,readwrite,assign,getter=level2PurchaseIdentifier,setter=setLevel2PurchaseIdentifier:) NSString* level2PurchaseIdentifier;

- (NSString*)level2PurchaseIdentifier;
- (void)setLevel2PurchaseIdentifier :(NSString*)newLevel2PurchaseIdentifier;

@property (nonatomic,readwrite,assign,getter=level2ShipFromPostalCode,setter=setLevel2ShipFromPostalCode:) NSString* level2ShipFromPostalCode;

- (NSString*)level2ShipFromPostalCode;
- (void)setLevel2ShipFromPostalCode :(NSString*)newLevel2ShipFromPostalCode;

@property (nonatomic,readwrite,assign,getter=level2TaxAmount,setter=setLevel2TaxAmount:) NSString* level2TaxAmount;

- (NSString*)level2TaxAmount;
- (void)setLevel2TaxAmount :(NSString*)newLevel2TaxAmount;

@property (nonatomic,readwrite,assign,getter=level2TaxIndicator,setter=setLevel2TaxIndicator:) int level2TaxIndicator;

- (int)level2TaxIndicator;
- (void)setLevel2TaxIndicator :(int)newLevel2TaxIndicator;

 

Default Value

0

Remarks

This property specifies Level 2 (purchasing card information).

The values required for Level 2 transaction depend on the card type. The following tables indicate which properties are valid for what card type:

American Express

  • Level2CustomerReferenceNumber (required if Level2TaxAmount specified)
  • Level2DestinationPostalCode (required)
  • Level2DiscountAmount (required if discount applied)
  • Level2DutyAmount (required if duty amount applied)
  • Level2FreightAmount (required if freight amount applied)
  • Level2ProductDescription (required)
  • Level2PurchaseIdentifier (required)
  • Level2MerchantTaxId
  • Level2ShipFromPostalCode
  • Level2TaxAmount
  • Level2TaxIndicator
Visa
  • Level2CustomerReferenceNumber (required if Level2TaxAmount specified)
  • Level2DiscountAmount (required if discount applied)
  • Level2DutyAmount (required if duty amount applied)
  • Level2FreightAmount (required if freight amount applied)
  • Level2PurchaseIdentifier (required)
  • Level2TaxAmount (required if Level2TaxIndicator indicates tax is applied)
  • Level2TaxIndicator (required)
  • Level2DestinationPostalCode
  • Level2ShipFromPostalCode
  • Level2MerchantTaxId
MasterCard
  • Level2CustomerReferenceNumber (required if Level2TaxAmount specified)
  • Level2DiscountAmount (required if discount applied)
  • Level2DutyAmount (required if duty amount applied)
  • Level2FreightAmount (required if freight amount applied)
  • Level2MerchantTaxId (required)
  • Level2PurchaseIdentifier (required)
  • Level2TaxAmount (required if Level2TaxIndicator indicates tax is applied)
  • Level2TaxIndicator (required)
  • Level2DestinationPostalCode
  • Level2ShipFromPostalCode

LodgingChargeType Property (FDMSRcDetailRecord Module)

Type of charge made at a hotel.

Syntax

public var lodgingChargeType: FdmsrcdetailrecordLodgingChargeTypes {
  get {...}
  set {...}
}

public enum FdmsrcdetailrecordLodgingChargeTypes: Int32 { case lctLodging = 0 case lctRestaurant = 1 case lctGiftShop = 2 }

@property (nonatomic,readwrite,assign,getter=lodgingChargeType,setter=setLodgingChargeType:) int lodgingChargeType;

- (int)lodgingChargeType;
- (void)setLodgingChargeType :(int)newLodgingChargeType;

Default Value

0

Remarks

This property contains an indicator used to identify a hotel charge type. It must contain one of the values defined below:

  • lctLodging (0)
  • lctRestaurant (1)
  • lctGiftShop (2)

Note, this property is only applicable when using the Hotel IndustryType.

LodgingPhoneNumber Property (FDMSRcDetailRecord Module)

Phone number of the property the customer stayed at.

Syntax

public var lodgingPhoneNumber: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=lodgingPhoneNumber,setter=setLodgingPhoneNumber:) NSString* lodgingPhoneNumber;

- (NSString*)lodgingPhoneNumber;
- (void)setLodgingPhoneNumber :(NSString*)newLodgingPhoneNumber;

Default Value

""

Remarks

This 10 character field contains the customer service phone number without dashes or spaces. The initial "1" for long-distance or toll-free calls should be omitted. For instance, "8001234567" is acceptable, while "18001234567" or "1-800-123-4567" is not.

Note, this property is only applicable when using the Hotel IndustryType.

LodgingReferenceNumber Property (FDMSRcDetailRecord Module)

A reference number assigned by the hotel/lodging establishment.

Syntax

public var lodgingReferenceNumber: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=lodgingReferenceNumber,setter=setLodgingReferenceNumber:) NSString* lodgingReferenceNumber;

- (NSString*)lodgingReferenceNumber;
- (void)setLodgingReferenceNumber :(NSString*)newLodgingReferenceNumber;

Default Value

""

Remarks

This is a 9 character identifier assigned by the hotel/lodging for the transaction.

MerchantServicePhone Property (FDMSRcDetailRecord Module)

The merchant's phone number, used to assist cardholders.

Syntax

public var merchantServicePhone: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=merchantServicePhone,setter=setMerchantServicePhone:) NSString* merchantServicePhone;

- (NSString*)merchantServicePhone;
- (void)setMerchantServicePhone :(NSString*)newMerchantServicePhone;

Default Value

""

Remarks

This property specifies a 10 digit phone number which cardholders can call for assistance.

This value is required for fitRcMOTO transactions. It is recommended but not required for fitRcDirectMarketing and fitRcHotel transactions.

MerchantURL Property (FDMSRcDetailRecord Module)

The URL of the site performing the ECommerce transaction.

Syntax

public var merchantURL: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=merchantURL,setter=setMerchantURL:) NSString* merchantURL;

- (NSString*)merchantURL;
- (void)setMerchantURL :(NSString*)newMerchantURL;

Default Value

""

Remarks

This property specifies the URL of the merchant's site.

For Visa and Discover transactions this value is limited to 13 characters. For all other card types this value is limited to 32 characters.

This is only applicable when the IndustryType is set to fitRcDirectMarketing or fitRcHotel.

OrderNumber Property (FDMSRcDetailRecord Module)

A merchant assigned order number to uniquely reference the transaction.

Syntax

public var orderNumber: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=orderNumber,setter=setOrderNumber:) NSString* orderNumber;

- (NSString*)orderNumber;
- (void)setOrderNumber :(NSString*)newOrderNumber;

Default Value

""

Remarks

This property holds a merchant assigned order number that uniquely identifies the transaction. This must hold a numeric value up to 8 digits in length. This value cannot be all zeros.

This value is required for ECommerce and MOTO transactions. This value is optional for Retail transactions.

ProgramIndicator Property (FDMSRcDetailRecord Module)

Indicates the reason for the charge in a hotel transaction.

Syntax

public var programIndicator: Int32 {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=programIndicator,setter=setProgramIndicator:) int programIndicator;

- (int)programIndicator;
- (void)setProgramIndicator :(int)newProgramIndicator;

Default Value

1

Remarks

This is used to specify the program indicator for a hotel/lodging transaction. This property is not applicable for Mastercards.

Valid Values:

Value Description
1 (Default) Normal Charge (Visa, Amex)
2 Assured Reservation No Show (Visa, Amex, Discover)
3 Card Deposit (Visa, Amex)
4 Delayed Charge (Visa, Amex, Discover)
5 Express Service (Visa, Amex)
6 Assured Reservation (Visa, Amex)

ReferenceNumber Property (FDMSRcDetailRecord Module)

A value assigned by the merchant to uniquely reference a transaction and any subsequent related transactions.

Syntax

public var referenceNumber: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=referenceNumber,setter=setReferenceNumber:) NSString* referenceNumber;

- (NSString*)referenceNumber;
- (void)setReferenceNumber :(NSString*)newReferenceNumber;

Default Value

""

Remarks

This value is a merchant assigned 10 bytes value. The value must be unique within a day for a given merchant id and terminal id. The Reference Number entered in the DetailRecord should be the same as the Reference Number submitted in the original transaction.

RoomNumber Property (FDMSRcDetailRecord Module)

The Room Number assigned by the hotel.

Syntax

public var roomNumber: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=roomNumber,setter=setRoomNumber:) NSString* roomNumber;

- (NSString*)roomNumber;
- (void)setRoomNumber :(NSString*)newRoomNumber;

Default Value

""

Remarks

This is a 6 character room number code assigned by the hotel during the transaction.

RoomRate Property (FDMSRcDetailRecord Module)

The daily room rate in a hotel transaction.

Syntax

public var roomRate: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=roomRate,setter=setRoomRate:) NSString* roomRate;

- (NSString*)roomRate;
- (void)setRoomRate :(NSString*)newRoomRate;

Default Value

""

Remarks

This property contains the daily rate for one room at the lodging property.

RoomTax Property (FDMSRcDetailRecord Module)

The daily room tax amount.

Syntax

public var roomTax: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=roomTax,setter=setRoomTax:) NSString* roomTax;

- (NSString*)roomTax;
- (void)setRoomTax :(NSString*)newRoomTax;

Default Value

""

Remarks

This property contains the daily Room Tax for lodging.

SettlementAmount Property (FDMSRcDetailRecord Module)

The amount that the customer will be charged.

Syntax

public var settlementAmount: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=settlementAmount,setter=setSettlementAmount:) NSString* settlementAmount;

- (NSString*)settlementAmount;
- (void)setSettlementAmount :(NSString*)newSettlementAmount;

Default Value

"0"

Remarks

This field contains the final settlement amount of the transaction. In most cases, this is the TransactionAmount from the original authorization request. However, you may settle a lesser amount (ie: Partial shipment or backordered stock).

This field must always be greater than zero.

This amount is to be presented with an implied decimal point. For example, US $10.00 must be represented as 1000, and $0.10 is likewise simply 10. The allowable number of significant digits as well as the positioning of any implied decimal point is dictated by the designated CurrencyCode configuration setting. In the United States (default), the number of allowable significant digits is seven. Thus the maximum TransactionAmount is "9999999", yielding a US dollar amount of $99,999.99. This field may not contain a negative number.

STAN Property (FDMSRcDetailRecord Module)

The merchant assigned System Trace Audit Number(STAN).

Syntax

public var stan: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=STAN,setter=setSTAN:) NSString* STAN;

- (NSString*)STAN;
- (void)setSTAN :(NSString*)newSTAN;

Default Value

""

Remarks

This property represents a six digit number assigned by the merchant to uniquely reference the transaction. This number must be unique within a day per Merchant ID and Terminal ID.

Valid values are from 000001 to 999999 inclusive.

TotalAuthorizedAmount Property (FDMSRcDetailRecord Module)

Sum total of all the original authorization and all subsequent incremental authorizations.

Syntax

public var totalAuthorizedAmount: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=totalAuthorizedAmount,setter=setTotalAuthorizedAmount:) NSString* totalAuthorizedAmount;

- (NSString*)totalAuthorizedAmount;
- (void)setTotalAuthorizedAmount :(NSString*)newTotalAuthorizedAmount;

Default Value

""

Remarks

When supporting incremental authorizations, you must manually keep track of the sum of all authorizations made for a single transaction (all based on the same transaction id). This total must be added to the TotalAuthorizedAmount property of the detail record associated with the first authorization. Only one detail record should be submitted no matter how many incremental authorizations are attached to the transaction.

TransactionType Property (FDMSRcDetailRecord Module)

Indicates transaction type for this detail record.

Syntax

public var transactionType: FdmsrcdetailrecordTransactionTypes {
  get {...}
  set {...}
}

public enum FdmsrcdetailrecordTransactionTypes: Int32 { case fttNotSet = 0 case fttAuthorization = 1 case fttAuthorizationWithCashback = 2 case fttVoiceApproved = 3 case fttEBTCashAuthorizationWithoutCashback = 4 case fttRefundCredit = 5 case fttEBTCashAuthorizationWithCashback = 6 case fttEBTCashAuthorizationCashbackOnly = 7 case fttEBTSNAPAuthorization = 8 case fttEBTSNAPVoucherClear = 9 case fttNoShowCredit = 10 case fttNoShowDebit = 11 case fttMOTOAuthorization = 12 case fttRefundDebit = 13 case fttRefundEBTSNAP = 14 }

@property (nonatomic,readwrite,assign,getter=transactionType,setter=setTransactionType:) int transactionType;

- (int)transactionType;
- (void)setTransactionType :(int)newTransactionType;

Default Value

0

Remarks

This property indicates the type of transaction that is being settled. The following table explains the Transaction Types in detail:

fttAuthorization (1) The transaction to be settled was a normal authorization and passed into the FDMSRcDetailRecord class via the ParseAggregate method.
fttAuthorizationWithCashback (2)The transaction to be settled was a normal authorization with cashback and passed into the FDMSRcDetailRecord class via the ParseAggregate method.
fttVoiceApproved (3)This transaction type is used to force a settlement without a previous authorization. This is generally used when an authorization response indicates that the merchant should call the cardholder's bank to verify the funds transfer. The merchant will then be given an authorization code over the phone, with which to settle the transaction.
fttEBTCashAuthorizationWithoutCashback (4)Settles a normal EBTCash Authorization without CashBack made using the FDMSRcBenefit class.
fttRefundCredit (5)This transaction type is used to credit money back to a cardholder's account. An (offline) credit is not based on a previous transaction, and you may credit any card for any amount without restriction. Simply set the CardNumber to the customer's card number, and then the AuthorizedAmount to "0" and the SettlementAmount to the amount you wish to refund. No track data or AVS data is sent in an offline credit transaction.
fttEBTCashAuthorizationWithCashback (6)Settles a normal EBTCash Authorization with CashBack made using the FDMSRcBenefit class.
fttEBTCashAuthorizationCashbackOnly (7)TODO
fttEBTSNAPAuthorization (8)TODO
fttEBTSNAPVoucherClear (9)TODO
fttNoShowCredit (10)Settles a normal (Credit) Authorization for HotelNoShow made using the FDMSRcRetail class.
fttNoShowDebit (11)TODO
fttMOTOAuthorization (12)Settles a normal (MOTO) Authorization transaction made using the FDMSRcECommerce class.
fttRefundDebit (13)Settles an on-line Debit Credit transaction made using the FDMSRcDebit class.
fttRefundEBTSNAP (14)Settles an on-line EBT Credit transaction made using the FDMSRcBenefit class.

Config Method (FDMSRcDetailRecord Module)

Sets or retrieves a configuration setting.

Syntax

public func config(configurationString: String) throws -> String
- (NSString*)config:(NSString*)configurationString;

Remarks

Config is a generic method available in every class. It is used to set and retrieve configuration settings for the class.

These settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the class, access to these internal properties is provided through the Config method.

To set a configuration setting named PROPERTY, you must call Config("PROPERTY=VALUE"), where VALUE is the value of the setting expressed as a string. For boolean values, use the strings "True", "False", "0", "1", "Yes", or "No" (case does not matter).

To read (query) the value of a configuration setting, you must call Config("PROPERTY"). The value will be returned as a string.

GetDetailAggregate Method (FDMSRcDetailRecord Module)

Returns a detail aggregate containing details of this transaction, which is used for Capture or Reverse transactions or settlement when using Terminal Capture mode.

Syntax

public func getDetailAggregate() throws -> String
- (NSString*)getDetailAggregate;

Remarks

This method will return a detail aggregate representing the transaction. After calling AuthOnly or Sale call this method to obtain a detail aggregate. The aggregate will be required when calling Capture or Reverse.

When using Terminal Capture Settlement Mode this aggregate must be passed to the FDMSRcSettle class's DetailAggregate array property in order to settle the transaction. If you wish to view or change any part of the aggregate (such as adding a gratuity or additional info for an Installment payment), you may use the FDMSRcDetailrecord class to do so.

Note: This method may only be called after a successful authorization. If the authorization was not successful the method .

To set the aggregate before calling Capture Reverse or SendSettlement call SetDetailAggregate. Save this aggregate in a secure location.

ParseAggregate Method (FDMSRcDetailRecord Module)

Parses the aggregate returned from another component's GetDetailAggregate method.

Syntax

public func parseAggregate(aggregate: String) throws -> Void
- (void)parseAggregate:(NSString*)aggregate;

Remarks

This method takes the XML aggregate returned from the FDMSRcRetail or FDMSRcECommerce class, parses it, and then fills all the properties of the FDMSRcDetailrecord class. While normally you can pass the results of the GetDetailAggregate method call directly to the FDMSRcSettle class, sometimes it is necessary to adjust the contents of the XML aggregate first.

Reset Method (FDMSRcDetailRecord Module)

Clears all properties to their default values.

Syntax

public func reset() throws -> Void
- (void)reset;

Remarks

This method clears all properties to their default values.

Error Event (FDMSRcDetailRecord Module)

Fired when information is available about errors during data delivery.

Syntax

func onError(errorCode: Int32, description: String)
- (void)onError:(int)errorCode :(NSString*)description;

Remarks

The Error event is fired in case of exceptional conditions during message processing. Normally the class .

The ErrorCode parameter contains an error code, and the Description parameter contains a textual description of the error. For a list of valid error codes and their descriptions, please refer to the Error Codes section.

FDMSRcLevel2 Type

Specifies Level 2 (purchasing card) information.

Remarks

This type specifies Level 2 (purchasing card) information.

Fields

customerReferenceNumber
String

Default Value: ""

The reference number or order number to be reported as part of the Purchase Card data.

If Level2TaxAmount is specified this property is required.

The value may be up to 17 characters in length.

destinationCountryCode
String

Default Value: ""

This field represents the country code of the location the items in this purchase are being delivered to.

This value is the ISO 3166 three digit numeric identifier.

destinationPostalCode
String

Default Value: ""

This property contains the postal or zip code of the location the item(s) in this purchase are being delivered to.

This property is required for American Express purchase card transactions. This is the same as the when the customer takes possession of the items at the merchant location.

The value may be up to 9 characters.

discountAmount
String

Default Value: ""

This property contains the discount amount for the purchase.

This property is required for Visa, MasterCard, and American Express purchase card transactions when a discount has been applied.

This amount is to be presented with an implied decimal point. For example, US $10.00 must be represented as 1000, and $0.10 is likewise simply 10. The positioning of any implied decimal point is dictated by the CurrencyCode. The default currency code is for the United States.

The maximum number of digits allowed is 12 regardless of the position of the implied decimal point. This field may not contain a negative number.

dutyAmount
String

Default Value: ""

This property contains the duty amount for this purchase.

This property is required for Visa, MasterCard, and American Express purchase card transactions when a duty amount has been applied.

This amount is to be presented with an implied decimal point. For example, US $10.00 must be represented as 1000, and $0.10 is likewise simply 10. The positioning of any implied decimal point is dictated by the CurrencyCode. The default currency code is for the United States.

The maximum number of digits allowed is 12 regardless of the position of the implied decimal point. This field may not contain a negative number.

freightAmount
String

Default Value: ""

This property contains the amount for freight included in this purchase.

This property is required for Visa, MasterCard, and American Express purchase card transactions when a freight amount has been applied.

This amount is to be presented with an implied decimal point. For example, US $10.00 must be represented as 1000, and $0.10 is likewise simply 10. The positioning of any implied decimal point is dictated by the CurrencyCode. The default currency code is for the United States.

The maximum number of digits allowed is 12 regardless of the position of the implied decimal point. This field may not contain a negative number.

merchantTaxId
String

Default Value: ""

This property should contain the Tax Id collected by the merchant for this transaction.

This property is required for MasterCard purchase card transactions.

The value may be up to 15 characters in length.

productDescription
String

Default Value: ""

This property should contain a description of an item purchased with this card.

This property is required for American Express purchase card transactions and not applicable to other card types.

The value may be up to 40 characters in length.

purchaseIdentifier
String

Default Value: ""

This property represents the data used by the merchant or customer to identify the purchase. This can be a SKU, code, or reference number.

This property is required for Visa, MasterCard, and American Express purchase card transactions.

The value may be up to 25 characters in length.

shipFromPostalCode
String

Default Value: ""

The postal or zip code the item(s) in this purchase are to be shipped from.

The value may be up to 9 characters.

taxAmount
String

Default Value: ""

This property contains the portion of the transaction amount that represents the tax.

This property is required when is set to 2 (tiProvided).

For Visa this is the amount of state or provincial tax included in the TransactionAmount. The tax amount must be within 0.1 % and 22% of the pre-tax transaction amount.

For MasterCard the total amount of sales tax on the total purchase must be between 0.1% and 30 % of the total pre-tax transaction amount; zeros indicate that the card acceptor is capable of transmitting the tax amount and the tax amount is zero.

This amount is to be presented with an implied decimal point. For example, US $10.00 must be represented as 1000, and $0.10 is likewise simply 10. The positioning of any implied decimal point is dictated by the CurrencyCode. The default currency code is for the United States.

The maximum number of digits allowed is 12 regardless of the position of the implied decimal point. This field may not contain a negative number.

taxIndicator
TTaxIndicators

Default Value: 0

This field indicates the taxable status of the transaction. Possible values are:

0 (tiUnSet - default) UnSet - no value is sent in the request
1 (tiNotProvided) No tax information provided
2 (tiProvided) Tax amount is provided
3 (tiExempt) Purchase item is tax exempt or non-taxable

Constructors

public init()

Config Settings (FDMSRcDetailRecord Module)

The class accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the class, access to these internal properties is provided through the Config method.

FDMSRcDetailRecord Config Settings

ACI:   Authorization Characteristics Indicator.

A mandatory code used for qualification in the Visa Custom Payment Service (CPS) program, MasterCard Preferred Rate program, or to identify an Incremental transaction. The following table provides a summary of the codes currently supported by Visa, MasterCard, and Discover.

ValueVisaMastercardDiscover
P X X Preferred Rate/Customer Status (Lodging or Auto Rental)
I X X X Incremental Authorization
Y (Default) X Transaction requests participation
R X Card-not-present, AVS not required (permitted for certain MCCs only)
CardInputMode:   The method used to input the card details.

This setting optionally specifies the method used to input the card number or track data. If not specified (default) the class will automatically determine the correct value based on CardEntryDataSource. This should only be set if there is a need to override the automatically determined value. Possible values are:

00 Unspecified
01 Manual (Key entered)
03 Barcode
04 OCR (Optical Character Reader)
05 Integrated Circuit Read (CVV data Reliable)
07 Contactless Integrated Circuit Read (Reliable)
10 Credential on File
79 EMV fallback to manual entry
80 EMV fallback to Magnetic Stripe entry
82 Contactless Mobile Commerce
90 Magnetic Stripe - Track Read
91 Contactless Magnetic Stripe Read
95 Integrated Circuit Read (CVV data unreliable)
CurrencyCode:   Currency Code for this transaction.

This field contains a three digit number assigned by the signing member or processor to identify the merchant's authorization currency. For US Dollars, use "840".

LocalTransactionDate:   The local date of the transaction.

This setting may be set to specify the local datetime of the transaction. By default the class will automatically calculate this value from the local system time. If set, this setting overrides the value calculated by the class. The format is "yyyyMMddHHmmss";

MOTOIndicator:   Indicates whether the transaction is Mail Order or Telephone Order.

This setting is required for Amex transactions when POSConditionCode is set to 08. Possible values are:

1 Mail Order
2 Telephone Order
POSConditionCode:   The POS condition code.

This setting may be set to specify a different POS condition code. The class will automatically set this to an appropriate value, however this may be set to provide a specific value. Possible values are:

00 Cardholder Present, Card Present
01 Cardholder Present, Unspecified
02 Cardholder Present, Unattended Device
03 Cardholder Present, Suspect Fraud
04 Cardholder Not Present - Recurring
05 Cardholder Present, Card Not Present
06 Cardholder Present, Identity Verified
08 Cardholder Not Present, Mail Order/Telephone Order
59 Cardholder Not Present, Ecommerce
71 Cardholder Present, Magnetic Stripe Could Not Be Read
TerminalCardCapability:   The terminal's card capture capability.

This setting specifies the terminal's ability to capture card information. Possible values are:

0 Terminal has no capture capability or no terminal used
1 Terminal has card capture capability
The default value is 1.

Note: If set to 0 track data must not be specified.

TerminalCategoryCode:   The Terminal Category Code.

This setting specifies the type of terminal being used for the transaction. Possible values are:

00 Unspecified
01 Electronic Payment Terminal (POS)
05 Automated Fuel Dispensing Machine (AFD)
06 Unattended Customer Terminal
07 Ecommerce Customer present
08 Mobile Terminal (Transponder for example: a wireless terminal)
09 Mobile POS (mPOS for example: a cellphone or tablet device on a cellular network)
12 Electronic Cash Register
13 Interactive Voice Response (IVR)
17 Ticket Machine
18 Call Center Operator
TerminalEntryCapability:   The terminal's entry mode capability.

This settings defines what entry modes are supported by the terminal. Possible values are:

00 Unspecified
01 Terminal not used
02 Magnetic stripe only
03 Magnetic stripe and key entry
04 Magnetic stripe, key entry, and chip
05 Bar code
06 Proximity terminal - contactless chip / RFID
07 OCR
08 Chip only
09 Chip and magnetic stripe
10 Manual entry only
11 Proximity terminal - contactless magnetic stripe
12 Hybrid - Magnetic stripe, Integrated Circuit Card Reader, and contactless capabilities
13 Terminal does not read card data
The default value is 00 (unspecified).

Note: A value of 04, 06, 08, 09, or 12 cannot be specified unless the client is certified and the device is enabled for EMV.

TerminalLocationIndicator:   The terminal's location.

This setting specifies the terminal's location. The class will automatically set this to the appropriate value depending on the IndustryType, however this may be set according to your needs to one of the following possible values:

0 On Premises; Used in a Card Present environment
1 Off Premises; Used in a Card not Present environment

Note: For MOTO and eCommerce transactions the value is set to 1 by default.

TerminalPinCapability:   The terminal's PIN capability.

This setting specifies the terminal's ability to accept PIN entry. Possible values are:

0 Unspecified
1 PIN entry capability
2 No PIN entry capability
3 PIN Pad Inoperative
4 PIN verified by terminal device
The default value is 1.
UTCTransactionDate:   The UTC date of the transaction.

This setting may be set to specify the UTC datetime of the transaction. By default the class will automatically calculate this value from the local system time. If set, this setting overrides the value calculated by the class. The format is "yyyyMMddHHmmss";

Base Config Settings

BuildInfo:   Information about the product's build.

When queried, this setting will return a string containing information about the product's build.

CodePage:   The system code page used for Unicode to Multibyte translations.

The default code page is Unicode UTF-8 (65001).

The following is a list of valid code page identifiers:

IdentifierName
037IBM EBCDIC - U.S./Canada
437OEM - United States
500IBM EBCDIC - International
708Arabic - ASMO 708
709Arabic - ASMO 449+, BCON V4
710Arabic - Transparent Arabic
720Arabic - Transparent ASMO
737OEM - Greek (formerly 437G)
775OEM - Baltic
850OEM - Multilingual Latin I
852OEM - Latin II
855OEM - Cyrillic (primarily Russian)
857OEM - Turkish
858OEM - Multilingual Latin I + Euro symbol
860OEM - Portuguese
861OEM - Icelandic
862OEM - Hebrew
863OEM - Canadian-French
864OEM - Arabic
865OEM - Nordic
866OEM - Russian
869OEM - Modern Greek
870IBM EBCDIC - Multilingual/ROECE (Latin-2)
874ANSI/OEM - Thai (same as 28605, ISO 8859-15)
875IBM EBCDIC - Modern Greek
932ANSI/OEM - Japanese, Shift-JIS
936ANSI/OEM - Simplified Chinese (PRC, Singapore)
949ANSI/OEM - Korean (Unified Hangul Code)
950ANSI/OEM - Traditional Chinese (Taiwan; Hong Kong SAR, PRC)
1026IBM EBCDIC - Turkish (Latin-5)
1047IBM EBCDIC - Latin 1/Open System
1140IBM EBCDIC - U.S./Canada (037 + Euro symbol)
1141IBM EBCDIC - Germany (20273 + Euro symbol)
1142IBM EBCDIC - Denmark/Norway (20277 + Euro symbol)
1143IBM EBCDIC - Finland/Sweden (20278 + Euro symbol)
1144IBM EBCDIC - Italy (20280 + Euro symbol)
1145IBM EBCDIC - Latin America/Spain (20284 + Euro symbol)
1146IBM EBCDIC - United Kingdom (20285 + Euro symbol)
1147IBM EBCDIC - France (20297 + Euro symbol)
1148IBM EBCDIC - International (500 + Euro symbol)
1149IBM EBCDIC - Icelandic (20871 + Euro symbol)
1200Unicode UCS-2 Little-Endian (BMP of ISO 10646)
1201Unicode UCS-2 Big-Endian
1250ANSI - Central European
1251ANSI - Cyrillic
1252ANSI - Latin I
1253ANSI - Greek
1254ANSI - Turkish
1255ANSI - Hebrew
1256ANSI - Arabic
1257ANSI - Baltic
1258ANSI/OEM - Vietnamese
1361Korean (Johab)
10000MAC - Roman
10001MAC - Japanese
10002MAC - Traditional Chinese (Big5)
10003MAC - Korean
10004MAC - Arabic
10005MAC - Hebrew
10006MAC - Greek I
10007MAC - Cyrillic
10008MAC - Simplified Chinese (GB 2312)
10010MAC - Romania
10017MAC - Ukraine
10021MAC - Thai
10029MAC - Latin II
10079MAC - Icelandic
10081MAC - Turkish
10082MAC - Croatia
12000Unicode UCS-4 Little-Endian
12001Unicode UCS-4 Big-Endian
20000CNS - Taiwan
20001TCA - Taiwan
20002Eten - Taiwan
20003IBM5550 - Taiwan
20004TeleText - Taiwan
20005Wang - Taiwan
20105IA5 IRV International Alphabet No. 5 (7-bit)
20106IA5 German (7-bit)
20107IA5 Swedish (7-bit)
20108IA5 Norwegian (7-bit)
20127US-ASCII (7-bit)
20261T.61
20269ISO 6937 Non-Spacing Accent
20273IBM EBCDIC - Germany
20277IBM EBCDIC - Denmark/Norway
20278IBM EBCDIC - Finland/Sweden
20280IBM EBCDIC - Italy
20284IBM EBCDIC - Latin America/Spain
20285IBM EBCDIC - United Kingdom
20290IBM EBCDIC - Japanese Katakana Extended
20297IBM EBCDIC - France
20420IBM EBCDIC - Arabic
20423IBM EBCDIC - Greek
20424IBM EBCDIC - Hebrew
20833IBM EBCDIC - Korean Extended
20838IBM EBCDIC - Thai
20866Russian - KOI8-R
20871IBM EBCDIC - Icelandic
20880IBM EBCDIC - Cyrillic (Russian)
20905IBM EBCDIC - Turkish
20924IBM EBCDIC - Latin-1/Open System (1047 + Euro symbol)
20932JIS X 0208-1990 & 0121-1990
20936Simplified Chinese (GB2312)
21025IBM EBCDIC - Cyrillic (Serbian, Bulgarian)
21027Extended Alpha Lowercase
21866Ukrainian (KOI8-U)
28591ISO 8859-1 Latin I
28592ISO 8859-2 Central Europe
28593ISO 8859-3 Latin 3
28594ISO 8859-4 Baltic
28595ISO 8859-5 Cyrillic
28596ISO 8859-6 Arabic
28597ISO 8859-7 Greek
28598ISO 8859-8 Hebrew
28599ISO 8859-9 Latin 5
28605ISO 8859-15 Latin 9
29001Europa 3
38598ISO 8859-8 Hebrew
50220ISO 2022 Japanese with no halfwidth Katakana
50221ISO 2022 Japanese with halfwidth Katakana
50222ISO 2022 Japanese JIS X 0201-1989
50225ISO 2022 Korean
50227ISO 2022 Simplified Chinese
50229ISO 2022 Traditional Chinese
50930Japanese (Katakana) Extended
50931US/Canada and Japanese
50933Korean Extended and Korean
50935Simplified Chinese Extended and Simplified Chinese
50936Simplified Chinese
50937US/Canada and Traditional Chinese
50939Japanese (Latin) Extended and Japanese
51932EUC - Japanese
51936EUC - Simplified Chinese
51949EUC - Korean
51950EUC - Traditional Chinese
52936HZ-GB2312 Simplified Chinese
54936Windows XP: GB18030 Simplified Chinese (4 Byte)
57002ISCII Devanagari
57003ISCII Bengali
57004ISCII Tamil
57005ISCII Telugu
57006ISCII Assamese
57007ISCII Oriya
57008ISCII Kannada
57009ISCII Malayalam
57010ISCII Gujarati
57011ISCII Punjabi
65000Unicode UTF-7
65001Unicode UTF-8
The following is a list of valid code page identifiers for Mac OS only:
IdentifierName
1ASCII
2NEXTSTEP
3JapaneseEUC
4UTF8
5ISOLatin1
6Symbol
7NonLossyASCII
8ShiftJIS
9ISOLatin2
10Unicode
11WindowsCP1251
12WindowsCP1252
13WindowsCP1253
14WindowsCP1254
15WindowsCP1250
21ISO2022JP
30MacOSRoman
10UTF16String
0x90000100UTF16BigEndian
0x94000100UTF16LittleEndian
0x8c000100UTF32String
0x98000100UTF32BigEndian
0x9c000100UTF32LittleEndian
65536Proprietary

LicenseInfo:   Information about the current license.

When queried, this setting will return a string containing information about the license this instance of a class is using. It will return the following information:

  • Product: The product the license is for.
  • Product Key: The key the license was generated from.
  • License Source: Where the license was found (e.g., RuntimeLicense, License File).
  • License Type: The type of license installed (e.g., Royalty Free, Single Server).
  • Last Valid Build: The last valid build number for which the license will work.
MaskSensitive:   Whether sensitive data is masked in log messages.

In certain circumstances it may be beneficial to mask sensitive data, like passwords, in log messages. Set this to to mask sensitive data. The default is .

This setting only works on these classes: AS3Receiver, AS3Sender, Atom, Client(3DS), FTP, FTPServer, IMAP, OFTPClient, SSHClient, SCP, Server(3DS), Sexec, SFTP, SFTPServer, SSHServer, TCPClient, TCPServer.

UseInternalSecurityAPI:   Whether or not to use the system security libraries or an internal implementation.

When set to , the class will use the system security libraries by default to perform cryptographic functions where applicable.

Setting this configuration setting to tells the class to use the internal implementation instead of using the system security libraries.

This setting is set to by default on all platforms.

Trappable Errors (FDMSRcDetailRecord Module)

FDMSRcDetailRecord Errors

501   Data field invalid length.
502   Data field invalid format.
503   Data field out of range.
592   Invalid or unparseable aggregate.
593   Verification of post data failed: Invalid mix of properties for the current method call.
605   Invalid CardType.