PTechDetailRecord Module

Properties   Methods   Events   Config Settings   Errors  

The PTechDetailRecord module is a tool used to create off-line Credit or Force transactions to be settled by the PTECHMANUALSETTLE module. The PTDetailRecord module may also be used to modify the XML aggregates returned by the PTECHCHARGE module's GetDetailAggregate method.

Syntax

DPaymentsSDK.Ptechdetailrecord

Remarks

Credit and voice-authorization Capture transactions are off-line transactions. This means that there is no authorization of funds using the PTechCharge class. Instead, you must manually add these transactions to the settlement batch. The PTDetailRecord class can be used to create these transactions, which can then be added to the PTechManualSettle class's DetailRecords property.

To create a Credit, first set the TransactionType to dttCredit, and then set the IndustryType and EntryDataSource Next, set the Card, SettlementAmount, and the current TransactionDate and TransactionTime.

Since this is an off-line transaction, the SequenceNumber may be any value (except 0), and need not reflect the next available sequence number used for authorizations. Finally, set the PTechManualSettle class's DetailRecords array property with the value returned by the GetDetailAggregate method. You've just added a Credit to the settlement.

Voice authorization Capture transactions are similar to credits, with the exception that it 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 transaction in a Retail environment.

In addition to creating Credit and Force transactions, the PTechDetailRecord class can be used to adjust the Detail Records returned from the PTechCharge class to reflect changes in the SettlementAmount. The most common reasons to modify these detail records are to add a GratuityAmount (tip) to a charge (itResturant IndustryType), or to add additional charges for the itHotel IndustryType. Note that when the SettlementAmount differs from the original authorized amount, the AmountStatus must be updated to asAmountChanged.

Property List

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

Method List

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

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.

Config Settings

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

AmountStatus Property (PTechDetailRecord Module)

Indicates whether SettlementAmount has been modified from the original authorization.

Syntax

• Swift
• Objective-C

public var amountStatus: PtechdetailrecordAmountStatus {
  get {...}
  set {...}
}

public enum PtechdetailrecordAmountStatus: Int32 {
  case asActualAmount = 0
  case asAmountChanged = 1
}

@property (nonatomic,readwrite,assign,getter=amountStatus,setter=setAmountStatus:) int amountStatus;

- (int)amountStatus;
- (void)setAmountStatus :(int)newAmountStatus;

Default Value

0

Remarks

Notes for the Hotel IndustryType:

To obtain the best interchange rate for Visa transactions in the Hotel IndustryType, the check out amount (SettlementAmount) must be within 15% of the original authorization amount. If the SettlementAmount is less than the original authorized amount by more than 15%, you must perform an authorization reversal using the PTechReversal class. This will immediately release funds from the cardholder's open to buy amount. The original transaction must then be settled for the new amount as usual. However, if the SettlementAmount exceeds the original authorized amount by more than 15%, you must submit an incremental authorization to make up the remaining amount. In this case even though there are two separate transactions, they are tied together with the same authorization code. Therefore, only the original authorization (with the newly updated SettlementAmount) is to be sent in the settlement.

Non-Visa transactions do not allow for Incrementals to tie transactions together, nor Reversals to release funds from the cardholder's open to buy amount. There are no restrictions on the difference between the SettlementAmount and the original authorization amount. However, if the merchant suspects that the final transaction amount will be substantially higher than the original authorization amount, the merchant should perform an additional authorization for the difference. This subsequent authorization must be sent to the host as a standard authorization-only transaction, and will not be tied in any way to the original transaction. Both transactions must be present in the settlement.

Notes for the Restaurant IndustryType:

For Visa transactions, to obtain the best interchange rate the SettlementAmount must be within 20% of the authorized amount. The initial authorization must be submitted for the actual transaction amount. It must not be altered to include an additional percentage that accounts for a tip being added before settlement.

The same rule applies to MasterCard transactions, with the exception that MasterCard allows the SettlementAmount to be within 25% of the authorized amount.

There are no rules concerning authorization and settlement amounts for other card types.

This information was accurate at the time this document was written. Please see the Processing and Interchange Guidelines (provided by Paymentech) for updates as well as additional information on interchange rate qualification.

ApprovalCode Property (PTechDetailRecord Module)

The Approval code returned in the response to the authorization linked to this transaction.

