TIM SDK
TIM API C
transaction_information.h File Reference

Description

Transaction information.

Object type transaction_information.

Functions

ta_e_result_code_t ta_transaction_information_get_pos_entry_mode (ta_object_t trx_info, ta_e_pos_entry_mode_t *pos_entry_mode)
 According to EMV definition. More...
 
ta_e_result_code_t ta_transaction_information_get_cvm (ta_object_t trx_info, ta_e_cvm_t *cvm)
 Cardholder verification method. More...
 
ta_e_result_code_t ta_transaction_information_get_merchant_action (ta_object_t trx_info, ta_e_merchant_action_t *merchant_action)
 Feedback to know which merchant action has to be performed. More...
 
ta_e_result_code_t ta_transaction_information_get_auth_code (ta_object_t trx_info, ta_object_t *auth_code)
 Authorization code received from the acquirer. More...
 
ta_e_result_code_t ta_transaction_information_get_time_stamp (ta_object_t trx_info, ta_object_t *time_stamp)
 Local time of the transaction. More...
 
ta_e_result_code_t ta_transaction_information_get_trans_ref (ta_object_t trx_info, ta_object_t *trans_ref)
 Transaction reference defined by the terminal. More...
 
ta_e_result_code_t ta_transaction_information_get_trans_seq (ta_object_t trx_info, ta_object_t *trans_seq)
 Transaction sequence number defined by the terminal. More...
 
ta_e_result_code_t ta_transaction_information_get_acq_id (ta_object_t trx_info, int64_t *acq)
 TransactionAcquirer identifier. More...
 
ta_e_result_code_t ta_transaction_information_get_acq (ta_object_t trx_info, int64_t *acq)
 
ta_e_result_code_t ta_transaction_information_get_signature_information (ta_object_t trx_info, ta_object_t *signature_information)
 Signature captured by EFT Terminal if present. More...
 
ta_e_result_code_t ta_transaction_information_get_trm_trans_ref (ta_object_t trx_info, ta_object_t *trm_trans_ref)
 Transaction reference from the terminal. More...
 
ta_e_result_code_t ta_transaction_information_get_acq_trans_ref (ta_object_t trx_info, ta_object_t *acq_trans_ref)
 Transaction reference from the acquirer. More...
 
ta_e_result_code_t ta_transaction_information_get_six_trx_ref_num (ta_object_t trx_info, ta_object_t *six_trx_ref_num)
 SIX Transaction Reference. More...
 
ta_e_result_code_t ta_transaction_information_get_cardholder_name (ta_object_t trx_info, ta_object_t *cardholder_name)
 Cardholder name. More...
 
ta_e_result_code_t ta_transaction_information_get_client_identifier (ta_object_t trx_info, ta_object_t *client_identifier)
 Cardholder ID- or Passport number. More...
 
ta_e_result_code_t ta_transaction_information_get_account_number (ta_object_t trx_info, ta_object_t *account_number)
 Account number of the card used. More...
 
ta_e_result_code_t ta_transaction_information_get_person_oid (ta_object_t trx_info, ta_object_t *person_oid)
 Person OID. More...
 
ta_e_result_code_t ta_transaction_information_get_card_id (ta_object_t trx_info, ta_object_t *card_id)
 Card ID. More...
 
ta_e_result_code_t ta_transaction_information_get_ngv_used_flag (ta_object_t trx_info, ta_e_boolean_t *ngv_used_flag)
 Indicates if a transaction was performed as non guaranteed payment (NGV). More...
 
ta_e_result_code_t ta_transaction_information_get_omnichannel_payment_id (ta_object_t trx_info, ta_object_t *omnichannel_payment_id)
 Omnichannel payment / transaction identifier. More...
 
ta_e_result_code_t ta_transaction_information_get_scheme_trx_id (ta_object_t trx_info, ta_object_t *scheme_trx_id)
 Used for "Stored Credential" and the "Merchant-Initiated-Transaction (MIT) frameworks. More...
 
