tim_error.h File Reference

Description

Tim error.

Object type tim_error.

Functions
ta_e_result_code_t	ta_tim_error_get_result_code (ta_object_t response, ta_e_result_code_t *result_code)
	Result code. More...
ta_e_result_code_t	ta_tim_error_get_error_message (ta_object_t response, ta_object_t *error_message)
	Error message in the ECR language or ta_invalid_object if not present. More...
ta_e_result_code_t	ta_tim_error_get_native_error (ta_object_t response, ta_object_t *native_error)
	Native error if present or ta_invalid_object if not present. More...
ta_e_result_code_t	ta_tim_error_get_ppinfo (ta_object_t response, ta_object_t *ppinfo)
	Payment protocol specific information. More...
ta_e_result_code_t	ta_tim_error_get_additional_error_info (ta_object_t response, ta_object_t *additional_error_info)
	Additional error information mapping item text to item text code. More...
ta_e_result_code_t	ta_tim_error_get_print_data (ta_object_t response, ta_object_t *print_data)
	Print data or ta_invalid_object if absent. More...
ta_e_result_code_t	ta_tim_error_get_rejected_basket (ta_object_t response, ta_object_t *rejected_basket)
	Rejected basket as modified by host or null if absent. More...

Function Documentation

ta_tim_error_get_additional_error_info()

ta_e_result_code_t ta_tim_error_get_additional_error_info	(	ta_object_t	response,
		ta_object_t *	additional_error_info
	)

Additional error information mapping item text to item text code.

Mandatory if any additional error information available.

Parameters

[in]	response	Object instance of type tim_error.
[out]	additional_error_info	Pointer to variable to write object instance to. Object instance is of type map and is not retained. Keys and values are of type string and are retained by the map. Object instance is ta_invalid_object if value is not set in response.

Return values

ta_c_rc_ok	Object instance written to additional_error_info.
ta_c_rc_invalid_argument	response is ta_invalid_object.
ta_c_rc_invalid_argument	response is not of type tim_error.
ta_c_rc_invalid_argument	additional_error_info is null-pointer.

ta_tim_error_get_error_message()

ta_e_result_code_t ta_tim_error_get_error_message	(	ta_object_t	response,
		ta_object_t *	error_message
	)

Error message in the ECR language or ta_invalid_object if not present.

Parameters

[in]	response	Object instance of type tim_error.
[out]	error_message	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 response.

Return values

ta_c_rc_ok	Object instance written to error_message.
ta_c_rc_invalid_argument	response is ta_invalid_object.
ta_c_rc_invalid_argument	response is not of type tim_error.
ta_c_rc_invalid_argument	error_message is null-pointer.

ta_tim_error_get_native_error()

ta_e_result_code_t ta_tim_error_get_native_error	(	ta_object_t	response,
		ta_object_t *	native_error
	)

Native error if present or ta_invalid_object if not present.

Parameters

[in]	response	Object instance of type tim_error.
[out]	native_error	Pointer to variable to write object instance to. Object instance is of type native_error and is not retained. Object instance is ta_invalid_object if value is not set in response.

Return values

ta_c_rc_ok	Object instance written to native_error.
ta_c_rc_invalid_argument	response is ta_invalid_object.
ta_c_rc_invalid_argument	response is not of type tim_error.
ta_c_rc_invalid_argument	native_error is null-pointer.

ta_tim_error_get_ppinfo()

ta_e_result_code_t ta_tim_error_get_ppinfo	(	ta_object_t	response,
		ta_object_t *	ppinfo
	)

Payment protocol specific information.

Mandatory if any information is given by the underlying payment protocol.

Parameters

[in]	response	Object instance of type tim_error.
[out]	ppinfo	Pointer to variable to write object instance to. Object instance is of type ppinfo and is not retained. Object instance is ta_invalid_object if value is not set in response.

Return values

ta_c_rc_ok	Object instance written to ppinfo.
ta_c_rc_invalid_argument	response is ta_invalid_object.
ta_c_rc_invalid_argument	response is not of type tim_error.
ta_c_rc_invalid_argument	ppinfo is null-pointer.

ta_tim_error_get_print_data()

ta_e_result_code_t ta_tim_error_get_print_data	(	ta_object_t	response,
		ta_object_t *	print_data
	)

Print data or ta_invalid_object if absent.

Parameters

[in]	response	Object instance of type tim_error.
[out]	print_data	Pointer to variable to write object instance to. Object instance is of type print_data and is not retained. Object instance is ta_invalid_object if value is not set in response.

Return values

ta_c_rc_ok	Object instance written to print_data.
ta_c_rc_invalid_argument	response is ta_invalid_object.
ta_c_rc_invalid_argument	response is not of type tim_error.
ta_c_rc_invalid_argument	print_data is null-pointer.

ta_tim_error_get_rejected_basket()

ta_e_result_code_t ta_tim_error_get_rejected_basket	(	ta_object_t	response,
		ta_object_t *	rejected_basket
	)

Rejected basket as modified by host or null if absent.

Used for ta_c_guide_petrol only.

Parameters

[in]	response	Object instance of type tim_error.
[out]	rejected_basket	Pointer to variable to write object instance to. Object instance is of type basket and is not retained. Object instance is ta_invalid_object if value is not set in response.

Return values

ta_c_rc_ok	Object instance written to rejected_basket.
ta_c_rc_invalid_argument	response is ta_invalid_object.
ta_c_rc_invalid_argument	response is not of type tim_error.
ta_c_rc_invalid_argument	rejected_basket is null-pointer.

ta_tim_error_get_result_code()

ta_e_result_code_t ta_tim_error_get_result_code	(	ta_object_t	response,
		ta_e_result_code_t *	result_code
	)

Result code.

Parameters

[in]	response	Object instance of type tim_error.
[out]	result_code	Pointer to variable to write result code to.

Return values

ta_c_rc_ok	Object instance written to error_message.
ta_c_rc_invalid_argument	response is ta_invalid_object.
ta_c_rc_invalid_argument	response is not of type tim_error.
ta_c_rc_invalid_argument	result_code is null-pointer.