Syntax

• Swift
• Objective-C

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

If this is a Forced transaction, ApprovalCode should contain the voice auth code received from the call center. If this is a Credit (Refund) transaction it should remain empty or be space filled.

AuthSource Property (PTechDetailRecord Module)

Indicates the source of the authorization code stored in ApprovalCode .

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=authSource,setter=setAuthSource:) NSString* authSource;

- (NSString*)authSource;
- (void)setAuthSource :(NSString*)newAuthSource;

Default Value

""

Remarks

This field contains a one character code indicating the source of the ApprovalCode. The received code must be stored and submitted in the batch settlement.

Valid source codes:

CardExpMonth Property (PTechDetailRecord Module)

Expiration month of the credit card specified by CardNumber .

Syntax

• Swift
• Objective-C

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 property contains the expiration date of the customer's credit card. This property must be in the range 1 - 12.

CardExpYear Property (PTechDetailRecord Module)

Expiration year of the credit card specified by CardNumber .

Syntax

• Swift
• Objective-C

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

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

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

Default Value

1

Remarks

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

CardNumber Property (PTechDetailRecord Module)

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

Syntax

• Swift
• Objective-C

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.

CardType Property (PTechDetailRecord Module)

Type of the credit card.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=cardType,setter=setCardType:) NSString* cardType;

- (NSString*)cardType;
- (void)setCardType :(NSString*)newCardType;

Default Value

""

Remarks

Paymentech determines the type of credit card used for each authorization, and returns that value to the merchant in the response. The following is a list of card mnemonics and their meanings.

CVVResult Property (PTechDetailRecord Module)

Contains the returned CVV result code if it was requested.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=CVVResult,setter=setCVVResult:) NSString* CVVResult;

- (NSString*)CVVResult;
- (void)setCVVResult :(NSString*)newCVVResult;

Default Value

""

Remarks

If a CVV value was sent in the authorization request, then this one character property will contain the host returned Card Verification Value result code.

ECI Property (PTechDetailRecord Module)

Electronic Commerce Indicator from the original authorization request.

Syntax

• Swift
• Objective-C

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

EntryDataSource Property (PTechDetailRecord Module)

Should reflect the Entry Data Source sent in the original authorization request.

Syntax

• Swift
• Objective-C

public var entryDataSource: PtechdetailrecordEntryDataSources {
  get {...}
  set {...}
}

public enum PtechdetailrecordEntryDataSources: 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=entryDataSource,setter=setEntryDataSource:) int entryDataSource;

- (int)entryDataSource;
- (void)setEntryDataSource :(int)newEntryDataSource;

Default Value

0

Remarks

If sending an off-line credit or capture this property should reflect the way in which the card was presented for the credit or capture.

The following data sources are supported - edsTrack1, edsTrack2, edsManualEntryTrack1Capable, edsManualEntryTrack2Capable, edsManualEntryNoCardReader, edsTrack1Contactless, edsTrack2Contactless, edsManualEntryContactlessCapable

GoodsIndicator Property (PTechDetailRecord Module)

Indicates the type of goods being sold by an e-Commerce merchant.

Syntax

• Swift
• Objective-C

public var goodsIndicator: PtechdetailrecordGoodsIndicators {
  get {...}
  set {...}
}

public enum PtechdetailrecordGoodsIndicators: Int32 {
  case giPhysicalGoods = 0
  case giDigitalGoods = 1
}

@property (nonatomic,readwrite,assign,getter=goodsIndicator,setter=setGoodsIndicator:) int goodsIndicator;

- (int)goodsIndicator;
- (void)setGoodsIndicator :(int)newGoodsIndicator;

Default Value

0

Remarks

If the merchant is selling physical goods (goods that are shipped or are otherwise tangible) this property must be set to giPhysicalGoods. If the merchant is selling Digital goods, such a membership, or any software or file that is delivered electronically, this field must be set to giDigitalGoods. This property is only valid when the IndustryType is set to itECommerce.

GratuityAmount Property (PTechDetailRecord Module)

Gratuity amount for settling restaurant industry transactions.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=gratuityAmount,setter=setGratuityAmount:) NSString* gratuityAmount;

- (NSString*)gratuityAmount;
- (void)setGratuityAmount :(NSString*)newGratuityAmount;

Default Value

""

Remarks

