card_data.h File Reference

Description

Card data.

Object type card_data.

Functions
ta_e_result_code_t	ta_card_data_get_pos_entry_mode (ta_object_t card_data, ta_e_pos_entry_mode_t *pos_entry_mode)
	POS entry mode. More...
ta_e_result_code_t	ta_card_data_get_aid (ta_object_t card_data, ta_object_t *aid)
	Application identifier. More...
ta_e_result_code_t	ta_card_data_get_acc (ta_object_t card_data, ta_object_t *acc)
	Application currency code. More...
ta_e_result_code_t	ta_card_data_get_card_number (ta_object_t card_data, ta_object_t *card_number)
	Card number. More...
ta_e_result_code_t	ta_card_data_get_card_number_printable (ta_object_t card_data, ta_object_t *card_number_printable)
	Card number that should be printed on a merchant receipt. More...
ta_e_result_code_t	ta_card_data_get_card_number_printable_cardholder (ta_object_t card_data, ta_object_t *card_number_printable_cardholder)
	Card number that should be printed on a cardholder receipt. More...
ta_e_result_code_t	ta_card_data_get_card_number_enc (ta_object_t card_data, ta_object_t *card_number_enc)
	Encrypted card number. More...
ta_e_result_code_t	ta_card_data_get_card_number_enc_key_index (ta_object_t card_data, int *card_number_enc_key_index)
	Card number encryption key index. More...
ta_e_result_code_t	ta_card_data_get_card_expiry_date (ta_object_t card_data, ta_object_t *card_expiry_date)
	Card expiration date. More...
ta_e_result_code_t	ta_card_data_get_brand_name (ta_object_t card_data, ta_object_t *brand_name)
	Card brand name. More...
ta_e_result_code_t	ta_card_data_get_tender_name (ta_object_t card_data, ta_object_t *tender_name)
	Card tender name. More...
ta_e_result_code_t	ta_card_data_get_card_track_datas (ta_object_t card_data, ta_object_t *card_track_datas)
	List of card track data if present. More...
ta_e_result_code_t	ta_card_data_get_loyalty_informations (ta_object_t card_data, ta_object_t *loyalty_informations)
	Loyalty information if present. Keyed by loyalty type string. More...
ta_e_result_code_t	ta_card_data_get_card_ref (ta_object_t card_data, ta_object_t *card_ref)
	Petrol: Reference from the card. More...
ta_e_result_code_t	ta_card_data_get_processing_disposition (ta_object_t card_data, ta_e_processing_disposition_t *processing_disposition)
	Petrol: Defines if the ECR or EFT is responsible for further trx handling. More...
ta_e_result_code_t	ta_card_data_get_language (ta_object_t card_data, ta_object_t *language)
	Card language. More...
ta_e_result_code_t	ta_card_data_get_card_country_code (ta_object_t card_data, ta_object_t *country_code)
	Card country code. More...
ta_e_result_code_t	ta_card_data_get_terminal_country_code (ta_object_t card_data, ta_object_t *country_code)
	Terminal country code. More...
ta_e_result_code_t	ta_card_data_get_uid (ta_object_t card_data, ta_object_t *uid)
	Uid of the contactless card. More...

Function Documentation

ta_card_data_get_acc()

ta_e_result_code_t ta_card_data_get_acc	(	ta_object_t	card_data,
		ta_object_t *	acc
	)

Application currency code.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	acc	Pointer 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 card_data.

Return values

ta_c_rc_ok	Object instance written to acc.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	acc is null-pointer.

ta_card_data_get_aid()

ta_e_result_code_t ta_card_data_get_aid	(	ta_object_t	card_data,
		ta_object_t *	aid
	)

Application identifier.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	aid	Pointer 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 card_data.

Return values

ta_c_rc_ok	Object instance written to aid.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	aid is null-pointer.

ta_card_data_get_brand_name()

ta_e_result_code_t ta_card_data_get_brand_name	(	ta_object_t	card_data,
		ta_object_t *	brand_name
	)

Card brand name.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	brand_name	Pointer 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 card_data.

Return values

ta_c_rc_ok	Object instance written to brand_name.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	brand_name is null-pointer.

ta_card_data_get_card_country_code()

ta_e_result_code_t ta_card_data_get_card_country_code	(	ta_object_t	card_data,
		ta_object_t *	country_code
	)

Card country code.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	country_code	Pointer 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 card_data.

Return values

ta_c_rc_ok	Object instance written to country_code.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	country_code is null-pointer.

ta_card_data_get_card_expiry_date()

ta_e_result_code_t ta_card_data_get_card_expiry_date	(	ta_object_t	card_data,
		ta_object_t *	card_expiry_date
	)

Card expiration date.

Only for Non-PCI applications and if available to the terminal.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	card_expiry_date	Pointer 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 card_data.

Return values

ta_c_rc_ok	Object instance written to card_expiry_date.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	card_expiry_date is null-pointer.

ta_card_data_get_card_number()

ta_e_result_code_t ta_card_data_get_card_number	(	ta_object_t	card_data,
		ta_object_t *	card_number
	)

Card number.

Only for Non-PCI applications and if available to the terminal.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	card_number	Pointer 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 card_data.

Return values

ta_c_rc_ok	Object instance written to card_number.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	card_number is null-pointer.

ta_card_data_get_card_number_enc()

ta_e_result_code_t ta_card_data_get_card_number_enc	(	ta_object_t	card_data,
		ta_object_t *	card_number_enc
	)

