Class FinTanProcessParameters
Parameters of a particular TAN process as defined in the HITANS segment.
public class FinTanProcessParameters
- Inheritance
-
FinTanProcessParameters
- Inherited Members
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
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
ChallengeAmountReqd
Indicates whether the order amount must be included together with the TAN.
public bool ChallengeAmountReqd
Field Value
ChallengeClassReqd
Indicates whether a challenge class must be supplied together with the TAN.
public bool ChallengeClassReqd
Field Value
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
ChallengeStructd
Indicates whether the challenge is structured with simple HTML markup. (HITANS version 4 or later only)
public bool ChallengeStructd
Field Value
DecoupledManualConfirmationPossible
(HITANS version 7 or later only)
public bool DecoupledManualConfirmationPossible
Field Value
DecoupledMaxPollsAllowed
(HITANS version 7 or later only)
public int DecoupledMaxPollsAllowed
Field Value
DecoupledMinSecondsBeforePolling
(HITANS version 7 or later only)
public int DecoupledMinSecondsBeforePolling
Field Value
DecoupledMinSecondsBetweenPolls
(HITANS version 7 or later only)
public int DecoupledMinSecondsBetweenPolls
Field Value
MaxChallengeLength
Maximum length of the challenge value provided by the bank.
public int MaxChallengeLength
Field Value
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
MultiTanAllowed
Indicates whether there may be orders that need multiple TANs for a full authorization.
public bool MultiTanAllowed
Field Value
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
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
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
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
ResponseHHDUCReqd
Is the HHD_UC response required? (HITANS version 5 or later only)
public bool ResponseHHDUCReqd
Field Value
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
SegmentVersion
The HITANS segment version from which these parameters have been extracted.
public int SegmentVersion
Field Value
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
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
TanListNoReqd
Indicates whether a TAN list number must be supplied.
public bool TanListNoReqd
Field Value
TanMediaInitMode
The template string for the TAN media initialisation mode.
public string TanMediaInitMode
Field Value
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
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
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
ZkaTanProc
ZKA TAN procedure identification. (HITANS version 4 or later only)
public string ZkaTanProc
Field Value
ZkaTanProcVersion
ZKA TAN procedure version. (HITANS version 4 or later only)
public string ZkaTanProcVersion
Field Value
Properties
DecoupledPollingAllowed
(HITANS version 7 or later only)
public bool DecoupledPollingAllowed { get; set; }
Property Value
IsDecoupled
public bool IsDecoupled { get; }
Property Value
Methods
GetDecoupledMaxPollsAllowed()
Returns DecoupledMaxPollsAllowed, or a suitable default value, if the parameter was not set.
public int GetDecoupledMaxPollsAllowed()
Returns
GetDecoupledMinSecondsBeforePolling()
Returns DecoupledMinSecondsBeforePolling, or a suitable default value, if the parameter was not set.
public int GetDecoupledMinSecondsBeforePolling()
Returns
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
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()