TIM SDK
TIM API C
transaction_data.h File Reference

Description

Transaction data.

Object type transaction_data.

Functions

ta_e_result_code_t ta_transaction_data_create (ta_object_t *trx_data)
 Create transaction data. More...
 
ta_e_result_code_t ta_transaction_data_copy (ta_object_t *trx_data, const ta_object_t *source_trx_data)
 Create copy of transaction data. More...
 
ta_e_result_code_t ta_transaction_data_get_dcc_allowed (ta_object_t trx_data, ta_e_boolean_t *dcc_allowed)
 Allows the EFT Terminal to enable DCC function. More...
 
ta_e_result_code_t ta_transaction_data_set_dcc_allowed (ta_object_t trx_data, ta_e_boolean_t dcc_allowed)
 Set allows the EFT Terminal to enable DCC function. More...
 
ta_e_result_code_t ta_transaction_data_get_trx_original_date (ta_object_t trx_data, ta_object_t *trx_original_date)
 Timestamp of the original transaction. More...
 
ta_e_result_code_t ta_transaction_data_set_trx_original_date (ta_object_t trx_data, ta_object_t trx_original_date)
 Set timestamp of the original transaction. More...
 
ta_e_result_code_t ta_transaction_data_get_ecr_seq_counter (ta_object_t trx_data, ta_object_t *ecr_seq_counter)
 ECR sequence counter. More...
 
ta_e_result_code_t ta_transaction_data_set_ecr_seq_counter (ta_object_t trx_data, ta_object_t ecr_seq_counter)
 Set ECR sequence counter. More...
 
ta_e_result_code_t ta_transaction_data_get_partial_approval_allowed (ta_object_t trx_data, ta_e_boolean_t *partial_approval_allowed)
 Partial approval is allowed. More...
 
ta_e_result_code_t ta_transaction_data_set_partial_approval_allowed (ta_object_t trx_data, ta_e_boolean_t partial_approval_allowed)
 Set partial approval is allowed. More...
 
ta_e_result_code_t ta_transaction_data_get_trans_ref (ta_object_t trx_data, ta_object_t *trans_ref)
 Transaction reference defined by the terminal. More...
 
ta_e_result_code_t ta_transaction_data_set_trans_ref (ta_object_t trx_data, ta_object_t trans_ref)
 Set transaction reference defined by the terminal. More...
 
ta_e_result_code_t ta_transaction_data_get_trans_seq (ta_object_t trx_data, ta_object_t *trans_seq)
 Transaction sequence number defined by the terminal. More...
 
ta_e_result_code_t ta_transaction_data_set_trans_seq (ta_object_t trx_data, ta_object_t trans_seq)
 Set transaction sequence number defined by the terminal. More...
 
ta_e_result_code_t ta_transaction_data_get_card_ref (ta_object_t trx_data, ta_object_t *card_ref)
 Petrol: Reference from the card. More...
 
ta_e_result_code_t ta_transaction_data_set_card_ref (ta_object_t trx_data, ta_object_t card_ref)
 Set petrol: Reference from the card. More...
 
ta_e_result_code_t ta_transaction_data_get_acq_id (ta_object_t trx_data, ta_object_t *acq_id)
 Acquirer identifier. Uniquely identifies the acquirer. More...
 
ta_e_result_code_t ta_transaction_data_set_acq_id (ta_object_t trx_data, ta_object_t acq_id)
 Set acquirer identifier. Uniquely identifies the acquirer. More...
 
ta_e_result_code_t ta_transaction_data_get_acq_trans_ref (ta_object_t trx_data, ta_object_t *acq_trans_ref)
 Transaction reference from the acquirer. More...
 
ta_e_result_code_t ta_transaction_data_set_acq_trans_ref (ta_object_t trx_data, ta_object_t acq_trans_ref)
 Set transaction reference from the acquirer. More...
 
ta_e_result_code_t ta_transaction_data_get_trm_trans_ref (ta_object_t trx_data, ta_object_t *trm_trans_ref)
 Transaction reference from the terminal. More...
 