Encrypted card number.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	card_number_enc	Pointer 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 card_data.

Return values

ta_c_rc_ok	Object instance written to card_number_enc.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	card_number_enc is null-pointer.

ta_card_data_get_card_number_enc_key_index()

ta_e_result_code_t ta_card_data_get_card_number_enc_key_index	(	ta_object_t	card_data,
		int *	card_number_enc_key_index
	)

Card number encryption key index.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	card_number_enc_key_index	Pointer to variable to write value to. Value is 0 if value is not set in card_data.

Return values

ta_c_rc_ok	Object instance written to card_number_enc_key_index.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	card_number_enc_key_index is null-pointer.

ta_card_data_get_card_number_printable()

ta_e_result_code_t ta_card_data_get_card_number_printable	(	ta_object_t	card_data,
		ta_object_t *	card_number_printable
	)

Card number that should be printed on a merchant receipt.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	card_number_printable	Pointer 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 card_data.

Return values

ta_c_rc_ok	Object instance written to card_number_printable.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	card_number_printable is null-pointer.

ta_card_data_get_card_number_printable_cardholder()

ta_e_result_code_t ta_card_data_get_card_number_printable_cardholder	(	ta_object_t	card_data,
		ta_object_t *	card_number_printable_cardholder
	)

Card number that should be printed on a cardholder receipt.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	card_number_printable_cardholder	Pointer 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 card_data.

Return values

ta_c_rc_ok	Object instance written to card_number_printable_cardholder.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	card_number_printable_cardholder is null-pointer.

ta_card_data_get_card_ref()

ta_e_result_code_t ta_card_data_get_card_ref	(	ta_object_t	card_data,
		ta_object_t *	card_ref
	)

Petrol: Reference from the card.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	card_ref	Pointer 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 card_data.

Return values

ta_c_rc_ok	Object instance written to card_ref.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	card_ref is null-pointer.

ta_card_data_get_card_track_datas()

ta_e_result_code_t ta_card_data_get_card_track_datas	(	ta_object_t	card_data,
		ta_object_t *	card_track_datas
	)

List of card track data if present.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	card_track_datas	Pointer to variable to write object instance to. Object instance is of type list and is not retained. The list contains elements of type card_track_data.

Return values

ta_c_rc_ok	Object instance written to card_track_datas.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	card_track_datas is null-pointer.

ta_card_data_get_language()

ta_e_result_code_t ta_card_data_get_language	(	ta_object_t	card_data,
		ta_object_t *	language
	)

Card language.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	language	Pointer 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 card_data.

Return values

ta_c_rc_ok	Object instance written to language.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	language is null-pointer.

ta_card_data_get_loyalty_informations()

ta_e_result_code_t ta_card_data_get_loyalty_informations	(	ta_object_t	card_data,
		ta_object_t *	loyalty_informations
	)

Loyalty information if present. Keyed by loyalty type string.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	loyalty_informations	Pointer to variable to write object instance to. Object instance is of type map and is not retained. The map contains keys and values both of type string.

Return values

ta_c_rc_ok	Object instance written to loyalty_informations.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	loyalty_informations is null-pointer.

ta_card_data_get_pos_entry_mode()

ta_e_result_code_t ta_card_data_get_pos_entry_mode	(	ta_object_t	card_data,
		ta_e_pos_entry_mode_t *	pos_entry_mode
	)

POS entry mode.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	pos_entry_mode	Pointer to variable to write value to. Value is ta_c_pem_undefined if value is not set in card_data.

Return values

ta_c_rc_ok	Object instance written to pos_entry_mode.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	pos_entry_mode is null-pointer.

ta_card_data_get_processing_disposition()

ta_e_result_code_t ta_card_data_get_processing_disposition	(	ta_object_t	card_data,
		ta_e_processing_disposition_t *	processing_disposition
	)

Petrol: Defines if the ECR or EFT is responsible for further trx handling.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	processing_disposition	Pointer to variable to write value to. Value is ta_c_pd_undefined if value is not set in card_data.

Return values

ta_c_rc_ok	Object instance written to processing_disposition.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	processing_disposition is null-pointer.

ta_card_data_get_tender_name()

ta_e_result_code_t ta_card_data_get_tender_name	(	ta_object_t	card_data,
		ta_object_t *	tender_name
	)

Card tender name.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	tender_name	Pointer 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 card_data.

Return values

ta_c_rc_ok	Object instance written to tender_name.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	tender_name is null-pointer.

ta_card_data_get_terminal_country_code()

ta_e_result_code_t ta_card_data_get_terminal_country_code	(	ta_object_t	card_data,
		ta_object_t *	country_code
	)

Terminal country code.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	country_code	Pointer 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 card_data.

Return values

ta_c_rc_ok	Object instance written to country_code.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	country_code is null-pointer.

ta_card_data_get_uid()

ta_e_result_code_t ta_card_data_get_uid	(	ta_object_t	card_data,
		ta_object_t *	uid
	)

Uid of the contactless card.

Parameters

[in]	card_data	Object instance of type card_data.
[out]	uid	Pointer 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 card_data.

Return values

ta_c_rc_ok	Object instance written to uid.
ta_c_rc_invalid_argument	card_data is ta_invalid_object.
ta_c_rc_invalid_argument	card_data is not of type card_data.
ta_c_rc_invalid_argument	uid is null-pointer.