DCC API Fields

FieldNameLength
Type
Description
0140Merchant Currency3
alpha
Merchant Transaction Currency Code
0142Cardholder Currency3
alpha
Cardholder ISO Currency Code
0144Converted Currency Amount1-14
cents
Cardholder Transaction amount
0150DCC Rate1-10
numeric
Foreign Currency Exchange Rate
0151DCC Indicator1
numeric
DCC Eligible terminal indicator. Valid values include:
0 = Not DCC Capable
1 = DCC Capable and cardholder has opted-in
2 = DCC BIN match, but no corresponding rate for that currency
3 = DCC capable, but cardholder has opted-out
0159DCC Exponent1
numeric
Number of exponent digits in the DCC Rate
0164DCC File ID21
numeric
In the case where Simplify or the payment application performs the DCC Inquiry on behalf of the POS/PMS, they will need to populate the value from field 7007 in the transaction type 46 response into field 0164 in the authorization response to the PMS/POS. PMS/POS store this value for receipt printing and research of previous rates
0165DCC Markup Percentage4
numeric
DCC Rate markup with the 2 implied decimals (3.25% is 0325)
0166DCC Rate Provider Name1-35
alphanumeric
Indicates the name of the currency rate provider
0169Merchant PMS/POS DCC Capability1
numeric
0 = Merchant’s PMS/POS is not DCC Capable
1 = Merchant’s PMS/POS is DCC Capable and enabled
2 = Merchant’s PMS/POS is DCC Capable and not enabled
3 = Merchant’s PMS/POS is DCC Capable and enabled, Merchant does not want to perform DCC on this transaction
7007Transaction Identifier21
numeric
Unique identifier to reference the transaction. We advise that the PMS/POS store this value from the DCC Inquiry response for receipt printing and research of previous rates in financial transactions

note

Depending on the payment type, card type, transaction type, the TPP being interfaced with, and other factors, not all of these fields may be required.