ta_e_result_code_t ta_transaction_data_set_trm_trans_ref (ta_object_t trx_data, ta_object_t trm_trans_ref)
 Set transaction reference from the terminal. More...
 
ta_e_result_code_t ta_transaction_data_get_tip_allowed (ta_object_t trx_data, ta_e_boolean_t *tip_allowed)
 Tip is allowed for purchase transactions. More...
 
ta_e_result_code_t ta_transaction_data_set_tip_allowed (ta_object_t trx_data, ta_e_boolean_t tip_allowed)
 Set tip is allowed for purchase transactions. More...
 
ta_e_result_code_t ta_transaction_data_get_phone_auth_code (ta_object_t trx_data, ta_object_t *phone_auth_code)
 Phone authorization code. More...
 
ta_e_result_code_t ta_transaction_data_set_phone_auth_code (ta_object_t trx_data, ta_object_t phone_auth_code)
 Set phone authorization code. More...
 
ta_e_result_code_t ta_transaction_data_get_language (ta_object_t trx_data, ta_object_t *language)
 Petrol, Unattended: Language. More...
 
ta_e_result_code_t ta_transaction_data_set_language (ta_object_t trx_data, ta_object_t language)
 Set petrol, Unattended: Language. More...
 
ta_e_result_code_t ta_transaction_data_get_multi_currency_flag (ta_object_t trx_data, ta_e_boolean_t *multi_currency_flag)
 Indicates if the transaction uses multiple currencies. More...
 
ta_e_result_code_t ta_transaction_data_set_multi_currency_flag (ta_object_t trx_data, ta_e_boolean_t multi_currency_flag)
 Set Indicates if the transaction uses multiple currencies. More...
 
ta_e_result_code_t ta_transaction_data_get_ngv_mode (ta_object_t trx_data, ta_e_ngv_mode_t *ngv_mode)
 Defines if NGV usage is mandatory or optional if card supports it. More...
 
ta_e_result_code_t ta_transaction_data_set_ngv_mode (ta_object_t trx_data, ta_e_ngv_mode_t ngv_mode)
 Set defines if NGV usage is mandatory or optional if card supports it. More...
 
ta_e_result_code_t ta_transaction_data_get_ngv_clearing_delay (ta_object_t trx_data, int *ngv_clearing_delay)
 Defines the clearing delay of the PurchaseNGV transaction. More...
 
ta_e_result_code_t ta_transaction_data_set_ngv_clearing_delay (ta_object_t trx_data, int ngv_clearing_delay)
 Set defines the clearing delay of the PurchaseNGV transaction. More...
 
ta_e_result_code_t ta_transaction_data_get_six_trx_ref_num (ta_object_t trx_data, ta_object_t *six_trx_ref_num)
 SIX Transaction Reference Number. More...
 
ta_e_result_code_t ta_transaction_data_set_six_trx_ref_num (ta_object_t trx_data, ta_object_t six_trx_ref_num)
 Set SIX Transaction Reference Number. More...
 
ta_e_result_code_t ta_transaction_data_get_saferpay_alias (ta_object_t trx_data, ta_object_t *saferpay_alias)
 Saferpay alias. More...
 
ta_e_result_code_t ta_transaction_data_set_saferpay_alias (ta_object_t trx_data, ta_object_t saferpay_alias)
 Set saferpay alias. More...
 
ta_e_result_code_t ta_transaction_data_get_saferpay_recurring (ta_object_t trx_data, ta_e_boolean_t *saferpay_recurring)
 Saferpay recurring enabled. More...
 
ta_e_result_code_t ta_transaction_data_set_saferpay_recurring (ta_object_t trx_data, ta_e_boolean_t saferpay_recurring)
 Set saferpay recurring enabled. More...
 

Function Documentation

◆ ta_transaction_data_copy()

ta_e_result_code_t ta_transaction_data_copy ( ta_object_t trx_data,
const ta_object_t source_trx_data 
)

Create copy of transaction data.