This field contains the gratuity (tip) amount of the transaction being settled. This amount is only sent when the PTechCharge class's IndustryType is set to "itRestaurant". If a transaction includes a GratuityAmount amount, the SettlementAmount must reflect the total of the original Authorized Amount plus the GratuityAmount.

This must be formatted as a dollar amount with a real decimal point, excluding the dollar sign. For instance "12.00".

Hotel Property (PTechDetailRecord Module)

Contains additional information required for the Hotel/Lodging industry.

Syntax

• Swift
• Objective-C

public var hotel: PTechHotelInfo {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=hotelArrivalDate,setter=setHotelArrivalDate:) NSString* hotelArrivalDate;

- (NSString*)hotelArrivalDate;
- (void)setHotelArrivalDate :(NSString*)newHotelArrivalDate;

@property (nonatomic,readwrite,assign,getter=hotelChargeDescriptor,setter=setHotelChargeDescriptor:) int hotelChargeDescriptor;

- (int)hotelChargeDescriptor;
- (void)setHotelChargeDescriptor :(int)newHotelChargeDescriptor;

@property (nonatomic,readwrite,assign,getter=hotelDepartureDate,setter=setHotelDepartureDate:) NSString* hotelDepartureDate;

- (NSString*)hotelDepartureDate;
- (void)setHotelDepartureDate :(NSString*)newHotelDepartureDate;

@property (nonatomic,readwrite,assign,getter=hotelDuration,setter=setHotelDuration:) int hotelDuration;

- (int)hotelDuration;
- (void)setHotelDuration :(int)newHotelDuration;

@property (nonatomic,readwrite,assign,getter=hotelExtraChargeAmount,setter=setHotelExtraChargeAmount:) NSString* hotelExtraChargeAmount;

- (NSString*)hotelExtraChargeAmount;
- (void)setHotelExtraChargeAmount :(NSString*)newHotelExtraChargeAmount;

@property (nonatomic,readwrite,assign,getter=hotelExtraChargesCode,setter=setHotelExtraChargesCode:) NSString* hotelExtraChargesCode;

- (NSString*)hotelExtraChargesCode;
- (void)setHotelExtraChargesCode :(NSString*)newHotelExtraChargesCode;

@property (nonatomic,readwrite,assign,getter=hotelPreferredCustomer,setter=setHotelPreferredCustomer:) BOOL hotelPreferredCustomer;

- (BOOL)hotelPreferredCustomer;
- (void)setHotelPreferredCustomer :(BOOL)newHotelPreferredCustomer;

@property (nonatomic,readwrite,assign,getter=hotelSaleCode,setter=setHotelSaleCode:) int hotelSaleCode;

- (int)hotelSaleCode;
- (void)setHotelSaleCode :(int)newHotelSaleCode;

 

Default Value

1

Remarks

This property will be sent in both authorizations and detail records when the IndustryType is set to Hotel. At minimum, you should pass the expected , , expected , and . You may pass the and in the authorization, but those are normally not known until settlement. To process a reservation or any other transaction where the customer and his card are not physically present, set the property to True;. This will indicate to Paymentech that the transaction is a card-not-present authorization ( must be set to False for normal card-present transaction processing).

IndustryType Property (PTechDetailRecord Module)

Determines the merchant's industry type.

Syntax

• Swift
• Objective-C

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

public enum PtechdetailrecordIndustryTypes: Int32 {
  case pitRetail = 0
  case pitDirectMarketing = 1
  case pitECommerce = 2
  case pitRestaurant = 3
  case pitHotel = 4
}

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

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

Default Value

0

Remarks

This property sets the merchant's industry type. Valid values are shown in the table below:

* Restaurant orders taken over the phone should be processed as itDirectMarketing transactions. Hotel transactions should always be processed in the itHotel IndustryType. Setting the HotelPreferredCustomer property to True.

InvoiceNumber Property (PTechDetailRecord Module)

Invoice Number from the original authorization request.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=invoiceNumber,setter=setInvoiceNumber:) NSString* invoiceNumber;

- (NSString*)invoiceNumber;
- (void)setInvoiceNumber :(NSString*)newInvoiceNumber;

Default Value

""

Remarks

This property should be identical to the InvoiceNumber from the original authorization request.

Level2Data Property (PTechDetailRecord Module)

