Show / Hide Table of Contents
TIM SDK22-01
TIM API .NETv3.17.0
Implementation Guide
  • SIX.TimApi
    • ActivateResponse
    • Amount
    • AmountDcc
    • AmountDiscount
    • AmountFinal
    • Application
    • BalanceInquiryResponse
    • BalanceResponse
    • Basket
    • BasketItem
    • Brand
    • CardData
    • CardTrackData
    • ClientIdentificationResponse
    • CommandRequest
    • CommandResponse
    • ConfigData
    • ConversionHelper
    • Counter
    • CounterList
    • CurrencyFunctions
    • CurrencyFunctions.CurrencyCodeEntry
    • CurrencyItem
    • DeactivateResponse
    • DefaultTerminalListener
    • DisplayProductInfo
    • EcrInfo
    • ErrorMessages
    • Features
    • FeaturesHardware
    • FeaturesPayment
    • FeaturesSixml
    • FeaturesSixml.Support
    • Hardware
    • HardwareInformationResponse
    • ImmutableTerminalSettings
    • InitTransactionResponse
    • ItemQuantity
    • KernelVersion
    • LoginRequest
    • LoyaltyCoupon
    • LoyaltyDiscount
    • LoyaltyInformation
    • LoyaltyItem
    • MerchantOption
    • MobileTopupData
    • MobileTopupValue
    • NativeError
    • NetworkInformation
    • PpInfo
    • PrintData
    • PrintOption
    • PrintOptionList
    • Receipt
    • ReceiptItem
    • ReceiptItems
    • ReceiptRequestResponse
    • ReconciliationResponse
    • RequestTypes
    • ScreenshotInformation
    • Setting
    • ShowDialogRequest
    • ShowDialogResponse
    • ShowSignatureCaptureRequest
    • ShowSignatureCaptureResponse
    • SignatureInformation
    • SIXmlConstants
    • SIXmlConstants.ResourceId
    • SubTransaction
    • SystemInformationResponse
    • Terminal
    • Terminal.ActivateCompletedEventArgs
    • Terminal.ActivateCompletedEventHandler
    • Terminal.ActivateServiceMenuCompletedEventArgs
    • Terminal.ActivateServiceMenuCompletedEventHandler
    • Terminal.ApplicationInformationCompletedEventArgs
    • Terminal.ApplicationInformationCompletedEventHandler
    • Terminal.BalanceCompletedEventArgs
    • Terminal.BalanceCompletedEventHandler
    • Terminal.BalanceInquiryCompletedEventArgs
    • Terminal.BalanceInquiryCompletedEventHandler
    • Terminal.ChangeSettingsCompletedEventArgs
    • Terminal.ChangeSettingsCompletedEventHandler
    • Terminal.ClientIdentificationCompletedEventArgs
    • Terminal.ClientIdentificationCompletedEventHandler
    • Terminal.CloseDialogModeCompletedEventArgs
    • Terminal.CloseDialogModeCompletedEventHandler
    • Terminal.CloseMaintenanceWindowCompletedEventArgs
    • Terminal.CloseMaintenanceWindowCompletedEventHandler
    • Terminal.CloseReaderCompletedEventArgs
    • Terminal.CloseReaderCompletedEventHandler
    • Terminal.CommitCompletedEventArgs
    • Terminal.CommitCompletedEventHandler
    • Terminal.ConnectCompletedHandler
    • Terminal.CounterRequestCompletedEventArgs
    • Terminal.CounterRequestCompletedEventHandler
    • Terminal.DccRatesCompletedEventArgs
    • Terminal.DccRatesCompletedEventHandler
    • Terminal.DeactivateCompletedEventArgs
    • Terminal.DeactivateCompletedEventHandler
    • Terminal.DeferredAuthEventHandler
    • Terminal.DeviceMaintenanceCompletedEventArgs
    • Terminal.DeviceMaintenanceCompletedEventHandler
    • Terminal.DisconnectedHandler
    • Terminal.EjectCardCompletedEventArgs
    • Terminal.EjectCardCompletedEventHandler
    • Terminal.ErrorNotificationHandler
    • Terminal.FinishCheckoutCompletedEventArgs
    • Terminal.FinishCheckoutCompletedEventHandler
    • Terminal.HardwareInformationCompletedEventArgs
    • Terminal.HardwareInformationCompletedEventHandler
    • Terminal.InitTransactionCompletedEventArgs
    • Terminal.InitTransactionCompletedEventHandler
    • Terminal.InitTransactionWithDialogCompletedEventArgs
    • Terminal.InitTransactionWithDialogCompletedEventHandler
    • Terminal.KeyPressedEventHandler
    • Terminal.KeyPressedNotificationArgs
    • Terminal.LicenseChangedEventHandler
    • Terminal.LoginCompletedEventArgs
    • Terminal.LoginCompletedEventHandler
    • Terminal.LogoutCompletedEventArgs
    • Terminal.LogoutCompletedEventHandler
    • Terminal.LoyaltyDataCompletedEventArgs
    • Terminal.LoyaltyDataCompletedEventHandler
    • Terminal.MobileTopupCompletedEventArgs
    • Terminal.MobileTopupCompletedEventHandler
    • Terminal.MobileTopupIssuerInfoCompletedEventArgs
    • Terminal.MobileTopupIssuerInfoCompletedEventHandler
    • Terminal.OpenDialogModeCompletedEventArgs
    • Terminal.OpenDialogModeCompletedEventHandler
    • Terminal.OpenMaintenanceWindowCompletedEventArgs
    • Terminal.OpenMaintenanceWindowCompletedEventHandler
    • Terminal.OpenReaderCompletedEventArgs
    • Terminal.OpenReaderCompletedEventHandler
    • Terminal.PrintOnTerminalCompletedEventArgs
    • Terminal.PrintOnTerminalCompletedEventHandler
    • Terminal.ProvideLoyaltyBasketCompletedEventArgs
    • Terminal.ProvideLoyaltyBasketCompletedEventHandler
    • Terminal.ProvideVasResultCompletedEventArgs
    • Terminal.ProvideVasResultCompletedEventHandler
    • Terminal.RebootCompletedEventArgs
    • Terminal.RebootCompletedEventHandler
    • Terminal.ReceiptRequestCompletedEventArgs
    • Terminal.ReceiptRequestCompletedEventHandler
    • Terminal.ReconciliationCompletedEventArgs
    • Terminal.ReconciliationCompletedEventHandler
    • Terminal.ReconfigCompletedEventArgs
    • Terminal.ReconfigCompletedEventHandler
    • Terminal.RequestAliasCompletedEventArgs
    • Terminal.RequestAliasCompletedEventHandler
    • Terminal.RequestCompletedEventArgs
    • Terminal.RollbackCompletedEventArgs
    • Terminal.RollbackCompletedEventHandler
    • Terminal.ScreenshotHandler
    • Terminal.SendCardCommandCompletedEventArgs
    • Terminal.SendCardCommandCompletedEventHandler
    • Terminal.ShowDialogCompletedEventArgs
    • Terminal.ShowDialogCompletedEventHandler
    • Terminal.ShowSignatureCaptureCompletedEventArgs
    • Terminal.ShowSignatureCaptureCompletedEventHandler
    • Terminal.SoftwareUpdateCompletedEventArgs
    • Terminal.SoftwareUpdateCompletedEventHandler
    • Terminal.StartCheckoutCompletedEventArgs
    • Terminal.StartCheckoutCompletedEventHandler
    • Terminal.SystemInformationCompletedEventArgs
    • Terminal.SystemInformationCompletedEventHandler
    • Terminal.TerminalStatusChangedHandler
    • Terminal.TransactionCompletedEventArgs
    • Terminal.TransactionCompletedEventHandler
    • Terminal.TransactionInfoRequestCompletedEventArgs
    • Terminal.TransactionInfoRequestCompletedEventHandler
    • Terminal.VasInfoHandler
    • TerminalListener
    • TerminalSettings
    • TerminalStatus
    • TimEvent
    • TimException
    • Total
    • TransactionData
    • TransactionInfoRequestResponse
    • TransactionInformation
    • TransactionRequest
    • TransactionResponse
    • TransactionResponse.Action
    • TrxDetail
    • VasCheckoutInformation
    • VasInformationList
    • VasResult
  • SIX.TimApi.Constants
    • AccountType
    • AdditionalInfoItem
    • AdjustmentResult
    • AdminFunctions
    • AllowedAccounts
    • BrandBarBrand
    • BrandMode
    • CardProductType
    • CardReader
    • CardReaderStatus
    • ConnectionMode
    • ConnectionStatus
    • CounterType
    • CouponRejectionReason
    • Currency
    • CurrencyType
    • CustomerDataType
    • Cvm
    • DialogFunctions
    • EcrInfoType
    • FinancialTransactions
    • FunctionHint
    • Guides
    • HardwareType
    • ImageFileFormat
    • KernelType
    • LoyaltyFunctionType
    • MaintenanceType
    • ManagementStatus
    • MerchantAction
    • MerchantOptionType
    • MobileTopupType
    • NgvMode
    • NonFinancialTransactions
    • Outcome
    • PaymentProtocol
    • PosEntryMode
    • PrintFlag
    • PrintFormat
    • ProcessingDisposition
    • ProtocolLevel
    • ProtocolType
    • Reason
    • ReceiptItemType
    • ReceiptRequestType
    • ReceiptType
    • Recipient
    • RemoteFunctions
    • ResourceId
    • ResourceParameterType
    • ResponseType
    • ResultCode
    • SecurityStatus
    • SettingType
    • SleepModeStatus
    • StatusFunctions
    • Theme
    • TokenPanType
    • TransactionReason
    • TransactionStatus
    • TransactionType
    • UpdateStatus
    • VasInfoListType
    • VasInfoType
  • SIX.TimApi.Receipts
    • CompactReceiptFormatter
    • CustomReceiptFormatter
    • CustomReceiptFormatter.Condition
    • CustomReceiptFormatter.Counters
    • CustomReceiptFormatter.LineFormat
    • CustomReceiptFormatter.TextAlignment
    • CustomReceiptFormatter.TextElement
    • CustomReceiptFormatter.TextType
    • CustomReceiptFormatter.TranslatedText
    • NormalReceiptFormatter
    • ReceiptFormatter
    • SuperCompactReceiptFormatter
    • UltraCompactReceiptFormatter
  • SIX.TimApi.Utility.Logger
    • Level
    • Logger
    • Logger.ArchiveMode
    • Logger.CodeBlock
    • Logger.CodeBlock<T>
    • LogRecord