Parameters
[out]trx_dataPointer to variable to write created object instance to. Created object instance is retained.
[in]source_trx_dataObject of type transaction_data to create copy of.
Return values
ta_c_rc_okObject instance has been created and written to trx_data.
ta_c_rc_invalid_argumenttrx_data is null-pointer.
ta_c_rc_invalid_argumentsource_trx_data is ta_invalid_object.
ta_c_rc_invalid_argumentsource_trx_data is not of type transaction_data.
ta_c_rc_out_of_memoryFailed allocating memory.

◆ ta_transaction_data_create()

ta_e_result_code_t ta_transaction_data_create ( ta_object_t trx_data)

Create transaction data.

Parameters
[out]trx_dataPointer to variable to write created object instance to. Created object instance is retained.
Return values
ta_c_rc_okObject instance has been created and written to trx_data.
ta_c_rc_invalid_argumenttrx_data is null-pointer.
ta_c_rc_out_of_memoryFailed allocating memory.

◆ ta_transaction_data_get_acq_id()

ta_e_result_code_t ta_transaction_data_get_acq_id ( ta_object_t  trx_data,
ta_object_t acq_id 
)

Acquirer identifier. Uniquely identifies the acquirer.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]acq_idPointer to variable to write object instance to. Object instance is of type integer and is not retained. Object instance is ta_invalid_object if value is not set in trx_data.
Return values
ta_c_rc_okObject instance written to acq_id.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentacq_id is null-pointer.

◆ ta_transaction_data_get_acq_trans_ref()

ta_e_result_code_t ta_transaction_data_get_acq_trans_ref ( ta_object_t  trx_data,
ta_object_t acq_trans_ref 
)

Transaction reference from the acquirer.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]acq_trans_refPointer to variable to write object instance to. Object instance is of type string and is not retained. Object instance is ta_invalid_object if value is not set in trx_data.
Return values
ta_c_rc_okObject instance written to acq_trans_ref.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentacq_trans_ref is null-pointer.

◆ ta_transaction_data_get_card_ref()

ta_e_result_code_t ta_transaction_data_get_card_ref ( ta_object_t  trx_data,
ta_object_t card_ref 
)

Petrol: Reference from the card.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]card_refPointer to variable to write object instance to. Object instance is of type string and is not retained. Object instance is ta_invalid_object if value is not set in trx_data.
Return values
ta_c_rc_okObject instance written to card_ref.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentcard_ref is null-pointer.

◆ ta_transaction_data_get_dcc_allowed()

ta_e_result_code_t ta_transaction_data_get_dcc_allowed ( ta_object_t  trx_data,
ta_e_boolean_t dcc_allowed 
)

Allows the EFT Terminal to enable DCC function.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]dcc_allowedPointer to variable to write value to. Value is ta_c_b_undefined if value is not set in trx_data.
Return values
ta_c_rc_okValue written to dcc_allowed.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentdcc_allowed is null-pointer.

◆ ta_transaction_data_get_ecr_seq_counter()

ta_e_result_code_t ta_transaction_data_get_ecr_seq_counter ( ta_object_t  trx_data,
ta_object_t ecr_seq_counter 
)

ECR sequence counter.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]ecr_seq_counterPointer to variable to write object instance to. Object instance is of type integer and is not retained. Object instance is ta_invalid_object if value is not set in trx_data.
Return values
ta_c_rc_okObject instance written to ecr_seq_counter.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentecr_seq_counter is null-pointer.

◆ ta_transaction_data_get_language()

ta_e_result_code_t ta_transaction_data_get_language ( ta_object_t  trx_data,
ta_object_t language 
)

Petrol, Unattended: Language.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]languagePointer to variable to write object instance to. Object instance is of type string and is not retained. Object instance is ta_invalid_object if value is not set in trx_data.
Return values
ta_c_rc_okObject instance written to language.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentlanguage is null-pointer.

◆ ta_transaction_data_get_multi_currency_flag()

ta_e_result_code_t ta_transaction_data_get_multi_currency_flag ( ta_object_t  trx_data,
ta_e_boolean_t multi_currency_flag 
)

Indicates if the transaction uses multiple currencies.