Supplies extra information for Commercial or Purchasing cards.

Syntax

• Swift
• Objective-C

public var level2Data: PTechLevel2 {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=level2PurchaseId,setter=setLevel2PurchaseId:) NSString* level2PurchaseId;

- (NSString*)level2PurchaseId;
- (void)setLevel2PurchaseId :(NSString*)newLevel2PurchaseId;

@property (nonatomic,readwrite,assign,getter=level2SalesTax,setter=setLevel2SalesTax:) NSString* level2SalesTax;

- (NSString*)level2SalesTax;
- (void)setLevel2SalesTax :(NSString*)newLevel2SalesTax;

@property (nonatomic,readwrite,assign,getter=level2ShipToZip,setter=setLevel2ShipToZip:) NSString* level2ShipToZip;

- (NSString*)level2ShipToZip;
- (void)setLevel2ShipToZip :(NSString*)newLevel2ShipToZip;

 

Default Value

1

Remarks

This property can be used to send additional Level II data that may qualify the merchant for a lower Interchange rate for this transaction. However, it is only valid for use with business or government Purchasing or Commercial Cards. This property is only valid for Sale and AuthOnly transactions. The PTechLevel2 type contains the following fields:

NetworkId Property (PTechDetailRecord Module)

The Authorizing network Id from the original authorization response.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=networkId,setter=setNetworkId:) NSString* networkId;

- (NSString*)networkId;
- (void)setNetworkId :(NSString*)newNetworkId;

Default Value

""

Remarks

This property should be identical to the NetworkId returned from Paymentech in the authorization response.

SequenceNumber Property (PTechDetailRecord Module)

Sequence number of the transaction.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=sequenceNumber,setter=setSequenceNumber:) int sequenceNumber;

- (int)sequenceNumber;
- (void)setSequenceNumber :(int)newSequenceNumber;

Default Value

1

Remarks

This should be identical to the sequence number sent in the original authorization.

ServerNumber Property (PTechDetailRecord Module)

Used for restaurant transactions: Id number of the server (waiter/waitress) making the transaction.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=serverNumber,setter=setServerNumber:) NSString* serverNumber;

- (NSString*)serverNumber;
- (void)setServerNumber :(NSString*)newServerNumber;

Default Value

""

Remarks

Each server should have his or her own unique Id number.

SettlementAmount Property (PTechDetailRecord Module)

The amount that the customer will be charged.

Syntax

• Swift
• Objective-C

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.00"

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.

Note: If a transaction includes a GratuityAmount amount, the SettlementAmount must reflect the total of the original authorized amount plus the GratuityAmount (this is only applicable to the itResturant IndustryType).

This must be formatted as a dollar amount with a real decimal point, excluding the dollar sign. For instance "12.00".

Notes for the Hotel IndustryType:

To obtain the best interchange rate for Visa transactions in the Hotel IndustryType, the check out amount (SettlementAmount) must be within 15% of the original authorization amount. If the SettlementAmount is less than the original authorized amount by more than 15%, you must perform an authorization reversal using the PTechReversal class. This will immediately release funds from the cardholder's open to buy amount. The original transaction must then be settled for the new amount as usual. However, if the SettlementAmount exceeds the original authorized amount by more than 15%, you must submit an incremental authorization to make up the remaining amount. In this case even though there are two separate transactions, they are tied together with the same authorization code. Therefore, only the original authorization (with the newly updated SettlementAmount) is to be sent in the settlement.

Non-Visa transactions do not allow for Incrementals to tie transactions together, nor Reversals to release funds from the cardholder's open to buy amount. There are no restrictions on the difference between the SettlementAmount and the original authorization amount. However, if the merchant suspects that the final transaction amount will be substantially higher than the original authorization amount, the merchant should perform an additional authorization for the difference. This subsequent authorization must be sent to the host as a standard authorization-only transaction, and will not be tied in any way to the original transaction. Both transactions must be present in the settlement.

Notes for the Restaurant IndustryType:

For Visa transactions, to obtain the best interchange rate the SettlementAmount must be within 20% of the authorized amount. The initial authorization must be submitted for the actual transaction amount. It must not be altered to include an additional percentage that accounts for a tip being added before settlement.

The same rule applies to MasterCard transactions, with the exception that MasterCard allows the SettlementAmount to be within 25% of the authorized amount.