Class TransactionData

Contains configuration for transaction used by {@link Terminal.Transaction} or {@link Terminal.TransactionAsync}.

Inheritance
System.Object
TransactionData
Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
System.Object.ReferenceEquals(System.Object, System.Object)
Namespace: SIX.TimApi
Assembly: TimApi.dll
Syntax
public class TransactionData

Constructors

TransactionData()

Create transaction data.

Declaration
public TransactionData()

TransactionData(TransactionData)

Create copy of transaction data

Declaration
public TransactionData(TransactionData data)
Parameters
Type Name Description
TransactionData data

The TransactionData to copy.

Properties

AcqId

Acquirer identifier. Uniquely identifies the acquirer.

Declaration
public long AcqId { get; set; }
Property Value
Type Description
System.Int64

AcqTransRef

Contains the transaction reference from the acquirer.

Declaration
public string AcqTransRef { get; set; }
Property Value
Type Description
System.String

AllowedAccounts

Allowed accounts.

Declaration
public List<AllowedAccounts> AllowedAccounts { get; set; }
Property Value
Type Description
System.Collections.Generic.List<AllowedAccounts>

AppExpirationDate

Application expiration date. Each application on a card has a corresponding expiration date and can be read from the card. Example: The format of an 'Expiration Date' is defined as MMyy, 2 digits for the month and 2 digits for the year. So January 2018 will have the following format as 'Expiration Date': 0118 Optional: Used for MPKE for non-PCI brands based transactions.