ta_e_result_code_t ta_transaction_information_get_age_check_result (ta_object_t trx_info, ta_e_age_check_result_t *age_check_result)
 Get Age Check Result. More...
 

Function Documentation

◆ ta_transaction_information_get_account_number()

ta_e_result_code_t ta_transaction_information_get_account_number ( ta_object_t  trx_info,
ta_object_t account_number 
)

Account number of the card used.

Optional: Mandatory if requested by acquirer. Specifications: Banking, AustrianUseCases.

Conditional for (can be ta_object_invalid):

  • ta_c_tt_authorize_credit
  • ta_c_tt_authorize_deposit
  • ta_c_tt_cash_advance
  • ta_c_tt_combined
  • ta_c_tt_credit
  • ta_c_tt_giro
  • ta_c_tt_purchase
  • ta_c_tt_reversal

Otherwise Forbidden (always ta_object_invalid)

Parameters
[in]trx_infoObject instance of type transaction_information.
[out]account_numberPointer to variable to write object instance to. Object instance is of type string and is not retained. Object instance is ta_object_invalid if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to account_number.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentaccount_number is null-pointer.

◆ ta_transaction_information_get_acq()

ta_e_result_code_t ta_transaction_information_get_acq ( ta_object_t  trx_info,
int64_t *  acq 
)
Deprecated:
Use ta_transaction_information_get_acq_id.

◆ ta_transaction_information_get_acq_id()

ta_e_result_code_t ta_transaction_information_get_acq_id ( ta_object_t  trx_info,
int64_t *  acq 
)

TransactionAcquirer identifier.

Conditional for (can be ta_object_invalid):

  • ta_c_tt_activate_card
  • ta_c_tt_authorize_credit
  • ta_c_tt_authorize_deposit
  • ta_c_tt_cash_advance
  • ta_c_tt_combined
  • ta_c_tt_credit
  • ta_c_tt_debt_recovery
  • ta_c_tt_finalize_purchase
  • ta_c_tt_funding
  • ta_c_tt_giro
  • ta_c_tt_load
  • ta_c_tt_pre_authorization
  • ta_c_tt_purchase_forced_acceptance
  • ta_c_tt_purchase_mail_ordered
  • ta_c_tt_purchase_phone_authorized
  • ta_c_tt_purchase_with_cashback
  • ta_c_tt_purchase
  • ta_c_tt_refunding
  • ta_c_tt_reversal
  • ta_c_tt_unload

Forbidden (always ta_object_invalid):

  • ta_c_tt_account_verification
  • ta_c_tt_adjust_reservation
  • ta_c_tt_cancel_reservation
  • ta_c_tt_collect_points
  • ta_c_tt_load_voucher
  • ta_c_tt_purchase_reservation_phone_authorized
  • ta_c_tt_purchase_reservation
  • ta_c_tt_reservation
Parameters
[in]trx_infoValue written of type transaction_information.
[out]acqPointer to variable to write value to. Value is 0 if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to acq.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentacq is null-pointer.

◆ ta_transaction_information_get_acq_trans_ref()

ta_e_result_code_t ta_transaction_information_get_acq_trans_ref ( ta_object_t  trx_info,
ta_object_t acq_trans_ref 
)

Transaction reference from the acquirer.

Mandatory for:

  • ta_c_tt_adjust_reservation
  • ta_c_tt_cancel_reservation
  • ta_c_tt_purchase_reservation_phone_authorized
  • ta_c_tt_purchase_reservation
  • ta_c_tt_reservation

