Class FinTanProcessParameters

Namespace

Subsembly.FinTS

Assembly

Subsembly.FinTS.Core.dll

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

public class FinTanProcessParameters

Inheritance

object

FinTanProcessParameters

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

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.

public int ActiveTanListCount

Field Value

int

ActiveTanMediaCount

Number of active TAN medias that a user can have.

public int? ActiveTanMediaCount

Field Value

int?

Remarks

This is now an optional integer, so that the caller can distinguish whether the value was actually provided, or not.

CancelOrderAllowed

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

public bool CancelOrderAllowed

Field Value

bool

ChallengeAmountReqd

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

public bool ChallengeAmountReqd

Field Value

bool

ChallengeClassReqd

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

public bool ChallengeClassReqd

Field Value

bool

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.

public string ChallengeLabel

Field Value

string

ChallengeStructd

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

public bool ChallengeStructd

Field Value

bool

DecoupledManualConfirmationPossible

(HITANS version 7 or later only)

public bool DecoupledManualConfirmationPossible

Field Value

bool

DecoupledMaxPollsAllowed

(HITANS version 7 or later only)

public int DecoupledMaxPollsAllowed

Field Value

int

DecoupledMinSecondsBeforePolling

(HITANS version 7 or later only)

public int DecoupledMinSecondsBeforePolling

Field Value

int

DecoupledMinSecondsBetweenPolls

(HITANS version 7 or later only)

public int DecoupledMinSecondsBetweenPolls

Field Value

int

MaxChallengeLength

Maximum length of the challenge value provided by the bank.

public int MaxChallengeLength

Field Value

int

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.

public int MaxTanLength

Field Value

int

MultiTanAllowed

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

public bool MultiTanAllowed

Field Value

bool

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!

public bool MultipleTanOrdersAllowed

Field Value

bool

Remarks

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

Name

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

public string Name

Field Value

string

OrderHashMode

Hash algorithm to be applied to the order segment.

public FinHash OrderHashMode

Field Value

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 ComputeOrderHash(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)

public bool OrderingAcctReqd

Field Value

bool

PostponedTanAllowed

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

public bool PostponedTanAllowed

Field Value

bool

ResponseHHDUCReqd

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

public bool ResponseHHDUCReqd

Field Value

bool

Remarks

Field is mandatory inside HITANS v6.

SecurityFunction

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

public int SecurityFunction

Field Value

int

SegmentVersion

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

public int SegmentVersion

Field Value

int

SmsChargingAcctReqd

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

public bool SmsChargingAcctReqd

Field Value

bool

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.

public int TanFormat

Field Value

int

TanListNoReqd

Indicates whether a TAN list number must be supplied.

public bool TanListNoReqd

Field Value

bool

TanMediaInitMode

The template string for the TAN media initialisation mode.

public string TanMediaInitMode

Field Value

string

TanMediaNameReqd

Provides the actual numerical value of the "TAN media name required" data element. Indicates whether the TAN media name should be included with the TAN.

public int TanMediaNameReqd

Field Value

int

Remarks

This used to be a boolean value which was true, whenever the actual value is 2.

TanProcess

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

public int TanProcess

Field Value

int

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.

public string TechnicalIdentification

Field Value

string

ZkaTanProc

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

public string ZkaTanProc

Field Value

string

ZkaTanProcVersion

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

public string ZkaTanProcVersion

Field Value

string

Properties

DecoupledPollingAllowed

(HITANS version 7 or later only)

public bool DecoupledPollingAllowed { get; set; }

Property Value

bool

IsDecoupled

public bool IsDecoupled { get; }

Property Value

bool

Methods

GetDecoupledMaxPollsAllowed()

Returns DecoupledMaxPollsAllowed, or a suitable default value, if the parameter was not set.

public int GetDecoupledMaxPollsAllowed()

Returns

int

GetDecoupledMinSecondsBeforePolling()

Returns DecoupledMinSecondsBeforePolling, or a suitable default value, if the parameter was not set.

public int GetDecoupledMinSecondsBeforePolling()

Returns

int

Remarks

If the parameter DecoupledMinSecondsBeforePolling is less than one second, then the value one will be returned. If the parameter DecoupledMinSecondsBeforePolling is greater than ten seconds, then the value ten will be returned.

GetDecoupledMinSecondsBetweenPolls()

Returns DecoupledMinSecondsBetweenPolls, or a suitable default value, if the parameter was not set.

public int GetDecoupledMinSecondsBetweenPolls()

Returns

int

Remarks

If the parameter DecoupledMinSecondsBetweenPolls is less than one second, then the value one will be returned. If the parameter DecoupledMinSecondsBetweenPolls is greater than ten seconds, then the value ten will be returned.

GetTanMediaClass()

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

public string GetTanMediaClass()

Returns

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

public override string ToString()

Returns

string