Implement the DCC callback
tender_dcc_CB and assign to the function pointer
status_tender_DCC. For more information on how to do this, see Implement callbacks as part of a register_device_request.
Invoke Dynamic Currency Conversion callback
AskDCC in merchant account settings to invoke the DCC callback. Contact POS Support Team to enable this setting.
Handle the DCC callback
tender_dcc_CB callback presents a currency conversion option to the shopper. This allows the POS to indicate this on the POS screen and to provide the details of the currency conversion option also to the shop agent.
DCC Returned Details
The DCC details contain the following keys:
||The markup percentage (for example, 300 = 3%).|
||The commission fee in minor units (for example, 0. Not used currently.).|
||The exchange rate (for example, 16178 = 1.6178).|
||The amount after conversion (for example, minor units).|
||The currency after conversion (For example, USD).|
||The original amount in minor units.|
||The original currency (for example, EUR).|
||The exchange rate source (for example, oanda).|
A function is available to get additional data values from the
additional_data struct. See
get_additional_data_value in additional_data.h.
The SDK package contains a folder documentation/log_files/documentation. This folder contains log files of actual test runs that relate to the items discussed in this manual.
The dcc_callback.log file that shows a live example of the register device call and the related callback.