Contents

Configuration

 

To enable DCC on your account, please contact our Support Team. There are two methods to enable DCC on your account:

  1. Support can configure your live site in such a way that all requests, where the customer’s payment type supports DCC, are processed as DCC. The request you submit to the Payment Pages remains unchanged from a standard authorisation.
  2. Including the field dcctype with the value “DCC” in your POST will result in DCC being performed on a request, if the customer’s payment type supports it. Not including this field in your POST will result in a normal authorisation request being processed, without the customer being able to choose an alternative currency.
Warning
For DCC requests, it is imperative that you submit a currency that is supported by your account. This is to ensure the correct currencies are used when performing currency conversion.

 


 

DCC fields

Following CURRENCYRATE requests, we will return additional DCC fields for your records, as listed in the table below. These fields are displayed for the CURRENCYRATE and AUTH requests in MyST.

The fields can be returned in a URL notification on completion of a transaction. Include the fields shown below in order to include DCC information. They can also be included in an email notification (contact our Support Team to enable this).

 

Field name Description
dccbaseamount The base amount the customer has paid in the submitted currency (£10.50 is 1050).
dcccurrencyiso3a The currency you submitted in the POST to Payment Pages.
dccenabled Whether or not DCC is enabled on your account:

1 – Your Trust Payments account is enabled for DCC.
0 – Your Trust Payments account is not enabled for DCC.

dccconversionrate The conversion rate used to convert the amount in the submitted currency to the amount in the customer’s currency.
dccconversionratesource The source of the conversion rate provided by the DCC provider.
dccmainamount The main amount the customer has paid in the submitted currency
(£10.50 is 10.50).
dccmarginratepercentage The percentage used to calculate the currency conversion fee, applied to the amount in the customer’s currency.
dccoffered This value represents whether the customer has chosen to pay in the submitted currency or their local currency:

1 – Customer has chosen to pay in their local currency.
2 – Customer will pay using the merchant’s currency because DCC was not offered (e.g. the CURRENCYRATE request encountered an error).
3 – The customer has chosen to pay in the submitted currency.

dccprovider The institution that provides the conversion rate.
dcctype “DCC”