Optional: Indicates that the transaction uses multiple currencies. Specifications: Banking, Gastro, Hospitality,AustrianUseCases.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]multi_currency_flagPointer to variable to write value to. Value is ta_c_b_undefined if value is not set in trx_data.
Return values
ta_c_rc_okValue written to multi_currency_flag.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentmulti_currency_flag is null-pointer.

◆ ta_transaction_data_get_ngv_clearing_delay()

ta_e_result_code_t ta_transaction_data_get_ngv_clearing_delay ( ta_object_t  trx_data,
int *  ngv_clearing_delay 
)

Defines the clearing delay of the PurchaseNGV transaction.

Available if AustrianUseCases guide is enabled.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]ngv_clearing_delayPointer to variable to write value to. Value is 0 if value is not set in trx_data.
Return values
ta_c_rc_okValue written to ngv_clearing_delay.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentngv_clearing_delay is null-pointer.

◆ ta_transaction_data_get_ngv_mode()

ta_e_result_code_t ta_transaction_data_get_ngv_mode ( ta_object_t  trx_data,
ta_e_ngv_mode_t ngv_mode 
)

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

Available if AustrianUseCases guide is enabled.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]ngv_modePointer to variable to write value to. Value is ta_c_ngvm_undefined if value is not set in trx_data.
Return values
ta_c_rc_okValue written to ngv_mode.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentngv_mode is null-pointer.

◆ ta_transaction_data_get_partial_approval_allowed()

ta_e_result_code_t ta_transaction_data_get_partial_approval_allowed ( ta_object_t  trx_data,
ta_e_boolean_t partial_approval_allowed 
)

Partial approval is allowed.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]partial_approval_allowedPointer to variable to write value to. Value is ta_c_b_undefined if value is not set in trx_data.
Return values
ta_c_rc_okValue written to partial_approval_allowed.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentpartial_approval_allowed is null-pointer.

◆ ta_transaction_data_get_phone_auth_code()

ta_e_result_code_t ta_transaction_data_get_phone_auth_code ( ta_object_t  trx_data,
ta_object_t phone_auth_code 
)

Phone authorization code.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]phone_auth_codePointer to variable to write object instance to. Object instance is of type string and is not retained. Object instance is ta_invalid_object if value is not set in trx_data.
Return values
ta_c_rc_okObject instance written to phone_auth_code.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentphone_auth_code is null-pointer.

◆ ta_transaction_data_get_saferpay_alias()

ta_e_result_code_t ta_transaction_data_get_saferpay_alias ( ta_object_t  trx_data,
ta_object_t saferpay_alias 
)

Saferpay alias.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]saferpay_aliasPointer to variable to write object instance to. Object instance is of type string and is not retained. Object instance is ta_invalid_object if value is not set in trx_data.
Return values
ta_c_rc_okObject instance written to saferpay_alias.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentsaferpay_alias is null-pointer.

◆ ta_transaction_data_get_saferpay_recurring()

ta_e_result_code_t ta_transaction_data_get_saferpay_recurring ( ta_object_t  trx_data,
ta_e_boolean_t saferpay_recurring 
)

Saferpay recurring enabled.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]saferpay_recurringPointer to variable to write value to. Value is ta_c_b_undefined if value is not set in trx_data.
Return values
ta_c_rc_okValue written to saferpay_recurring.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentsaferpay_recurring is null-pointer.

◆ ta_transaction_data_get_six_trx_ref_num()

ta_e_result_code_t ta_transaction_data_get_six_trx_ref_num ( ta_object_t  trx_data,
ta_object_t six_trx_ref_num 
)

SIX Transaction Reference Number.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]six_trx_ref_numPointer to variable to write object instance to. Object instance is of type string and is not retained. Object instance is ta_invalid_object if value is not set in trx_data.
Return values
ta_c_rc_okObject instance written to six_trx_ref_num.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentsix_trx_ref_num is null-pointer.

◆ ta_transaction_data_get_tip_allowed()

ta_e_result_code_t ta_transaction_data_get_tip_allowed ( ta_object_t  trx_data,
ta_e_boolean_t tip_allowed 
)

Tip is allowed for purchase transactions.

