FDMSDetailRecord Class

Properties   Methods   Events   Config Settings   Errors  

The FDMSDetailRecord class is a tool used to create off-line Credit or Force transactions to be settled by the FDMSSETTLE class. The FDMSDetailRecord class may also be used to modify the XML aggregates returned by the FDMSRETAIL or FDMSECOMMERCE class's GetDetailAggregate method.

Syntax

FDMSDetailRecord

Remarks

Credit and Force transactions are off-line transactions. This means that there is no authorization of funds using the FDMSECommerce, FDMSRetail classs. Instead, you must manually add these transactions to the settlement batch. The FDMSDetailRecord class can be used to create these transactions, which can then be added to the FDMSSettle class's DetailRecord array property.

To create a Credit, first set the TransactionType to fttCredit, and then set the IndustryType. CardEntryDataSource, and DirectMarketingType based on whether you have a card reader, and how your customer is authenticated. The following example shows how this should be set for Direct Marketing:

FDMSDetailRecord.TransactionType = fttCredit FDMSDetailRecord.IndustryType = fitDirectMarketing FDMSDetailRecord.CardEntryDataSource = edsManualEntryNoCardReader FDMSDetailRecord.DirectMarketingType = dmECommerce

Next, set the CardNumber, CardExpMonth, CardExpYear, SettlementAmount, and the current TransactionDate and TransactionTime. Since this example is a Direct Marketing transaction, we're also adding the PurchaseIdentifier. Note that since this is an off-line transaction, the AuthorizedAmount MUST be either zero or empty string.

FDMSDetailRecord.CardNumber = "4444333322221111" FDMSDetailRecord.CardExpMonth = 3 FDMSDetailRecord.CardExpYear = 2019 FDMSDetailRecord.AuthorizedAmount = "0" FDMSDetailRecord.SettlementAmount = "5000" '$50.00 FDMSDetailRecord.TransTime = "123456" ' Current time (12:34:56) FDMSDetailRecord.TransDate = "040506" ' Current date (MMDDYY) FDMSDetailRecord.PurchaseIdentifier = "123456"

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

FDMSSettle.DetailRecordCount = 1 FDMSSettle.DetailRecordAggregate(0) = FDMSDetailRecord.GetDetailAggregate()

Forced transactions are similar to credits, 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 ResponseApprovalCode property. The following example shows a Force transaction in a Retail environment.

FDMSDetailRecord.TransactionType = fttForce FDMSDetailRecord.IndustryType = fitRetail FDMSDetailRecord.CardEntryDataSource = edsTrack1 FDMSDetailRecord.CardNumber = "4444333322221111" FDMSDetailRecord.CardExpMonth = 3 FDMSDetailRecord.CardExpYear = 2019 FDMSDetailRecord.AuthorizedAmount = "0" FDMSDetailRecord.SettlementAmount = "500000" '$5000.00 FDMSDetailRecord.TransTime = "123456" ' Current time (12:34:56) FDMSDetailRecord.TransDate = "040506" ' Current date (MMDDYY) FDMSDetailRecord.ResponseApprovalCode = "123456" FDMSSettle.DetailRecordCount = 1 FDMSSettle.DetailRecord(0) = FDMSDetailRecord.GetDetailAggregate()

In addition to creating Credit and Force transactions, the FDMSDetailRecord class can be used to adjust the Detail Records returned from the FDMSECommerce and FDMSRetail classs. The most common reasons to modify these detail records are to add a Gratuity (tip) to a charge (fitResturant IndustryType), or to add a PurchaseIdentifier or Installment payment info (fitDirectMarketing IndustryType) to the detail record.

For example, to add a gratuity to a charge:

FDMSDetailRecord.ParseAggregate(FDMSRetail.GetDetailAggregate()) FDMSDetailRecord.Gratuity = "500" FDMSDetailRecord.TransactionAmount = FDMSDetailRecord.TransactionAmount + FDMSDetailRecord.Gratuity FDMSSettle.DetailAggregate(0) = FDMSDetailRecord.GetDetailAggregate()