There are no rules concerning authorization and settlement amounts for other card types.

This information was accurate at the time this document was written. Please see the Processing and Interchange Guidelines (provided by Paymentech) for updates as well as additional information on interchange rate qualification.

TransactionDate Property (PTechDetailRecord Module)

Local Transaction Date from the original authorization response.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=transactionDate,setter=setTransactionDate:) NSString* transactionDate;

- (NSString*)transactionDate;
- (void)setTransactionDate :(NSString*)newTransactionDate;

Default Value

"010101"

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.

TransactionTime Property (PTechDetailRecord Module)

Local transaction time from the original authorization response.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=transactionTime,setter=setTransactionTime:) NSString* transactionTime;

- (NSString*)transactionTime;
- (void)setTransactionTime :(NSString*)newTransactionTime;

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 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 time. This field must appear in HHMMSS format.

TransactionType Property (PTechDetailRecord Module)

Indicates transaction type for this detail record.

Syntax

• Swift
• Objective-C

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

public enum PtechdetailrecordTransactionTypes: Int32 {
  case dttSale = 1
  case dttCapture = 3
  case dttHotelNoShow = 4
  case dttCredit = 6
}

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

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

Default Value

1

Remarks

This property indicates the type of transaction that is being settled.

Note that only credit card transactions are supported here. EBT, Stored Value, Debit, and Canadian Debit cards must be processed with the Host Capture System, and cannot be manually settled.

Note that transactions Voided with the PTechCharge class must be removed from the batch. Voided transactions must not be settled.

Config Method (PTechDetailRecord Module)

Sets or retrieves a configuration setting.

Syntax

• Swift
• Objective-C

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 (PTechDetailRecord Module)

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

Syntax

• Swift
• Objective-C

public func getDetailAggregate() throws -> String

- (NSString*)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 PTechManualSettle 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 PTechDetailRecord class to do so.

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

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

PTechCharge.Sale(); PTechManualSettle.DetailRecord[0] = PTechCharge.GetDetailAggregate();

ParseAggregate Method (PTechDetailRecord Module)

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

Syntax

• Swift
• Objective-C

public func parseAggregate(aggregate: String) throws -> Void

- (void)parseAggregate:(NSString*)aggregate;

Remarks

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

Reset Method (PTechDetailRecord Module)

Clears all properties to their default values.

Syntax

• Swift
• Objective-C

public func reset() throws -> Void

- (void)reset;

Remarks

This method clears all properties to their default values.

Error Event (PTechDetailRecord Module)

Information about errors during data delivery.

Syntax

• Swift
• Objective-C

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.

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

PTechHotelInfo Type

Contains additional information required for the Hotel/Lodging industry.

Remarks

This type is used in both authorizations and detail records when processing transactions in the hotel/lodging industry type. At minimum, you should pass the expected of stay, , expected , and . You may pass the and in the authorization, but those are normally not known until settlement. To process a reservation or any other transaction where the customer and his card are not physically present, set the property to True;. This will indicate to Paymentech that the transaction is a card-not-present authorization ( must be set to False for normal card-present transaction processing).

Fields

Constructors

public init()

PTechLevel2 Type

Level II Purchase or Commercial Card information.

Remarks

This type allows the merchant to specify additional fields for Commercial Cards or Purchasing Cards for business or government transaction. Supplying the , , and for these credit cards can qualify the merchant for a lower Interchange rate.

Fields

Constructors

public init(purchaseId: , salesTax: , shipToZip: )

public init()

Config Settings (PTechDetailRecord Module)

PTechDetailRecord Config Settings

Base Config Settings

Trappable Errors (PTechDetailRecord Module)

PTechDetailRecord Errors

Paymentech Server Errors:

The following is a list of error codes which may be returned by the Paymentech Server. In the case of a server-side error condition, the ResponseCode property will contain "E", the error code will be contained in the ResponseApprovalCode property, and the description in ResponseText

Paymentech Issuer Errors

Paymentech Format Errors

Paymentech Host / Setup Errors

Paymentech Debit / EBT Specific Errors

Paymentech Batch Management Errors (use the ErrorCode configuration setting to retrieve this information from the PTechHostSettle class.

HTTP Errors

TCPClient Errors

SSL Errors

TCP/IP Errors