This parameter is only used if ta_c_g_gastro is enabled.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]tip_allowedPointer to variable to write value to. Value is ta_c_b_undefined if value is not set in trx_data.
Return values
ta_c_rc_okValue written to tip_allowed.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumenttip_allowed is null-pointer.

◆ ta_transaction_data_get_trans_ref()

ta_e_result_code_t ta_transaction_data_get_trans_ref ( ta_object_t  trx_data,
ta_object_t trans_ref 
)

Transaction reference defined by the terminal.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]trans_refPointer to variable to write object instance to. Object instance is of type integer and is not retained. Object instance is ta_invalid_object if value is not set in trx_data.
Return values
ta_c_rc_okObject instance written to trans_ref.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumenttrans_ref is null-pointer.

◆ ta_transaction_data_get_trans_seq()

ta_e_result_code_t ta_transaction_data_get_trans_seq ( ta_object_t  trx_data,
ta_object_t trans_seq 
)

Transaction sequence number defined by the terminal.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]trans_seqPointer to variable to write object instance to. Object instance is of type integer and is not retained. Object instance is ta_invalid_object if value is not set in trx_data.
Return values
ta_c_rc_okObject instance written to trans_seq.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumenttrans_seq is null-pointer.

◆ ta_transaction_data_get_trm_trans_ref()

ta_e_result_code_t ta_transaction_data_get_trm_trans_ref ( ta_object_t  trx_data,
ta_object_t trm_trans_ref 
)

Transaction reference from the terminal.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]trm_trans_refPointer to variable to write object instance to. Object instance is of type string and is not retained. Object instance is ta_invalid_object if value is not set in trx_data.
Return values
ta_c_rc_okObject instance written to trm_trans_ref.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumenttrm_trans_ref is null-pointer.

◆ ta_transaction_data_get_trx_original_date()

ta_e_result_code_t ta_transaction_data_get_trx_original_date ( ta_object_t  trx_data,
ta_object_t trx_original_date 
)

Timestamp of the original transaction.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]trx_original_datePointer to variable to write object instance to. Object instance is of type timedate and is not retained. Object instance is ta_invalid_object if value is not set in trx_data.
Return values
ta_c_rc_okObject instance written to trx_original_date.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumenttrx_original_date is null-pointer.

◆ ta_transaction_data_set_acq_id()

ta_e_result_code_t ta_transaction_data_set_acq_id ( ta_object_t  trx_data,
ta_object_t  acq_id 
)

Set acquirer identifier. Uniquely identifies the acquirer.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]acq_idObject instance to set. Object instance can be ta_invalid_object to clear the value in trx_data. If object instance is not ta_invalid_object is has to be of type integer.
Return values
ta_c_rc_okObject instance assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentacq_id is not ta_invalid_object and is not of type integer.

◆ ta_transaction_data_set_acq_trans_ref()

ta_e_result_code_t ta_transaction_data_set_acq_trans_ref ( ta_object_t  trx_data,
ta_object_t  acq_trans_ref 
)

Set transaction reference from the acquirer.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]acq_trans_refObject instance to set. Object instance can be ta_invalid_object to clear the value in trx_data. If object instance is not ta_invalid_object is has to be of type string.
Return values
ta_c_rc_okObject instance assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentacq_trans_ref is not ta_invalid_object and is not of type string.

◆ ta_transaction_data_set_card_ref()

ta_e_result_code_t ta_transaction_data_set_card_ref ( ta_object_t  trx_data,
ta_object_t  card_ref 
)

Set petrol: Reference from the card.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]card_refObject instance to set. Object instance can be ta_invalid_object to clear the value in trx_data. If object instance is not ta_invalid_object is has to be of type string.
Return values
ta_c_rc_okObject instance assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentcard_ref is not ta_invalid_object and is not of type string.

◆ ta_transaction_data_set_dcc_allowed()

ta_e_result_code_t ta_transaction_data_set_dcc_allowed ( ta_object_t  trx_data,
ta_e_boolean_t  dcc_allowed 
)