Declaration
public DateTime? AppExpirationDate { get; set; }
Property Value
Type Description
System.Nullable<System.DateTime>

CardRef

Petrol: Reference from the card.

Declaration
public string CardRef { get; set; }
Property Value
Type Description
System.String

Cvc2

Card verification code 2. The card verification code 2 is used for transactions with MPKE as an additional security element that has to be provided. It has an n3 value: Numeric 3 digits: 012 Optional: Used for MPKE for non-PCI brands.

Declaration
public long? Cvc2 { get; set; }
Property Value
Type Description
System.Nullable<System.Int64>

DccAllowed

Set or read if the EFT Terminal is allowed to enable DCC function.

If not specified by the EFT false is returned. Deprecated! Use DccAllowedNullable instead since this property can return null value if not set.

Declaration
[Obsolete("Use DccAllowedNullable instead since this property can return null value if not set.")]
public bool DccAllowed { get; set; }
Property Value
Type Description
System.Boolean

DccAllowedNullable

Set or read if the EFT Terminal is allowed to enable DCC function.

Declaration
public bool? DccAllowedNullable { get; set; }
Property Value
Type Description
System.Nullable<System.Boolean>

DeferredAuthInd

Indicates that the transaction shall be performed using deffered authorisation. The following values are valid: true: Deferred authorisation applies false: Standard authorisation scheme (default)

