Class FinTanProcessParameters

Parameters of a particular TAN process as defined in the HITANS segment.

Inheritance
System.Object
FinTanProcessParameters
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: Subsembly.FinTS
Assembly: Subsembly.FinTS.Core.dll
Syntax
public class FinTanProcessParameters

Fields

ActiveTanListCount

Number of active TAN lists that a user can have. If this is more than one, then the TAN list number must be provided in the HKTAN segment. Otherwise the TAN list number is an optional element.

Declaration
public int ActiveTanListCount
Field Value
Type Description
System.Int32

ActiveTanMediaCount

Number of active TAN medias that a user can have.

Declaration
public int ActiveTanMediaCount
Field Value
Type Description
System.Int32

CancelOrderAllowed

Indicates whether the order may be cancelled after the TAN was requested.

Declaration
public bool CancelOrderAllowed
Field Value
Type Description
System.Boolean

ChallengeAmountReqd

Indicates whether the order amount must be included together with the TAN.

Declaration
public bool ChallengeAmountReqd
Field Value
Type Description
System.Boolean

ChallengeClassReqd

Indicates whether a challenge class must be supplied together with the TAN.

Declaration
public bool ChallengeClassReqd
Field Value
Type Description
System.Boolean

ChallengeLabel

Label to be shown next to the challenge when prompting the user for TAN entry. The max length of this field is 30 characters.

Declaration
public string ChallengeLabel
Field Value
Type Description
System.String

ChallengeStructd

Indicates whether the challenge is structured with simple HTML markup. (HITANS version 4 or later only)

Declaration
public bool ChallengeStructd
Field Value
Type Description
System.Boolean

DecoupledManualConfirmationPossible

(HITANS version 7 or later only)

Declaration
public bool DecoupledManualConfirmationPossible
Field Value
Type Description
System.Boolean

DecoupledMaxPollsAllowed

(HITANS version 7 or later only)

Declaration
public int DecoupledMaxPollsAllowed
Field Value
Type Description
System.Int32

DecoupledMinSecondsBeforePolling

(HITANS version 7 or later only)

Declaration
public int DecoupledMinSecondsBeforePolling
Field Value
Type Description
System.Int32

DecoupledMinSecondsBetweenPolls

(HITANS version 7 or later only)

Declaration
public int DecoupledMinSecondsBetweenPolls
Field Value
Type Description
System.Int32

DecoupledPollingAllowed

(HITANS version 7 or later only)

Declaration
public bool DecoupledPollingAllowed
Field Value
Type Description
System.Boolean

MaxChallengeLength

Maximum length of the challenge value provided by the bank.

Declaration
public int MaxChallengeLength
Field Value
Type Description
System.Int32

MaxTanLength

Maximum length of TAN. When prompting the user to enter the TAN, this length should be used to limit the user input. May be zero if not specified, or Decoupled procedure without TAN.

Declaration
public int MaxTanLength
Field Value
Type Description
System.Int32

MultipleTanOrdersAllowed

Indicates whether more than one order requiring a TAN can be sent in a single message. Tip: Never send more than one TAN requiring order in a message!

Declaration
public bool MultipleTanOrdersAllowed
Field Value
Type Description
System.Boolean
Remarks

This value is extracted from the general data of the HITAN segment, and not from the actual TAN process parameters.

MultiTanAllowed

Indicates whether there may be orders that need multiple TANs for a full authorization.

Declaration
public bool MultiTanAllowed
Field Value
Type Description
System.Boolean

Name

Name of the TAN process. This name shall be shown when prompting the user for TAN entry.

Declaration
public string Name
Field Value
Type Description
System.String

OrderHashMode

Hash algorithm to be applied to the order segment.

Declaration
public FinHash OrderHashMode
Field Value
Type Description
FinHash

The value None indicates that no hash shall be computed and the HKTAN order hash field should not be set. In order to actually compute the hash value, the method Subsembly.FinTS.FinOrder.ComputeOrderHash(Subsembly.FinTS.FinTanProcessParameters) can be used.
Remarks

This value is extracted from the general data of the HITAN segment, and not from the actual TAN process parameters.

OrderingAcctReqd

Indicates whether the complete ordering account information must be included in the HKTAN. (HITANS version 5 or later only)

Declaration
public bool OrderingAcctReqd
Field Value
Type Description
System.Boolean

PostponedTanAllowed

If MultiTanAllowed is true,then this indicates whether further TANs needed for authorization, can be sent in a separate, possibly later dialog.

Declaration
public bool PostponedTanAllowed
Field Value
Type Description
System.Boolean

ResponseHHDUCReqd

Is the HHD_UC response required? (HITANS version 5 or later only)

Declaration
public bool ResponseHHDUCReqd
Field Value
Type Description
System.Boolean
Remarks

Field is mandatory inside HITANS v6.

SecurityFunction

Identifies the particular TAN process. The value must be in the range from 900 through 997.

Declaration
public int SecurityFunction
Field Value
Type Description
System.Int32

SegmentVersion

The HITANS segment version from which these parameters have been extracted.

Declaration
public int SegmentVersion
Field Value
Type Description
System.Int32

SmsChargingAcctReqd

Indicates whether an account to be charged for sending the SMS must be provided. (HITANS version 4 or later only)

Declaration
public bool SmsChargingAcctReqd
Field Value
Type Description
System.Boolean

TanFormat

Indicates whether the entered TAN is numeric (1) or alfanumeric (2). When prompting the user to enter the TAN, this should be used to limit the user input. May be zero if not specified, or Decoupled procedure without TAN.

Declaration
public int TanFormat
Field Value
Type Description
System.Int32

TanListNoReqd

Indicates whether a TAN list number must be supplied.

Declaration
public bool TanListNoReqd
Field Value
Type Description
System.Boolean

TanMediaInitMode

The template string for the TAN media initialisation mode.

Declaration
public string TanMediaInitMode
Field Value
Type Description
System.String

TanMediaNameReqd

Indicates whether the TAN media name must be included with the TAN.

Declaration
public bool TanMediaNameReqd
Field Value
Type Description
System.Boolean

TanProcess

Selects either TAN process type 1 or TAN process type 2.

Declaration
public int TanProcess
Field Value
Type Description
System.Int32

TechnicalIdentification

Technical identification of TAN process. This is for internal identification of a TAN process inside an application and should not be shown to the user.

Declaration
public string TechnicalIdentification
Field Value
Type Description
System.String

ZkaTanProc

ZKA TAN procedure identification. (HITANS version 4 or later only)

Declaration
public string ZkaTanProc
Field Value
Type Description
System.String

ZkaTanProcVersion

ZKA TAN procedure version. (HITANS version 4 or later only)

Declaration
public string ZkaTanProcVersion
Field Value
Type Description
System.String

Properties

IsDecoupled

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

Methods

GetTanMediaClass()

Tries to determine the TAN media class for this TAN process.

Declaration
public string GetTanMediaClass()
Returns
Type Description
System.String

If a TAN media class could be determined, then either "G" for a TAN Generator (chipTAN, SmartTAN) or "M" for Mobile-TAN (smsTAN) will be returned. If the TAN media class could not be determined, then null is returned.
Remarks

The TAN media class may be required when choosing a TAN media through a FinTanMediaList. Each FinTanMedia in the list has a TanMediaClass property which indicates the type of TAN media.

ToString()

Declaration
public override string ToString()
Returns
Type Description
System.String
Overrides
System.Object.ToString()