Set allows the EFT Terminal to enable DCC function.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]dcc_allowedValue to set. Value can be ta_c_b_undefined to clear the value in trx_data.
Return values
ta_c_rc_okValue assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentdcc_allowed is null-pointer.

◆ ta_transaction_data_set_ecr_seq_counter()

ta_e_result_code_t ta_transaction_data_set_ecr_seq_counter ( ta_object_t  trx_data,
ta_object_t  ecr_seq_counter 
)

Set ECR sequence counter.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]ecr_seq_counterObject instance to set. Object instance can be ta_invalid_object to clear the value in trx_data. If object instance is not ta_invalid_object is has to be of type integer.
Return values
ta_c_rc_okObject instance assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentecr_seq_counter is not ta_invalid_object and is not of type integer.

◆ ta_transaction_data_set_language()

ta_e_result_code_t ta_transaction_data_set_language ( ta_object_t  trx_data,
ta_object_t  language 
)

Set petrol, Unattended: Language.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]languageObject instance to set. Object instance can be ta_invalid_object to clear the value in trx_data. If object instance is not ta_invalid_object is has to be of type string.
Return values
ta_c_rc_okObject instance assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentlanguage is not ta_invalid_object and is not of type string.

◆ ta_transaction_data_set_multi_currency_flag()

ta_e_result_code_t ta_transaction_data_set_multi_currency_flag ( ta_object_t  trx_data,
ta_e_boolean_t  multi_currency_flag 
)

Set Indicates if the transaction uses multiple currencies.

Optional: Indicates that the transaction uses multiple currencies. Specifications: Banking, Gastro, Hospitality,AustrianUseCases.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]multi_currency_flagValue to set. Value can be ta_c_b_undefined to clear the value in trx_data.
Return values
ta_c_rc_okValue assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentmulti_currency_flag is null-pointer.

◆ ta_transaction_data_set_ngv_clearing_delay()

ta_e_result_code_t ta_transaction_data_set_ngv_clearing_delay ( ta_object_t  trx_data,
int  ngv_clearing_delay 
)

Set defines the clearing delay of the PurchaseNGV transaction.

Available if AustrianUseCases guide is enabled.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]ngv_clearing_delayValue to set. Value can be 0 to clear the value in trx_data.
Return values
ta_c_rc_okValue assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentngv_clearing_delay is null-pointer.
ta_c_rc_invalid_argumentngv_clearing_delay is less than 0.

◆ ta_transaction_data_set_ngv_mode()

ta_e_result_code_t ta_transaction_data_set_ngv_mode ( ta_object_t  trx_data,
ta_e_ngv_mode_t  ngv_mode 
)

Set defines if NGV usage is mandatory or optional if card supports it.

Available if AustrianUseCases guide is enabled.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]ngv_modeValue to set. Value can be ta_c_ngvm_undefined to clear the value in trx_data.
Return values
ta_c_rc_okValue assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentngv_mode is null-pointer.

◆ ta_transaction_data_set_partial_approval_allowed()

ta_e_result_code_t ta_transaction_data_set_partial_approval_allowed ( ta_object_t  trx_data,
ta_e_boolean_t  partial_approval_allowed 
)

Set partial approval is allowed.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]partial_approval_allowedValue to set. Value can be ta_c_b_undefined to clear the value in trx_data.
Return values
ta_c_rc_okValue assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentpartial_approval_allowed is null-pointer.

◆ ta_transaction_data_set_phone_auth_code()

ta_e_result_code_t ta_transaction_data_set_phone_auth_code ( ta_object_t  trx_data,
ta_object_t  phone_auth_code 
)

Set phone authorization code.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]phone_auth_codeObject instance to set. Object instance can be ta_invalid_object to clear the value in trx_data. If object instance is not ta_invalid_object is has to be of type string.
Return values
ta_c_rc_okObject instance assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentphone_auth_code is not ta_invalid_object and is not of type string.

◆ ta_transaction_data_set_saferpay_alias()

ta_e_result_code_t ta_transaction_data_set_saferpay_alias ( ta_object_t  trx_data,
ta_object_t  saferpay_alias 
)

