Skip to main content

Request Fields

Initial Request (Hosted and Direct Integration)​

These fields should be sent in addition to the Basic Request Fields.

Field NameMandatory?Description
dccRequiredNo[1]

Is 3DS required for this transaction?

Possible values are:

N – DCC is not required.

Y – DCC is not required.

Continuation Request (Direct Integration)​

These fields may be sent alone[2][2].

Field NameMandatory?Description
dccRefYesThe value of the dccRef field in the initial Gateway response.
dccAcceptedYes

The Cardholder’s acceptance to pay using the DCC conversion offered. If they don’t accept, then the original transaction currency is used.

Possible values are:

N – Cardholder refused the DCC offer.

Y – Cardholder accepted the DCC offer.

External Authentication Request (Direct Integration)​

These fields should be sent in addition to the Basic Request Fields.

Field NameMandatory?Description
dccAcceptedNo

The Cardholder’s acceptance to pay using the DCC conversion offered. If they don’t accept then the original transaction currency is used.

Possible values are:

N – Cardholder refused the DCC offer.

Y – Cardholder accepted the DCC offer.

dccProviderYesDCC provider code name.
dccMarginYesPercentage markup (0-9999.999999)
dccCommissionYesPercentage commission (0-9999.999999)
dccSourceYesSource of exchange rate
dccCreatedYesTime rate sourced (YYYY-MM-DD HH:MM:SS)
dccExpiresYesTime rate expires (YYYY-MM-DD HH:MM:SS)
dccCurrencyCodeYesCardholder’s currency
dccAmountNoThe amount of the transaction in the Cardholder’s minor currency converted at the rate provided.
info

If DCC is not enabled for the Merchant Account then any DCC conversion fields sent in the request are ignored and the transaction is processed as normal without DCC. If DCC is enabled but the transaction is otherwise not eligible for DCC conversion, then any DCC field sent in the request will result in an error response.

Footnotes

  1. Any other value will use the preference set in the Merchant Management System (MMS).
  2. See note below.