Declaration
public bool? DeferredAuthInd { get; set; }
Property Value
Type Description
System.Nullable<System.Boolean>

EcrSeqCounter

Declaration
[Obsolete("Use EcrSeqCounterNullable instead since this property can return null value if not set.")]
public int EcrSeqCounter { get; set; }
Property Value
Type Description
System.Int32

EcrSeqCounterNullable

ECR sequence counter or null if not set.

Declaration
public int? EcrSeqCounterNullable { get; set; }
Property Value
Type Description
System.Nullable<System.Int32>

InstallmentAllowed

Indicates if installment shall be allowed for a transaction. This tag can be set for each transaction separately to specifically allow or disallow installment feature during the corresponding transaction. As this is a boolean value is can be understood as follows: true: Installment is allowed for the transaction false: Installment is NOT allowed for the transaction

Declaration
public bool? InstallmentAllowed { get; set; }
Property Value
Type Description
System.Nullable<System.Boolean>

Language

the language. (Petrol, Unattended)

Declaration
public string Language { get; set; }
Property Value
Type Description
System.String

MultiCurrencyFlag

Indicates if the transaction uses multiple currencies.

Optional: Indicates that the transaction uses multiple currencies.

Specifications: banking, gastro, hospitality,austrianUseCases.

Declaration
public bool MultiCurrencyFlag { get; set; }
Property Value
Type Description
System.Boolean

NGVClearingDelay

Defines the clearing delay of the PurchaseNGV transaction.

The following values are currently defined:

Value Description
0 no delay
1-99 delay in days

Not used if getNgvMode() is null.

