Request Fields
Initial Request (Hosted and Direct Integration)
These fields should be sent in addition to the Basic Request Fields.
| Field Name | Mandatory? | Description |
|---|---|---|
| dccRequired | No[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 Name | Mandatory? | Description |
|---|---|---|
| dccRef | Yes | The value of the dccRef field in the initial Gateway response. |
| dccAccepted | Yes | 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 Name | Mandatory? | Description |
|---|---|---|
| dccAccepted | No | 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. |
| dccProvider | Yes | DCC provider code name. |
| dccMargin | Yes | Percentage markup (0-9999.999999) |
| dccCommission | Yes | Percentage commission (0-9999.999999) |
| dccSource | Yes | Source of exchange rate |
| dccCreated | Yes | Time rate sourced (YYYY-MM-DD HH:MM:SS) |
| dccExpires | Yes | Time rate expires (YYYY-MM-DD HH:MM:SS) |
| dccCurrencyCode | Yes | Cardholder’s currency |
| dccAmount | No | The amount of the transaction in the Cardholder’s minor currency converted at the rate provided. |
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.