To settle a transaction authorized with the dmtInstallment TransactionType, you must use the FDMSDetailRecord 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:

FDMSECommerce.TransactionType = dmtInstallment FDMSECommerce.TransactionAmount = "1995" FDMSECommerce.Authorize() FDMSDetailRecord.ParseAggregate FDMSECommerce.GetDetailAggregate() FDMSDetailRecord.InstallmentCount = 3 FDMSDetailRecord.InstallmentNumber = 1 FDMSSettle.DetailRecordAggregate(5) = FDMSDetailRecord.GetDetailAggregate()

Property List

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

Method List

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

Event List

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

Config Settings

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

AuthorizedAmount Property (FDMSDetailRecord Class)

Original amount authorized before any reversals.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetAuthorizedAmount();
int SetAuthorizedAmount(const char* lpszAuthorizedAmount);

Unicode (Windows)
LPWSTR GetAuthorizedAmount();
INT SetAuthorizedAmount(LPCWSTR lpszAuthorizedAmount);

char* dpaymentssdk_fdmsdetailrecord_getauthorizedamount(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setauthorizedamount(void* lpObj, const char* lpszAuthorizedAmount);

QString GetAuthorizedAmount();
int SetAuthorizedAmount(QString qsAuthorizedAmount);

Default Value

"0"

Remarks

This field contains the transaction amount from the original authorization request message. If any additional authorizations have been made, or the SettlementAmount is different than the originally authorized amount (due to items out of stock or adding a Gratuity) this property should still reflect the original unchanged amount from the initial authorization request.

Data Type

String

CardEntryDataSource Property (FDMSDetailRecord Class)

This property identifies the source of the customer data.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCardEntryDataSource();
int SetCardEntryDataSource(int iCardEntryDataSource);

Unicode (Windows)
INT GetCardEntryDataSource();
INT SetCardEntryDataSource(INT iCardEntryDataSource);

EDS_TRACK_1(0), 
EDS_TRACK_2(1), 
EDS_MANUAL_ENTRY_TRACK_1CAPABLE(2), 
EDS_MANUAL_ENTRY_TRACK_2CAPABLE(3), 
EDS_MANUAL_ENTRY_NO_CARD_READER(4), 
EDS_TRACK_1CONTACTLESS(5), 
EDS_TRACK_2CONTACTLESS(6), 
EDS_MANUAL_ENTRY_CONTACTLESS_CAPABLE(7), 
EDS_IVR(8), 
EDS_KIOSK(9)

int dpaymentssdk_fdmsdetailrecord_getcardentrydatasource(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setcardentrydatasource(void* lpObj, int iCardEntryDataSource);

int GetCardEntryDataSource();
int SetCardEntryDataSource(int iCardEntryDataSource);

Default Value

0

Remarks

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

Data Type

Integer

CardExpMonth Property (FDMSDetailRecord Class)

Expiration month of the credit card specified in CardNumber .

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCardExpMonth();
int SetCardExpMonth(int iCardExpMonth);

Unicode (Windows)
INT GetCardExpMonth();
INT SetCardExpMonth(INT iCardExpMonth);

int dpaymentssdk_fdmsdetailrecord_getcardexpmonth(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setcardexpmonth(void* lpObj, int iCardExpMonth);

int GetCardExpMonth();
int SetCardExpMonth(int iCardExpMonth);

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.

Data Type

Integer

CardExpYear Property (FDMSDetailRecord Class)

Expiration year of the credit card specified in CardNumber .

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCardExpYear();
int SetCardExpYear(int iCardExpYear);

Unicode (Windows)
INT GetCardExpYear();
INT SetCardExpYear(INT iCardExpYear);

int dpaymentssdk_fdmsdetailrecord_getcardexpyear(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setcardexpyear(void* lpObj, int iCardExpYear);

int GetCardExpYear();
int SetCardExpYear(int iCardExpYear);

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.

Data Type

Integer

CardLevelResults Property (FDMSDetailRecord Class)

Card Level result code returned only for Visa transactions.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCardLevelResults();
int SetCardLevelResults(const char* lpszCardLevelResults);

Unicode (Windows)
LPWSTR GetCardLevelResults();
INT SetCardLevelResults(LPCWSTR lpszCardLevelResults);

char* dpaymentssdk_fdmsdetailrecord_getcardlevelresults(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setcardlevelresults(void* lpObj, const char* lpszCardLevelResults);

QString GetCardLevelResults();
int SetCardLevelResults(QString qsCardLevelResults);

Default Value

""

Remarks

This property contains a two-character code created by Visa during the authorization process. If the transaction being settled was authorized online, this field must contain the value returned in the authorization response. If the transaction is a credit or was otherwise processed offline, this field should be defaulted to "" (empty string) or two spaces.

Data Type

String

CardNumber Property (FDMSDetailRecord Class)

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

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCardNumber();
int SetCardNumber(const char* lpszCardNumber);

Unicode (Windows)
LPWSTR GetCardNumber();
INT SetCardNumber(LPCWSTR lpszCardNumber);

char* dpaymentssdk_fdmsdetailrecord_getcardnumber(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setcardnumber(void* lpObj, const char* lpszCardNumber);

QString GetCardNumber();
int SetCardNumber(QString qsCardNumber);

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.

Data Type

String

CashBack Property (FDMSDetailRecord Class)

Amount of cash that was returned to the customer.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCashBack();
int SetCashBack(const char* lpszCashBack);

Unicode (Windows)
LPWSTR GetCashBack();
INT SetCashBack(LPCWSTR lpszCashBack);

char* dpaymentssdk_fdmsdetailrecord_getcashback(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setcashback(void* lpObj, const char* lpszCashBack);

QString GetCashBack();
int SetCashBack(QString qsCashBack);

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.

Data Type

String

DebitReceipt Property (FDMSDetailRecord Class)

Merchant-generated number that identifies the debit or EBT transaction.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetDebitReceipt();
int SetDebitReceipt(const char* lpszDebitReceipt);

Unicode (Windows)
LPWSTR GetDebitReceipt();
INT SetDebitReceipt(LPCWSTR lpszDebitReceipt);

char* dpaymentssdk_fdmsdetailrecord_getdebitreceipt(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setdebitreceipt(void* lpObj, const char* lpszDebitReceipt);

QString GetDebitReceipt();
int SetDebitReceipt(QString qsDebitReceipt);

Default Value

""

Remarks

A merchant must generate a ReceiptNumber for debit and EBT transactions made with the FDMSDebit and FDMSBenefit classs. This receipt number must be passed to the settlement unmodified in this DebitReceipt property.

Data Type

String

DirectMarketingType Property (FDMSDetailRecord Class)

Specifies the type of transaction to process.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetDirectMarketingType();
int SetDirectMarketingType(int iDirectMarketingType);

Unicode (Windows)
INT GetDirectMarketingType();
INT SetDirectMarketingType(INT iDirectMarketingType);

DM_ECOMMERCE(0), 
DM_MOTO(1), 
DM_RECURRING(2), 
DM_INSTALLMENT(3)

int dpaymentssdk_fdmsdetailrecord_getdirectmarketingtype(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setdirectmarketingtype(void* lpObj, int iDirectMarketingType);

int GetDirectMarketingType();
int SetDirectMarketingType(int iDirectMarketingType);

Default Value

0

Remarks

The following types of transactions are supported by this class:

The value of this property will be ignored when the IndustryType is anything other than fitDirectMarketing.

Data Type

Integer

ECI Property (FDMSDetailRecord Class)

Electronic Commerce Indicator from the original authorization request.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetECI();
int SetECI(const char* lpszECI);

Unicode (Windows)
LPWSTR GetECI();
INT SetECI(LPCWSTR lpszECI);

char* dpaymentssdk_fdmsdetailrecord_geteci(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_seteci(void* lpObj, const char* lpszECI);

QString GetECI();
int SetECI(QString qsECI);

Default Value

""

Remarks

This field should be identical to the ECI property from the original authorization request. This property is used only for eCommerce and Direct Marketing (card not present) transactions, and is ignored for all Card Present (Retail) transactions.

Data Type

String

Gratuity Property (FDMSDetailRecord Class)

Gratuity amount for settling restaurant industry transactions.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetGratuity();
int SetGratuity(const char* lpszGratuity);

Unicode (Windows)
LPWSTR GetGratuity();
INT SetGratuity(LPCWSTR lpszGratuity);

char* dpaymentssdk_fdmsdetailrecord_getgratuity(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setgratuity(void* lpObj, const char* lpszGratuity);

QString GetGratuity();
int SetGratuity(QString qsGratuity);

Default Value

""

Remarks

This 5 character numeric field contains the gratuity (tip) amount of the transaction being settled. This amount is only sent when the CFDMSSettle class's IndustryType is set to "Restaurant".

Data Type

String

IndustryType Property (FDMSDetailRecord Class)

Code which indicates the industry the merchant is engaged in.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetIndustryType();
int SetIndustryType(int iIndustryType);

Unicode (Windows)
INT GetIndustryType();
INT SetIndustryType(INT iIndustryType);

FIT_UNKNOWN(0), 
FIT_RETAIL(1), 
FIT_RESTAURANT(2), 
FIT_GROCERY_STORE(3), 
FIT_DIRECT_MARKETING(4), 
FIT_HOTEL(5)

int dpaymentssdk_fdmsdetailrecord_getindustrytype(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setindustrytype(void* lpObj, int iIndustryType);

int GetIndustryType();
int SetIndustryType(int iIndustryType);

Default Value

1

Remarks

This property is used to identify the industry type of the merchant submitting the authorization request. The following table lists the industry types supported by this class.

Data Type

Integer

InstallmentCount Property (FDMSDetailRecord Class)

Total number of installments (installment transactions only).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetInstallmentCount();
int SetInstallmentCount(int iInstallmentCount);

Unicode (Windows)
INT GetInstallmentCount();
INT SetInstallmentCount(INT iInstallmentCount);

int dpaymentssdk_fdmsdetailrecord_getinstallmentcount(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setinstallmentcount(void* lpObj, int iInstallmentCount);

int GetInstallmentCount();
int SetInstallmentCount(int iInstallmentCount);

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 FDMSECommerce class.

To settle a transaction authorized with the dmtInstallment TransactionType, you must use the FDMSDetailRecord 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:

FDMSECommerce.TransactionType = dmtInstallment FDMSECommerce.TransactionAmount = "1995" FDMSECommerce.Authorize() FDMSDetailRecord.ParseAggregate FDMSECommerce.GetDetailAggregate() FDMSDetailRecord.InstallmentCount = 3 FDMSDetailRecord.InstallmentNumber = 1 FDMSSettle.DetailRecordAggregate(5) = FDMSDetailRecord.GetDetailAggregate()

Data Type

Integer

InstallmentNumber Property (FDMSDetailRecord Class)

Current installment number (installment transactions only).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetInstallmentNumber();
int SetInstallmentNumber(int iInstallmentNumber);

Unicode (Windows)
INT GetInstallmentNumber();
INT SetInstallmentNumber(INT iInstallmentNumber);

int dpaymentssdk_fdmsdetailrecord_getinstallmentnumber(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setinstallmentnumber(void* lpObj, int iInstallmentNumber);

int GetInstallmentNumber();
int SetInstallmentNumber(int iInstallmentNumber);

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 FDMSECommerce class.

To settle a transaction authorized with the dmtInstallment TransactionType, you must use the FDMSDetailRecord 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:

FDMSECommerce.TransactionType = dmtInstallment FDMSECommerce.TransactionAmount = "1995" FDMSECommerce.Authorize() FDMSDetailRecord.ParseAggregate FDMSECommerce.GetDetailAggregate() FDMSDetailRecord.InstallmentCount = 3 FDMSDetailRecord.InstallmentNumber = 1 FDMSSettle.DetailRecordAggregate(5) = FDMSDetailRecord.GetDetailAggregate()

Data Type

Integer

PurchaseIdentifier Property (FDMSDetailRecord Class)

Optional purchase order number assigned by the merchant.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetPurchaseIdentifier();
int SetPurchaseIdentifier(const char* lpszPurchaseIdentifier);

Unicode (Windows)
LPWSTR GetPurchaseIdentifier();
INT SetPurchaseIdentifier(LPCWSTR lpszPurchaseIdentifier);

char* dpaymentssdk_fdmsdetailrecord_getpurchaseidentifier(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setpurchaseidentifier(void* lpObj, const char* lpszPurchaseIdentifier);

QString GetPurchaseIdentifier();
int SetPurchaseIdentifier(QString qsPurchaseIdentifier);

Default Value

""

Remarks

In this field the merchant may assign an optional Purchase Identifier. This field must contain digits, and has a maximum length of 25 characters. For American Express transactions, only use the first 9 spaces.

Data Type

String

ResponseApprovalCode Property (FDMSDetailRecord Class)

Response Approval Code from the original authorization response.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResponseApprovalCode();
int SetResponseApprovalCode(const char* lpszResponseApprovalCode);

Unicode (Windows)
LPWSTR GetResponseApprovalCode();
INT SetResponseApprovalCode(LPCWSTR lpszResponseApprovalCode);

char* dpaymentssdk_fdmsdetailrecord_getresponseapprovalcode(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setresponseapprovalcode(void* lpObj, const char* lpszResponseApprovalCode);

QString GetResponseApprovalCode();
int SetResponseApprovalCode(QString qsResponseApprovalCode);

Default Value

""

Remarks

This field contains the authorization code obtained from the original authorization response. If the transaction is a credit or other non-approved transaction type, this property must be empty.

Data Type

String

ResponseAVSResult Property (FDMSDetailRecord Class)

Address Verification Code from the original authorization response.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResponseAVSResult();
int SetResponseAVSResult(const char* lpszResponseAVSResult);

Unicode (Windows)
LPWSTR GetResponseAVSResult();
INT SetResponseAVSResult(LPCWSTR lpszResponseAVSResult);

char* dpaymentssdk_fdmsdetailrecord_getresponseavsresult(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setresponseavsresult(void* lpObj, const char* lpszResponseAVSResult);

QString GetResponseAVSResult();
int SetResponseAVSResult(QString qsResponseAVSResult);

Default Value

"0"

Remarks

This field contains a one character Address Verification (result) Code. This field contains the value returned in the original authorization response message. If the transaction is a credit or was otherwise processed off-line, this field should be defaulted to "0".

Data Type

String

ResponseReturnedACI Property (FDMSDetailRecord Class)

Authorization Characteristics Indicator from the original authorization response.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResponseReturnedACI();
int SetResponseReturnedACI(const char* lpszResponseReturnedACI);

Unicode (Windows)
LPWSTR GetResponseReturnedACI();
INT SetResponseReturnedACI(LPCWSTR lpszResponseReturnedACI);

char* dpaymentssdk_fdmsdetailrecord_getresponsereturnedaci(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setresponsereturnedaci(void* lpObj, const char* lpszResponseReturnedACI);

QString GetResponseReturnedACI();
int SetResponseReturnedACI(QString qsResponseReturnedACI);

Default Value

""

Remarks

This field contains a one character returned Authorization Characteristics Indicator. This indicator provides information on conditions or characteristics of the authorization code. If the transaction being settled was authorized on-line, this field must contain the value returned in that authorization response. If the transaction is a credit or was otherwise processed off-line, this field should be defaulted to SPACE.

Data Type

String

ServerId Property (FDMSDetailRecord Class)

Specifies the employee that served the customer. Used for restaurants only.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetServerId();
int SetServerId(const char* lpszServerId);

Unicode (Windows)
LPWSTR GetServerId();
INT SetServerId(LPCWSTR lpszServerId);

char* dpaymentssdk_fdmsdetailrecord_getserverid(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setserverid(void* lpObj, const char* lpszServerId);

QString GetServerId();
int SetServerId(QString qsServerId);

Default Value

""

Remarks

This property pertains to restaurant transactions, and should be set with a merchant-assigned server Id code. This code identifies the employee which served the customer at the restaurant. This property is required for restaurant transactions, and is ignored for all other industry types. The maximum length for this property is 3.

Data Type

String

SettlementAmount Property (FDMSDetailRecord Class)

The amount that the customer will be charged.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetSettlementAmount();
int SetSettlementAmount(const char* lpszSettlementAmount);

Unicode (Windows)
LPWSTR GetSettlementAmount();
INT SetSettlementAmount(LPCWSTR lpszSettlementAmount);

char* dpaymentssdk_fdmsdetailrecord_getsettlementamount(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setsettlementamount(void* lpObj, const char* lpszSettlementAmount);

QString GetSettlementAmount();
int SetSettlementAmount(QString qsSettlementAmount);

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). If using the Restaurant IndustryType, you may also increase the SettlementAmount by adding any Gratuity (if present).

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.

Data Type

String

TicketNumber Property (FDMSDetailRecord Class)

Ticket (receipt) number for this transaction.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetTicketNumber();
int SetTicketNumber(const char* lpszTicketNumber);

Unicode (Windows)
LPWSTR GetTicketNumber();
INT SetTicketNumber(LPCWSTR lpszTicketNumber);

char* dpaymentssdk_fdmsdetailrecord_getticketnumber(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setticketnumber(void* lpObj, const char* lpszTicketNumber);

QString GetTicketNumber();
int SetTicketNumber(QString qsTicketNumber);

Default Value

""

Remarks

This property contains the Ticket number or Receipt of Charge (ROC) for this transaction. This may be optionally sent for any IndustryType, but it is required for Restaurant transactions that include a Gratuity.

The maximum length of this property is 10 digits.

For example, to add a gratuity to a charge:

FDMSDetailRecord.ParseAggregate(FDMSRetail.GetDetailAggregate()) FDMSDetailRecord.Gratuity = "500" FDMSDetailRecord.TransactionAmount = FDMSDetailRecord.TransactionAmount + FDMSDetailRecord.Gratuity FDMSSettle.DetailAggregate(0) = FDMSDetailRecord.GetDetailAggregate()

Data Type

String

TransactionDate Property (FDMSDetailRecord Class)

Local Transaction Date (in MMDDYY format) from the original authorization response.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetTransactionDate();
int SetTransactionDate(const char* lpszTransactionDate);

Unicode (Windows)
LPWSTR GetTransactionDate();
INT SetTransactionDate(LPCWSTR lpszTransactionDate);

char* dpaymentssdk_fdmsdetailrecord_gettransactiondate(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_settransactiondate(void* lpObj, const char* lpszTransactionDate);

QString GetTransactionDate();
int SetTransactionDate(QString qsTransactionDate);

Default Value

"010100"

Remarks

This six digit field contains a local transaction date associated with the transaction being settled. If the transaction was authorized on-line, this field must contain the value returned in the original authorization response message. If the transaction was processed off-line, this field must contain a Point of Sale (POS) device generated date. This field must appear in MMDDYY format.

Data Type

String

TransactionId Property (FDMSDetailRecord Class)

Transaction Identifier from the original authorization response.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetTransactionId();
int SetTransactionId(const char* lpszTransactionId);

Unicode (Windows)
LPWSTR GetTransactionId();
INT SetTransactionId(LPCWSTR lpszTransactionId);

char* dpaymentssdk_fdmsdetailrecord_gettransactionid(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_settransactionid(void* lpObj, const char* lpszTransactionId);

QString GetTransactionId();
int SetTransactionId(QString qsTransactionId);

Default Value

"000000000000000"

Remarks

This 15-character field contains a Transaction Identifier associated with the transaction being settled. If the transaction was authorized on-line, this field must contain the value (if returned) from the original authorization response message. If a value was not returned in the authorization response or the transaction was processed off-line, this field must be defaulted to zeros.

Data Type

String

TransactionTime Property (FDMSDetailRecord Class)

Local transaction time from the original authorization response.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetTransactionTime();
int SetTransactionTime(const char* lpszTransactionTime);

Unicode (Windows)
LPWSTR GetTransactionTime();
INT SetTransactionTime(LPCWSTR lpszTransactionTime);

char* dpaymentssdk_fdmsdetailrecord_gettransactiontime(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_settransactiontime(void* lpObj, const char* lpszTransactionTime);

QString GetTransactionTime();
int SetTransactionTime(QString qsTransactionTime);

Default Value

"000000"

Remarks

This six digit field contains a local transaction time associated with the transaction being settled. If the transaction was authorized on-line, this field must contain the value generated by the FDMSECommerce or FDMSRetail class at the time of the sale. If the transaction was processed off-line, this field must contain a Point of Sale (POS) device generated time. This field must appear in HHMMSS format.

NOTE: This property is only applicable when settling a debit or EBT transaction, or a credit card transaction that includes Level 2 data, and may be ignored if such data is not being sent.

Data Type

String

TransactionType Property (FDMSDetailRecord Class)

Indicates transaction type for this detail record.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetTransactionType();
int SetTransactionType(int iTransactionType);

Unicode (Windows)
INT GetTransactionType();
INT SetTransactionType(INT iTransactionType);

FTT_SALE(0), 
FTT_FORCE(1), 
FTT_VOID(2), 
FTT_CREDIT(3), 
FTT_VOID_CREDIT(4), 
FTT_DEBIT_SALE(5), 
FTT_DEBIT_REFUND(6), 
FTT_FOOD_STAMP_SALE(8), 
FTT_FOOD_STAMP_REFUND(9), 
FTT_CASH_BENEFIT_SALE(10), 
FTT_CASH_BENEFIT_WITHDRAWAL(11)

int dpaymentssdk_fdmsdetailrecord_gettransactiontype(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_settransactiontype(void* lpObj, int iTransactionType);

int GetTransactionType();
int SetTransactionType(int iTransactionType);

Default Value

0

Remarks

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

Note: The fttSale and fttVoid TransactionTypes require a previous authorization to work on. fttForce and fttCredit, however, are offline transactions. This means there is no original authorization to work from. The transaction is created solely with this class's properties and is settled without ever having been authorized. Just fill out the properties and sent the FDMSSettle class's DetailAggregate array property with the results from the FDMSDetailRecord's GetDetailAggregate method. The remaining debit, food stamp, and cash benefit transactions may not be edited, voided, or otherwise modified before settlement. The detail aggregates should be set directly to the FDMSSettle class's DetailAggregate array property, and should never be manipulated with the FDMSDetailRecord class.

Data Type

Integer

ValidationCode Property (FDMSDetailRecord Class)

Validation Code from the original authorization response.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetValidationCode();
int SetValidationCode(const char* lpszValidationCode);

Unicode (Windows)
LPWSTR GetValidationCode();
INT SetValidationCode(LPCWSTR lpszValidationCode);

char* dpaymentssdk_fdmsdetailrecord_getvalidationcode(void* lpObj);
int dpaymentssdk_fdmsdetailrecord_setvalidationcode(void* lpObj, const char* lpszValidationCode);

QString GetValidationCode();
int SetValidationCode(QString qsValidationCode);

Default Value

""

Remarks

This field contains a four character Transaction Identifier associated with the transaction being settled. If the transaction was authorized on-line, this field must contain the value (if returned) from the original authorization response message. If a value was not returned in the authorization response or the transaction was processed off-line, this field must be empty.

Data Type

String

Config Method (FDMSDetailRecord Class)

Sets or retrieves a configuration setting.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* Config(const char* lpszConfigurationString);

Unicode (Windows)
LPWSTR Config(LPCWSTR lpszConfigurationString);

char* dpaymentssdk_fdmsdetailrecord_config(void* lpObj, const char* lpszConfigurationString);

QString Config(const QString& qsConfigurationString);

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.

Error Handling (C++)

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.

GetDetailAggregate Method (FDMSDetailRecord Class)

Returns an aggregate containing details of this transaction, which is then used for settlement.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetDetailAggregate();

Unicode (Windows)
LPWSTR GetDetailAggregate();

char* dpaymentssdk_fdmsdetailrecord_getdetailaggregate(void* lpObj);

QString GetDetailAggregate();

Remarks

This method returns an aggregate containing all of the required data to send a transaction to settlement. This aggregate must be passed to the FDMSSettle 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 FDMSDetailRecord class to do so.

Note: This method may only be called after a successful authorization. If the authorization was not successful (and the ResponseCaptureFlag is false) the method fails with an error.

An example of how this method is used is shown below:

FDMSRetail.AuthorizeTrack1() If (FDMSRetail.ResponseCaptureFlag = True) Then FDMSSettle.DetailRecordCount = FDMSSettle.DetailRecordCount + 1 FDMSSettle.DetailRecordsAggregate[FDMSSettle.DetailRecordCount - 1] = FDMSRetail.GetDetailAggregate() End If

Error Handling (C++)

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.

ParseAggregate Method (FDMSDetailRecord Class)

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

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int ParseAggregate(const char* lpszAggregate);

Unicode (Windows)
INT ParseAggregate(LPCWSTR lpszAggregate);

int dpaymentssdk_fdmsdetailrecord_parseaggregate(void* lpObj, const char* lpszAggregate);

int ParseAggregate(const QString& qsAggregate);

Remarks

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

For example, to add a gratuity to a charge:

FDMSDetailRecord.ParseAggregate(FDMSRetail.GetDetailAggregate()) FDMSDetailRecord.Gratuity = "500" FDMSDetailRecord.TransactionAmount = FDMSDetailRecord.TransactionAmount + FDMSDetailRecord.Gratuity FDMSSettle.DetailAggregate(0) = FDMSDetailRecord.GetDetailAggregate()

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

Reset Method (FDMSDetailRecord Class)

Clears all properties to their default values.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int Reset();

Unicode (Windows)
INT Reset();

int dpaymentssdk_fdmsdetailrecord_reset(void* lpObj);

int Reset();

Remarks

This method clears all properties to their default values.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

Error Event (FDMSDetailRecord Class)

Fired when information is available about errors during data delivery.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireError(FDMSDetailRecordErrorEventParams *e);

typedef struct {
  int ErrorCode;
  const char *Description;
  int reserved;
} FDMSDetailRecordErrorEventParams;


Unicode (Windows)
virtual INT FireError(FDMSDetailRecordErrorEventParams *e);

typedef struct {
  INT ErrorCode;
  LPCWSTR Description;
  INT reserved;
} FDMSDetailRecordErrorEventParams;

#define EID_FDMSDETAILRECORD_ERROR 1

virtual INT DPAYMENTSSDK_CALL FireError(INT &iErrorCode, LPSTR &lpszDescription);

class FDMSDetailRecordErrorEventParams {
public:
  int ErrorCode();

  const QString &Description();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void Error(FDMSDetailRecordErrorEventParams *e);

// Or, subclass FDMSDetailRecord and override this emitter function.
virtual int FireError(FDMSDetailRecordErrorEventParams *e) {...}

Remarks

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

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.

Config Settings (FDMSDetailRecord Class)

FDMSDetailRecord Config Settings

Base Config Settings

Trappable Errors (FDMSDetailRecord Class)

Error Handling (C++)

Call the GetLastErrorCode() method to obtain the last called method's result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. Known error codes are listed below. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.

FDMSDetailRecord Errors