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_cvc2 (ta_object_t trx_data, ta_object_t *cvc2)
 Card verification code 2. More...
 
ta_e_result_code_t ta_transaction_data_set_cvc2 (ta_object_t trx_data, ta_object_t cvc2)
 Set card verification code 2. More...
 
ta_e_result_code_t ta_transaction_data_get_app_expiration_date (ta_object_t trx_data, ta_object_t *app_expiration_date)
 Application expiration date. More...
 
ta_e_result_code_t ta_transaction_data_set_app_expiration_date (ta_object_t trx_data, ta_object_t app_expiration_date)
 Set application expiration date. 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...
 
ta_e_result_code_t ta_transaction_data_get_installment_allowed (ta_object_t trx_data, ta_e_boolean_t *installment_allowed)
 Indicates if installment shall be allowed for a transaction. More...
 
ta_e_result_code_t ta_transaction_data_set_installment_allowed (ta_object_t trx_data, ta_e_boolean_t installment_allowed)
 Set application expiration date. More...
 
ta_e_result_code_t ta_transaction_data_get_deferred_auth_ind (ta_object_t trx_data, ta_e_boolean_t *deferred_auth_ind)
 Indicates that the transaction shall be performed using deffered authorisation. More...
 
ta_e_result_code_t ta_transaction_data_set_deferred_auth_ind (ta_object_t trx_data, ta_e_boolean_t installment_allowed)
 Set indicates that the transaction shall be performed using deffered authorisation. More...
 
ta_e_result_code_t ta_transaction_data_get_transaction_reason (ta_object_t trx_data, ta_e_transaction_reason_t *transaction_reason)
 Set the transaction reason to setup credential on file. More...
 
ta_e_result_code_t ta_transaction_data_set_transaction_reason (ta_object_t trx_data, ta_e_transaction_reason_t transaction_reason)
 Set the transaction reason to setup credential on file. More...
 
ta_e_result_code_t ta_transaction_data_get_sub_transactions (ta_object_t trx_data, ta_object_t *sub_transactions)
 Sub transactions. More...
 
ta_e_result_code_t ta_transaction_data_set_sub_transactions (ta_object_t trx_data, ta_object_t sub_transactions)
 Set sub transactions. 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_app_expiration_date()

ta_e_result_code_t ta_transaction_data_get_app_expiration_date ( ta_object_t  trx_data,
ta_object_t app_expiration_date 
)

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

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]app_expiration_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 app_expiration_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_argumentapp_expiration_date 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_cvc2()

ta_e_result_code_t ta_transaction_data_get_cvc2 ( ta_object_t  trx_data,
ta_object_t 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

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]cvc2Pointer 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_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_argumentcvc2 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_deferred_auth_ind()

ta_e_result_code_t ta_transaction_data_get_deferred_auth_ind ( ta_object_t  trx_data,
ta_e_boolean_t deferred_auth_ind 
)

Indicates that the transaction shall be performed using deffered authorisation.

The following values are valid: true: Deferred authorisation applies false: Standard authorisation scheme (default)

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]deferred_auth_indPointer to variable to write value to.
Return values
ta_c_rc_okObject instance written to deferred_auth_ind.
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_argumentdeferred_auth_ind 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_installment_allowed()

ta_e_result_code_t ta_transaction_data_get_installment_allowed ( ta_object_t  trx_data,
ta_e_boolean_t installment_allowed 
)

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

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]installment_allowedPointer to variable to write value to.
Return values
ta_c_rc_okObject instance written to installment_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_argumentinstallment_allowed 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_sub_transactions()

ta_e_result_code_t ta_transaction_data_get_sub_transactions ( ta_object_t  trx_data,
ta_object_t sub_transactions 
)

Sub transactions.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]sub_transactionsPointer to variable to write object instance to. Object instance is of type list with elements of type sub_transaction. Object instance 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 sub_transactions.
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_argumentsub_transactions 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_transaction_reason()

ta_e_result_code_t ta_transaction_data_get_transaction_reason ( ta_object_t  trx_data,
ta_e_transaction_reason_t transaction_reason 
)

Set the transaction reason to setup credential on file.

Available if AdvancedRetail guide is enabled.

Parameters
[in]trx_dataObject instance of type transaction_data.
[out]transaction_reasonPointer 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 transaction_reason.
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_argumenttransaction_reason 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_app_expiration_date()

ta_e_result_code_t ta_transaction_data_set_app_expiration_date ( ta_object_t  trx_data,
ta_object_t  app_expiration_date 
)

Set 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

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]app_expiration_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_argumentapp_expiration_date is not ta_invalid_object and is not of type timedate.

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

ta_e_result_code_t ta_transaction_data_set_cvc2 ( ta_object_t  trx_data,
ta_object_t  cvc2 
)

Set 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

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]cvc2Object 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_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_argumentcvc2 is null-pointer.
ta_c_rc_invalid_argumentcvc2 is less than 0.

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

ta_e_result_code_t ta_transaction_data_set_deferred_auth_ind ( ta_object_t  trx_data,
ta_e_boolean_t  installment_allowed 
)

Set indicates that the transaction shall be performed using deffered authorisation.

The following values are valid: true: Deferred authorisation applies false: Standard authorisation scheme (default)

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]deferred_auth_indValue to set.
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_argumentapp_expiration_date is not ta_invalid_object and is not of type timedate.

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

ta_e_result_code_t ta_transaction_data_set_installment_allowed ( ta_object_t  trx_data,
ta_e_boolean_t  installment_allowed 
)

Set 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

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]installment_allowedValue to set.
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_argumentapp_expiration_date is not ta_invalid_object and is not of type timedate.

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

ta_e_result_code_t ta_transaction_data_set_sub_transactions ( ta_object_t  trx_data,
ta_object_t  sub_transactions 
)

Set sub transactions.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]sub_transactionsObject 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 list with elements of type sub_transaction.
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_argumentsub_transactions is not ta_invalid_object and is not of type timedate.

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

ta_e_result_code_t ta_transaction_data_set_transaction_reason ( ta_object_t  trx_data,
ta_e_transaction_reason_t  transaction_reason 
)

Set the transaction reason to setup credential on file.

Available if AdvancedRetail guide is enabled.

Parameters
[in]trx_dataObject instance of type transaction_data.
[in]transaction_reasonValue 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_argumenttransaction_reason is null-pointer.

◆ 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.