Conditional for (can be ta_object_invalid):

  • ta_c_tt_activate_card
  • ta_c_tt_authorize_credit
  • ta_c_tt_authorize_deposit
  • ta_c_tt_cash_advance
  • ta_c_tt_collect_points
  • ta_c_tt_combined
  • ta_c_tt_credit
  • ta_c_tt_debt_recovery
  • ta_c_tt_finalize_purchase
  • ta_c_tt_funding
  • ta_c_tt_giro
  • ta_c_tt_load_voucher
  • ta_c_tt_load
  • ta_c_tt_pre_authorization
  • ta_c_tt_purchase_forced_acceptance
  • ta_c_tt_purchase_mail_ordered
  • ta_c_tt_purchase_phone_authorized
  • ta_c_tt_purchase_phone_ordered
  • ta_c_tt_purchase_with_cashback
  • ta_c_tt_purchase
  • ta_c_tt_refunding
  • ta_c_tt_unload

Forbidden (always ta_object_invalid):

  • ta_c_tt_account_verification
  • ta_c_tt_reversal
Parameters
[in]trx_infoObject instance of type transaction_information.
[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_object_invalid if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to acq_trans_ref.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentacq_trans_ref is null-pointer.

◆ ta_transaction_information_get_age_check_result()

ta_e_result_code_t ta_transaction_information_get_age_check_result ( ta_object_t  trx_info,
ta_e_age_check_result_t age_check_result 
)

Get Age Check Result.

Optional: Mandatory if available to terminal. Specifications: valueAddedServices.

Parameters
[in]trx_infoObject instance of type transaction_information.
[out]age_check_resultPointer to variable to write value to.
Return values
ta_c_rc_okObject instance written to card_id.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentage_check_result is null-pointer.

◆ ta_transaction_information_get_auth_code()

ta_e_result_code_t ta_transaction_information_get_auth_code ( ta_object_t  trx_info,
ta_object_t auth_code 
)

Authorization code received from the acquirer.

Conditional for (can be ta_object_invalid):

  • ta_c_tt_activate_card
  • ta_c_tt_adjust_reservation
  • ta_c_tt_authorize_credit
  • ta_c_tt_authorize_deposit
  • ta_c_tt_cash_advance
  • ta_c_tt_collect_points
  • ta_c_tt_combined
  • ta_c_tt_credit
  • ta_c_tt_debt_recovery
  • ta_c_tt_finalize_purchase
  • ta_c_tt_funding
  • ta_c_tt_giro
  • ta_c_tt_load_voucher
  • ta_c_tt_load
  • ta_c_tt_pre_authorization
  • ta_c_tt_purchase_forced_acceptance
  • ta_c_tt_purchase_mail_ordered
  • ta_c_tt_purchase_phone_authorized
  • ta_c_tt_purchase_phone_ordered
  • ta_c_tt_purchase_reservation_phone_authorized
  • ta_c_tt_purchase_reservation
  • ta_c_tt_purchase_with_cashback
  • ta_c_tt_purchase
  • ta_c_tt_refunding
  • ta_c_tt_reservation
  • ta_c_tt_unload

Forbidden (always ta_object_invalid):

  • ta_c_tt_account_verification
  • ta_c_tt_cancel_reservation
  • ta_c_tt_reversal
Parameters
[in]trx_infoObject instance of type transaction_information.
[out]auth_codePointer to variable to write object instance to. Object instance is of type string and is not retained. Object instance is ta_object_invalid if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to auth_code.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentauth_code is null-pointer.

◆ ta_transaction_information_get_card_id()

ta_e_result_code_t ta_transaction_information_get_card_id ( ta_object_t  trx_info,
ta_object_t card_id 
)

Card ID.

Optional: Mandatory if requested by acquirer. Specifications: Banking, AustrianUseCases.

Parameters
[in]trx_infoObject instance of type transaction_information.
[out]card_idPointer to variable to write object instance to. Object instance is of type integer and is not retained. Object instance is ta_object_invalid if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to card_id.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentcard_id is null-pointer.

◆ ta_transaction_information_get_cardholder_name()

ta_e_result_code_t ta_transaction_information_get_cardholder_name ( ta_object_t  trx_info,
ta_object_t cardholder_name 
)

Cardholder name.

Deprecated:
Use ta_card_data_get_cardholder instead (on card_data object returned by ta_transaction_response_get_card_data).

Optional: Mandatory if requested by acquirer. Specifications: Banking, AustrianUseCases.

Parameters
[in]trx_infoObject instance of type transaction_information.
[out]cardholder_namePointer to variable to write object instance to. Object instance is of type string and is not retained. Object instance is ta_object_invalid if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to cardholder_name.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentcardholder_name is null-pointer.

◆ ta_transaction_information_get_client_identifier()

ta_e_result_code_t ta_transaction_information_get_client_identifier ( ta_object_t  trx_info,
ta_object_t client_identifier 
)

Cardholder ID- or Passport number.

Optional: Mandatory if requested by acquirer. Specifications: Banking, AustrianUseCases.

Conditional for (can be ta_object_invalid):

  • ta_c_tt_authorize_credit
  • ta_c_tt_authorize_deposit
  • ta_c_tt_cash_advance
  • ta_c_tt_combined
  • ta_c_tt_credit
  • ta_c_tt_giro
  • ta_c_tt_purchase
  • ta_c_tt_reversal

Otherwise Forbidden (always ta_object_invalid)

Parameters
[in]trx_infoObject instance of type transaction_information.
[out]client_identifierPointer to variable to write object instance to. Object instance is of type string and is not retained. Object instance is ta_object_invalid if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to client_identifier.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentclient_identifier is null-pointer.

◆ ta_transaction_information_get_cvm()

ta_e_result_code_t ta_transaction_information_get_cvm ( ta_object_t  trx_info,
ta_e_cvm_t cvm 
)

Cardholder verification method.

Conditional for (can be ta_object_invalid):

  • ta_c_tt_activate_card
  • ta_c_tt_adjust_reservation
  • ta_c_tt_authorize_deposit
  • ta_c_tt_cancel_reservation
  • ta_c_tt_cash_advance
  • ta_c_tt_collect_points
  • ta_c_tt_combined
  • ta_c_tt_debt_recovery
  • ta_c_tt_finalize_purchase
  • ta_c_tt_funding
  • ta_c_tt_giro
  • ta_c_tt_load_voucher
  • ta_c_tt_pre_authorization
  • ta_c_tt_purchase_forced_acceptance
  • ta_c_tt_purchase_mail_ordered
  • ta_c_tt_purchase_phone_authorized
  • ta_c_tt_purchase_phone_ordered
  • ta_c_tt_purchase_reservation_phone_authorized
  • ta_c_tt_purchase_reservation
  • ta_c_tt_purchase_with_cashback
  • ta_c_tt_purchase
  • ta_c_tt_reservation
  • ta_c_tt_unload

Forbidden (always ta_object_invalid):

  • ta_c_tt_account_verification
  • ta_c_tt_authorize_credit
  • ta_c_tt_credit
  • ta_c_tt_load
  • ta_c_tt_refunding
  • ta_c_tt_reversal
Parameters
[in]trx_infoValue written of type transaction_information.
[out]cvmPointer to variable to write value to. Value is ta_c_cvm_undefined if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to cvm.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentcvm is null-pointer.

◆ ta_transaction_information_get_merchant_action()

ta_e_result_code_t ta_transaction_information_get_merchant_action ( ta_object_t  trx_info,
ta_e_merchant_action_t merchant_action 
)

Feedback to know which merchant action has to be performed.

Mandatory for:

  • ta_c_tt_activate_card
  • ta_c_tt_adjust_reservation
  • ta_c_tt_authorize_credit
  • ta_c_tt_authorize_deposit
  • ta_c_tt_cancel_reservation
  • ta_c_tt_cash_advance
  • ta_c_tt_collect_points
  • ta_c_tt_combined
  • ta_c_tt_credit
  • ta_c_tt_debt_recovery
  • ta_c_tt_finalize_purchase
  • ta_c_tt_funding
  • ta_c_tt_giro
  • ta_c_tt_load_voucher
  • ta_c_tt_load
  • ta_c_tt_pre_authorization
  • ta_c_tt_purchase_forced_acceptance
  • ta_c_tt_purchase_mail_ordered
  • ta_c_tt_purchase_phone_authorized
  • ta_c_tt_purchase_phone_ordered
  • ta_c_tt_purchase_reservation_phone_authorized
  • ta_c_tt_purchase_reservation
  • ta_c_tt_purchase_with_cashback
  • ta_c_tt_purchase
  • ta_c_tt_refunding
  • ta_c_tt_reservation
  • ta_c_tt_reversal
  • ta_c_tt_unload

Forbidden (always ta_object_invalid):

  • ta_c_tt_account_verification
Parameters
[in]trx_infoObject instance of type transaction_information.
[out]merchant_actionPointer to variable to write value to. Value is ta_c_ma_undefined if value is not set in trx_info.
Return values
ta_c_rc_okValue written written to merchant_action.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentmerchant_action is null-pointer.

◆ ta_transaction_information_get_ngv_used_flag()

ta_e_result_code_t ta_transaction_information_get_ngv_used_flag ( ta_object_t  trx_info,
ta_e_boolean_t ngv_used_flag 
)

Indicates if a transaction was performed as non guaranteed payment (NGV).

Available if AustrianUseCases is enabled.

Parameters
[in]trx_infoObject instance of type transaction_information.
[out]ngv_used_flagPointer to variable to write value to. Value is ta_c_b_undefined if value is not set in trx_info.
Return values
ta_c_rc_okValue written to ngv_used_flag.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentngv_used_flag is null-pointer.

◆ ta_transaction_information_get_omnichannel_payment_id()

ta_e_result_code_t ta_transaction_information_get_omnichannel_payment_id ( ta_object_t  trx_info,
ta_object_t omnichannel_payment_id 
)

Omnichannel payment / transaction identifier.

Optional: Mandatory if available to terminal. Specifications: retail, banking, austrianUseCases.

Parameters
[in]trx_infoObject instance of type transaction_information.
[out]omnichannel_payment_idPointer to variable to write object instance to. Object instance is of type string and is not retained. Object instance is ta_object_invalid if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to card_id.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentomnichannel_payment_id is null-pointer.

◆ ta_transaction_information_get_person_oid()

ta_e_result_code_t ta_transaction_information_get_person_oid ( ta_object_t  trx_info,
ta_object_t person_oid 
)

Person OID.

Optional: Mandatory if requested by acquirer. Specifications: Banking, AustrianUseCases.

Conditional for (can be ta_object_invalid):

  • ta_c_tt_authorize_credit
  • ta_c_tt_authorize_deposit
  • ta_c_tt_cash_advance
  • ta_c_tt_combined
  • ta_c_tt_credit
  • ta_c_tt_giro
  • ta_c_tt_purchase
  • ta_c_tt_reversal

Otherwise Forbidden (always ta_object_invalid)

Parameters
[in]trx_infoObject instance of type transaction_information.
[out]person_oidPointer to variable to write object instance to. Object instance is of type integer and is not retained. Object instance is ta_object_invalid if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to person_oid.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentperson_oid is null-pointer.

◆ ta_transaction_information_get_pos_entry_mode()

ta_e_result_code_t ta_transaction_information_get_pos_entry_mode ( ta_object_t  trx_info,
ta_e_pos_entry_mode_t pos_entry_mode 
)

According to EMV definition.

Mandatory for:

  • ta_c_tt_activate_card
  • ta_c_tt_authorize_credit
  • ta_c_tt_authorize_deposit
  • ta_c_tt_cash_advance
  • ta_c_tt_collect_points
  • ta_c_tt_combined
  • ta_c_tt_credit
  • ta_c_tt_debt_recovery
  • ta_c_tt_funding
  • ta_c_tt_giro
  • ta_c_tt_load
  • ta_c_tt_purchase_forced_acceptance
  • ta_c_tt_purchase_mail_ordered
  • ta_c_tt_purchase_phone_authorized
  • ta_c_tt_purchase_phone_ordered
  • ta_c_tt_purchase
  • ta_c_tt_refunding
  • ta_c_tt_unload

Conditional for (can be ta_object_invalid):

  • ta_c_tt_adjust_reservation
  • ta_c_tt_finalize_purchase
  • ta_c_tt_load_voucher
  • ta_c_tt_pre_authorization
  • ta_c_tt_purchase_reservation_phone_authorized
  • ta_c_tt_purchase_reservation
  • ta_c_tt_purchase_with_cashback
  • ta_c_tt_reservation

Forbidden (always ta_object_invalid):

  • ta_c_tt_account_verification
  • ta_c_tt_cancel_reservation
  • ta_c_tt_reversal
Parameters
[in]trx_infoObject instance of type transaction_information.
[out]pos_entry_modePointer to variable to write value to. Value is ta_c_pem_undefined if value is not set in trx_info.
Return values
ta_c_rc_okValue written to pos_entry_mode.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentpos_entry_mode is null-pointer.

◆ ta_transaction_information_get_scheme_trx_id()

ta_e_result_code_t ta_transaction_information_get_scheme_trx_id ( ta_object_t  trx_info,
ta_object_t scheme_trx_id 
)

Used for "Stored Credential" and the "Merchant-Initiated-Transaction (MIT) frameworks.

Card scheme data element that links original authorisation requests to subsequent messages.

Used also for Initial recurring and omnichannel use cases.

Optional: Mandatory if available to terminal. Specifications: retail, banking, austrianUseCases.

Parameters
[in]trx_infoObject instance of type transaction_information.
[out]scheme_trx_idPointer to variable to write object instance to. Object instance is of type integer and is not retained. Object instance is ta_object_invalid if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to card_id.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentscheme_trx_id is null-pointer.

◆ ta_transaction_information_get_signature_information()

ta_e_result_code_t ta_transaction_information_get_signature_information ( ta_object_t  trx_info,
ta_object_t signature_information 
)

Signature captured by EFT Terminal if present.

Mandatory for:

  • ta_c_tt_load_voucher

Conditional for (can be ta_object_invalid):

  • ta_c_tt_activate_card
  • ta_c_tt_adjust_reservation
  • ta_c_tt_authorize_deposit
  • ta_c_tt_cancel_reservation
  • ta_c_tt_cash_advance
  • ta_c_tt_combined
  • ta_c_tt_credit
  • ta_c_tt_debt_recovery
  • ta_c_tt_finalize_purchase
  • ta_c_tt_funding
  • ta_c_tt_giro
  • ta_c_tt_load
  • ta_c_tt_pre_authorization
  • ta_c_tt_purchase_forced_acceptance
  • ta_c_tt_purchase_mail_ordered
  • ta_c_tt_purchase_phone_authorized
  • ta_c_tt_purchase_phone_ordered
  • ta_c_tt_purchase_phone_ordered
  • ta_c_tt_purchase_reservation_phone_authorized
  • ta_c_tt_purchase_reservation
  • ta_c_tt_purchase_with_cashback
  • ta_c_tt_purchase
  • ta_c_tt_refunding
  • ta_c_tt_reservation
  • ta_c_tt_reversal
  • ta_c_tt_unload

Forbidden (always ta_object_invalid):

  • ta_c_tt_account_verification
  • ta_c_tt_authorize_credit
  • ta_c_tt_collect_points
Parameters
[in]trx_infoObject instance of type transaction_information.
[out]signature_informationPointer to variable to write object instance to. Object instance is of type signature_information and is not retained. Object instance is ta_object_invalid if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to signature_information.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentsignature_information is null-pointer.

◆ ta_transaction_information_get_six_trx_ref_num()

ta_e_result_code_t ta_transaction_information_get_six_trx_ref_num ( ta_object_t  trx_info,
ta_object_t six_trx_ref_num 
)

SIX Transaction Reference.

Parameters
[in]trx_infoObject instance of type transaction_information.
[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_object_invalid if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to six_trx_ref_num.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumentsix_trx_ref_num is null-pointer.

◆ ta_transaction_information_get_time_stamp()

ta_e_result_code_t ta_transaction_information_get_time_stamp ( ta_object_t  trx_info,
ta_object_t time_stamp 
)

Local time of the transaction.

Mandatory for:

  • ta_c_tt_activate_card
  • ta_c_tt_adjust_reservation
  • ta_c_tt_authorize_credit
  • ta_c_tt_authorize_deposit
  • ta_c_tt_cancel_reservation
  • ta_c_tt_cash_advance
  • ta_c_tt_collect_points
  • ta_c_tt_combined
  • ta_c_tt_credit
  • ta_c_tt_debt_recovery
  • ta_c_tt_finalize_purchase
  • ta_c_tt_funding
  • ta_c_tt_giro
  • ta_c_tt_load_voucher
  • ta_c_tt_load
  • ta_c_tt_pre_authorization
  • ta_c_tt_purchase_forced_acceptance
  • ta_c_tt_purchase_mail_ordered
  • ta_c_tt_purchase_phone_authorized
  • ta_c_tt_purchase_phone_ordered
  • ta_c_tt_purchase_reservation_phone_authorized
  • ta_c_tt_purchase_reservation
  • ta_c_tt_purchase_with_cashback
  • ta_c_tt_purchase
  • ta_c_tt_refunding
  • ta_c_tt_reservation
  • ta_c_tt_reversal
  • ta_c_tt_unload

Forbidden (always ta_object_invalid):

  • ta_c_tt_account_verification
Parameters
[in]trx_infoObject instance of type transaction_information.
[out]time_stampPointer to variable to write object instance to. Object instance is of type timedate and is not retained. Object instance is ta_object_invalid if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to time_stamp.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumenttime_stamp is null-pointer.

◆ ta_transaction_information_get_trans_ref()

ta_e_result_code_t ta_transaction_information_get_trans_ref ( ta_object_t  trx_info,
ta_object_t trans_ref 
)

Transaction reference defined by the terminal.

Conditional for (can be ta_object_invalid):

  • ta_c_tt_activate_card
  • ta_c_tt_authorize_credit
  • ta_c_tt_authorize_deposit
  • ta_c_tt_cash_advance
  • ta_c_tt_combined
  • ta_c_tt_credit
  • ta_c_tt_debt_recovery
  • ta_c_tt_finalize_purchase
  • ta_c_tt_funding
  • ta_c_tt_giro
  • ta_c_tt_load
  • ta_c_tt_pre_authorization
  • ta_c_tt_purchase_forced_acceptance
  • ta_c_tt_purchase_mail_ordered
  • ta_c_tt_purchase_phone_authorized
  • ta_c_tt_purchase_phone_ordered
  • ta_c_tt_purchase_with_cashback
  • ta_c_tt_purchase
  • ta_c_tt_refunding
  • ta_c_tt_reversal
  • ta_c_tt_unload

Forbidden (always ta_object_invalid):

  • ta_c_tt_account_verification
  • ta_c_tt_adjust_reservation
  • ta_c_tt_cancel_reservation
  • ta_c_tt_collect_points
  • ta_c_tt_load_voucher
  • ta_c_tt_purchase_reservation_phone_authorized
  • ta_c_tt_purchase_reservation
  • ta_c_tt_reservation
Parameters
[in]trx_infoObject instance of type transaction_information.
[out]trans_refPointer to variable to write object instance to. Object instance is of type integer and is not retained. Object instance is ta_object_invalid if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to trans_ref.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumenttrans_ref is null-pointer.

◆ ta_transaction_information_get_trans_seq()

ta_e_result_code_t ta_transaction_information_get_trans_seq ( ta_object_t  trx_info,
ta_object_t trans_seq 
)

Transaction sequence number defined by the terminal.

Conditional for (can be ta_object_invalid):

  • ta_c_tt_activate_card
  • ta_c_tt_authorize_credit
  • ta_c_tt_authorize_deposit
  • ta_c_tt_cash_advance
  • ta_c_tt_combined
  • ta_c_tt_credit
  • ta_c_tt_debt_recovery
  • ta_c_tt_finalize_purchase
  • ta_c_tt_funding
  • ta_c_tt_giro
  • ta_c_tt_load
  • ta_c_tt_pre_authorization
  • ta_c_tt_purchase_forced_acceptance
  • ta_c_tt_purchase_mail_ordered
  • ta_c_tt_purchase_phone_authorized
  • ta_c_tt_purchase_phone_ordered
  • ta_c_tt_purchase_with_cashback
  • ta_c_tt_purchase
  • ta_c_tt_refunding
  • ta_c_tt_reversal
  • ta_c_tt_unload

Forbidden (always ta_object_invalid):

  • ta_c_tt_account_verification
  • ta_c_tt_adjust_reservation
  • ta_c_tt_cancel_reservation
  • ta_c_tt_collect_points
  • ta_c_tt_load_voucher
  • ta_c_tt_purchase_reservation_phone_authorized
  • ta_c_tt_purchase_reservation
  • ta_c_tt_reservation
Parameters
[in]trx_infoObject instance of type transaction_information.
[out]trans_seqPointer to variable to write object instance to. Object instance is of type integer and is not retained. Object instance is ta_object_invalid if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to trans_seq.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumenttrans_seq is null-pointer.

◆ ta_transaction_information_get_trm_trans_ref()

ta_e_result_code_t ta_transaction_information_get_trm_trans_ref ( ta_object_t  trx_info,
ta_object_t trm_trans_ref 
)

Transaction reference from the terminal.

Mandatory for:

  • ta_c_tt_adjust_reservation
  • ta_c_tt_cancel_reservation
  • ta_c_tt_collect_points
  • ta_c_tt_purchase_reservation_phone_authorized
  • ta_c_tt_purchase_reservation
  • ta_c_tt_reservation

Conditional for (can be ta_object_invalid):

  • ta_c_tt_activate_card
  • ta_c_tt_authorize_credit
  • ta_c_tt_authorize_deposit
  • ta_c_tt_cash_advance
  • ta_c_tt_combined
  • ta_c_tt_credit
  • ta_c_tt_debt_recovery
  • ta_c_tt_finalize_purchase
  • ta_c_tt_funding
  • ta_c_tt_giro
  • ta_c_tt_load_voucher
  • ta_c_tt_load
  • ta_c_tt_pre_authorization
  • ta_c_tt_purchase_forced_acceptance
  • ta_c_tt_purchase_mail_ordered
  • ta_c_tt_purchase_phone_authorized
  • ta_c_tt_purchase_phone_ordered
  • ta_c_tt_purchase_with_cashback
  • ta_c_tt_purchase
  • ta_c_tt_refunding
  • ta_c_tt_reversal
  • ta_c_tt_unload

Forbidden (always ta_object_invalid):

  • ta_c_tt_account_verification
Parameters
[in]trx_infoObject instance of type transaction_information.
[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_object_invalid if value is not set in trx_info.
Return values
ta_c_rc_okObject instance written to trm_trans_ref.
ta_c_rc_invalid_argumenttrx_info is ta_object_invalid.
ta_c_rc_invalid_argumenttrx_info is not of type transaction_information.
ta_c_rc_invalid_argumenttrm_trans_ref is null-pointer.