Set saferpay alias.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]saferpay_aliasObject instance to set. Object instance can be ta_invalid_object to clear the value in trx_data. If object instance is not ta_invalid_object is has to be of type string.
Return values
ta_c_rc_okObject instance assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentsaferpay_alias is not ta_invalid_object and is not of type string.

◆ ta_transaction_data_set_saferpay_recurring()

ta_e_result_code_t ta_transaction_data_set_saferpay_recurring ( ta_object_t  trx_data,
ta_e_boolean_t  saferpay_recurring 
)

Set saferpay recurring enabled.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]saferpay_recurringValue to set. Value can be ta_c_b_undefined to clear the value in trx_data.
Return values
ta_c_rc_okValue assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentsaferpay_recurring is null-pointer.

◆ ta_transaction_data_set_six_trx_ref_num()

ta_e_result_code_t ta_transaction_data_set_six_trx_ref_num ( ta_object_t  trx_data,
ta_object_t  six_trx_ref_num 
)

Set SIX Transaction Reference Number.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]six_trx_ref_numObject instance to set. Object instance can be ta_invalid_object to clear the value in trx_data. If object instance is not ta_invalid_object is has to be of type string.
Return values
ta_c_rc_okObject instance assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumentsix_trx_ref_num is not ta_invalid_object and is not of type string.

◆ ta_transaction_data_set_tip_allowed()

ta_e_result_code_t ta_transaction_data_set_tip_allowed ( ta_object_t  trx_data,
ta_e_boolean_t  tip_allowed 
)

Set tip is allowed for purchase transactions.

This parameter is only used if ta_c_g_gastro is enabled.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]tip_allowedValue to set. Value can be ta_c_b_undefined to clear the value in trx_data.
Return values
ta_c_rc_okValue assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumenttip_allowed is null-pointer.

◆ ta_transaction_data_set_trans_ref()

ta_e_result_code_t ta_transaction_data_set_trans_ref ( ta_object_t  trx_data,
ta_object_t  trans_ref 
)

Set transaction reference defined by the terminal.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]trans_refObject instance to set. Object instance can be ta_invalid_object to clear the value in trx_data. If object instance is not ta_invalid_object is has to be of type integer.
Return values
ta_c_rc_okObject instance assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumenttrans_ref is not ta_invalid_object and is not of type integer.

◆ ta_transaction_data_set_trans_seq()

ta_e_result_code_t ta_transaction_data_set_trans_seq ( ta_object_t  trx_data,
ta_object_t  trans_seq 
)

Set transaction sequence number defined by the terminal.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]trans_seqObject instance to set. Object instance can be ta_invalid_object to clear the value in trx_data. If object instance is not ta_invalid_object is has to be of type integer.
Return values
ta_c_rc_okObject instance assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumenttrans_seq is not ta_invalid_object and is not of type integer.

◆ ta_transaction_data_set_trm_trans_ref()

ta_e_result_code_t ta_transaction_data_set_trm_trans_ref ( ta_object_t  trx_data,
ta_object_t  trm_trans_ref 
)

Set transaction reference from the terminal.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]trm_trans_refObject instance to set. Object instance can be ta_invalid_object to clear the value in trx_data. If object instance is not ta_invalid_object is has to be of type string.
Return values
ta_c_rc_okObject instance assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumenttrm_trans_ref is not ta_invalid_object and is not of type string.

◆ ta_transaction_data_set_trx_original_date()

ta_e_result_code_t ta_transaction_data_set_trx_original_date ( ta_object_t  trx_data,
ta_object_t  trx_original_date 
)

Set timestamp of the original transaction.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]trx_original_dateObject instance to set. Object instance can be ta_invalid_object to clear the value in trx_data. If object instance is not ta_invalid_object is has to be of type timedate.
Return values
ta_c_rc_okObject instance assigned to trx_data.
ta_c_rc_invalid_argumenttrx_data is ta_invalid_object.
ta_c_rc_invalid_argumenttrx_data is not of type transaction_data.
ta_c_rc_invalid_argumenttrx_original_date is not ta_invalid_object and is not of type timedate.