Available if {@link Guides#AUSTRIAN_USE_CASES} is enabled.

Declaration
public int NGVClearingDelay { get; set; }
Property Value
Type Description
System.Int32

NGVMode

Defines if NGV usage is mandatory or optional if card supports it.

Set to null if not used.

Available if {@link Guides#AUSTRIAN_USE_CASES} is enabled.

Declaration
public NgvMode NGVMode { get; set; }
Property Value
Type Description
NgvMode

PartialApprovalAllowed

Partial approval is allowed.

If not specified by the EFT false is returned. Deprecated! Use PartialApprovalAllowedNullable instead since this property can return null value if not set.

Declaration
[Obsolete("Use PartialApprovalAllowedNullable instead since this property can return null value if not set.")]
public bool PartialApprovalAllowed { get; set; }
Property Value
Type Description
System.Boolean

PartialApprovalAllowedNullable

Partial approval is allowed.

Declaration
public bool? PartialApprovalAllowedNullable { get; set; }
Property Value
Type Description
System.Nullable<System.Boolean>

PhoneAuthCode

Phone authorization code.

Declaration
public string PhoneAuthCode { get; set; }
Property Value
Type Description
System.String

SaferpayAlias

Saferpay alias..

Declaration
public string SaferpayAlias { get; set; }
Property Value
Type Description
System.String

SaferpayRecurring

Saferpay recurring enabled.

Declaration
public bool SaferpayRecurring { get; set; }
Property Value
Type Description
System.Boolean

SixTrxRefNum

SIX Transaction reference number.

Declaration
public string SixTrxRefNum { get; set; }
Property Value
Type Description
System.String

SubTransactions

Sub transactions.

Declaration
public List<SubTransaction> SubTransactions { get; set; }
Property Value
Type Description
System.Collections.Generic.List<SubTransaction>

TipAllowed

Tip is allowed for purchase transactions. Use null to not use this parameter.

This parameter is only used if {@link com.six.timapi.constants.Guides#GASTRO} is enabled.

If not specified by the EFT false is returned. Deprecated! Use TipAllowedNullable instead since this property can return null value if not set.

Declaration
[Obsolete("Use TipAllowedNullable instead since this property can return null value if not set.")]
public bool TipAllowed { get; set; }
Property Value
Type Description
System.Boolean

TipAllowedNullable

Tip is allowed for purchase transactions. Use null to not use this parameter.

This parameter is only used if {@link com.six.timapi.constants.Guides#GASTRO} is enabled.

Declaration
public bool? TipAllowedNullable { get; set; }
Property Value
Type Description
System.Nullable<System.Boolean>

TokenPan

The token PAN is a tokenized version for an underlaying card PAN. If the underlaying payment protocol supports it, a payment transaction can be initiated with the token PAN instead of using a card. A token PAN is normally generated by a tokenization service either form the acquirer host or the issuer host.

The TokenPan field is used in a SIXml request message as part of the sixml:TransactionData container to trigger a token-based transaction and in a SIXml response message as part of the sixml:CardData container for returning token PANs to the ECR.

The TokenPan field always must be accompanied by a corresponding TokenPanType field.

Declaration
public string TokenPan { get; set; }
Property Value
Type Description
System.String

TokenPanType

To differ the source of a token PAN, the TokenPanType field is used in a SIXml request message as part of the sixml:TransactionData container and in a SIXml response message as part of the sixml:CardData container.

The TokenPanType field always is transmitted if a TokenPan field is transmitted but must not be transmitted alone.

Declaration
public TokenPanType TokenPanType { get; set; }
Property Value
Type Description
TokenPanType

TransactionReason

Set the transaction reason to setup credential on file.

Declaration
public TransactionReason TransactionReason { get; set; }
Property Value
Type Description
TransactionReason

TransRef

Get/Set transaction reference defined by the terminal.

Declaration
public string TransRef { get; set; }
Property Value
Type Description
System.String

TransSeq

Get/Set transaction sequence number defined by the terminal.

Declaration
public string TransSeq { get; set; }
Property Value
Type Description
System.String

TrmTransRef

transaction reference from the terminal.

Declaration
public string TrmTransRef { get; set; }
Property Value
Type Description
System.String

TrxOriginalDate

Timestamp of the original transaction.

If not specified by the EFT DateTime.MinValue is returned. Deprecated! Use TrxOriginalDateNullable instead since this property can return null value if not set.

Declaration
[Obsolete("Use TrxOriginalDateNullable instead since this property can return null value if not set.")]
public DateTime TrxOriginalDate { get; set; }
Property Value
Type Description
System.DateTime

TrxOriginalDateNullable

Timestamp of the original transaction.

Declaration
public DateTime? TrxOriginalDateNullable { get; set; }
Property Value
Type Description
System.Nullable<System.DateTime>

Methods

setAcqTransRef(Int64, Int32)

Set transaction reference from the acquirer.

This method is to be used only for manual entry by clerks for EP2 hospitality transactions only.

Acquirer ID as printed on receipt. trxRefNo Transaction reference as printed on receipt.
Declaration
public void setAcqTransRef(long acqId, int trxRefNo)
Parameters
Type Name Description
System.Int64 acqId
System.Int32 trxRefNo

setSixTrxRefNum(Int64, String)

Set SIX Transaction Reference Number for integrators using MPD Client.

Declaration
public void setSixTrxRefNum(long acqId, string trxRefNum)
Parameters
Type Name Description
System.Int64 acqId
System.String trxRefNum

ToString()

String representation.

Declaration
public override string ToString()
Returns
Type Description
System.String
Overrides
System.Object.ToString()
In This Article
  • Constructors
    • TransactionData()
    • TransactionData(TransactionData)
  • Properties
    • AcqId
    • AcqTransRef
    • AllowedAccounts
    • AppExpirationDate
    • CardRef
    • Cvc2
    • DccAllowed
    • DccAllowedNullable
    • DeferredAuthInd
    • EcrSeqCounter
    • EcrSeqCounterNullable
    • InstallmentAllowed
    • Language
    • MultiCurrencyFlag
    • NGVClearingDelay
    • NGVMode
    • PartialApprovalAllowed
    • PartialApprovalAllowedNullable
    • PhoneAuthCode
    • SaferpayAlias
    • SaferpayRecurring
    • SixTrxRefNum
    • SubTransactions
    • TipAllowed
    • TipAllowedNullable
    • TokenPan
    • TokenPanType
    • TransactionReason
    • TransRef
    • TransSeq
    • TrmTransRef
    • TrxOriginalDate
    • TrxOriginalDateNullable
  • Methods
    • setAcqTransRef(Int64, Int32)
    • setSixTrxRefNum(Int64, String)
    • ToString()
Back to top Worldline AG