For the complete documentation index, see llms.txt. This page is also available as Markdown.

currency_selection_prior_to_auth_preauth

Description

The host is queried for DCC information, if the host response contains DCC information, the card holder will be prompted to pay using either the local currency or the card holder’s home currency.

Configuration Parameters\

Merchant.DccEnabled - Indicates that terminal supports dynamic currency conversion.

Merchant.DccMode = 1 - Indicates that terminal supports prior to authorization dynamic currency conversion.

Merchant.DccMarkupValue - Indicates Foreign exchange markup value used during conversion.

Acquirer.2 - Configure Acquirer.2/AcquirerId, Acquirer.2/AcquirerName and Acquirer.2/HostName if there are two host service applications, one supporting local currency authorizations and the other supporting DCC rate lookups and foreign currency authorizations.

For example: <Parameter Name="Acquirer.1/AcquirerId" Value="1"/> <Parameter Name="Acquirer.1/AcquirerName" Value="payment_host"/> <Parameter Name="Acquirer.1/HostName" Value="payment_host"/> <Parameter Name="Acquirer.2/AcquirerId" Value="2"/> <Parameter Name="Acquirer.2/AcquirerName" Value="dcc_host"/> <Parameter Name="Acquirer.2/HostName" Value="dcc_host"/>

Products.DccAcquirerId - If this parameter is configured to be the same as the AcquirerID supporting DCC for the product corresponding to the inserted, swiped or tapped card, the card holder will be prompted to pay using either the local currency or their home currency.

Merchant.PreAuthFollowOnDccEnabled - When enabled, the currency selection screen will be shown during pre-authorization follow-on transactions, such as completion, extension, and update.

Error Scenarios\

If the chip card is removed, the transaction will be cancelled and no reversal will be generated.

If the transaction is cancelled, Transaction cancelled, user aborted message will be shown.

If the wait for user selection times out, Transaction Aborted, user timeout message will be shown.

If the device crashes or device reboots while on this screen, when the payment application restarts or device boots up, no power failure recovery will happen.

---

Last updated

Was this helpful?