DCC API Fields

0140 (Merchant Currency)

  • Description: Merchant Transaction Currency Code.
  • Length: 3
  • Number: alpha

0142 (Cardholder Currency)

  • Description: Cardholder ISO Currency Code.
  • Length: 3
  • Number: alpha

0144 (Converted Currency Amount)

  • Description: Cardholder Transaction amount.
  • Length: 1 - 14
  • Number: cents

0150 (DCC Rate)

  • Description: Foreign Currency Exchange Rate.
  • Length: 1 - 10
  • Number: numeric

0151 (DCC Indicator)

  • Description: 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
  • Length: 1-10
  • Number: numeric

0159 (DCC Exponent)

  • Description: Number of exponent digits in the DCC Rate.
  • Length: 1
  • Number: numeric

0164 (DCC File ID)

  • Description: 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 stores this value for receipt printing and research of previous rates.
  • Length: 21
  • Number: numeric

0165 (DCC Markup Percentage)

  • Description: DCC Rate markup with the two implied decimals (3.25% is 0325).
  • Length: 4
  • Number: numeric

0166 (DCC Rate Provider Name)

  • Description: Indicates the name of the currency rate provider.
  • Length: 1 - 35
  • Number: alphanumeric

0169 (Merchant PMS/POS DCC Capability)

  • Description:
    • Valid values include:
      • 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
  • Length: 1
  • Number: numeric

7007 (Transaction Identifier)

  • Description: 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
  • Length: 21
  • Number: numeric

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.