On This Page

DCC Offer

A DCC offer creates a new offer record in your system. Request the DCC Offer service to determine the eligibility of the transaction for DCC and to convert the price from the local payment currency to the DCC billing currency for eligible transactions.

Header Fields

DCC Offer calls require these header fields:
Authorization
keyId

Endpoint

Test:
POST
https://apitest.cybersource.com
/vas/v1/currencyconversion
Production:
POST
https://api.cybersource.com
/vas/v1/currencyconversion

Required Fields for DCC Offer POST Request

Optional Fields for DCC Offer POST Request

orderInformation.currencyConversion.type
This field is required when MCP is enabled.
Default value:
  • DCC
    : Dynamic Currency Conversion
Possible values:
  • KEYED
    : may refer to MOTO on a terminal, MOTO on a virtual terminal, or eCommerce.
  • SWIPED
  • CONTACT
  • CONTACTLESS

REST Example: DCC Offer POST

Request
{
  "clientReferenceInformation": {
    "code": "REF-101-USD-909",
    "partner": {
      "developerId": "123456",
      "solutionId": "123456"
    },
    "applicationName": "REST API",
    "applicationVersion": "1.23.44",
    "applicationUser": "Bob"
  },
  "paymentInformation": {
    "card": {
      "number": "41111111111"
    }
  },
  "orderInformation": {
    "amountDetails": {
      "originalAmount": "100.00",
      "originalCurrency": "USD"
    },
    "currencyConversion": {
      "type": "DCC"
    }
  },
  "pointOfSaleInformation": {
    "terminalId": "12345678",
    "entryMode": "CONTACT"
  }
}
Response
{
  "clientReferenceInformation": {
    "code": "REF-101-USD-909"
  },
  "id": "6843379070056369304008",
  "submitTimeUtc": "2023-05-17T22:47:57Z",
  "status": "PENDING",
  },
  "orderInformation": {
    "currencyConversion": {
      "type": "DCC",
      "reconciliationId": "ABC123",
      "offer": [
        {
          "originalAmount": "100.00",
          "originalCurrency": "USD",
          "amount": "157.00",
          "currency": "AUD",
          "exchangeRate": "1.57",
          "marginRate": "3.0",
          "rateSource": "Wholesale Exchange Rate",
          "exchangeRateTimeUtc": "2023-05-17T23:47:57Z",
          "exchangeRateExpirationTimeUtc": "2024-05-18T22:47:57Z",
          "exchangeRateInverted": true,
          "rateId": "009F303309AF07234520190628143445"
        }
      ],
      "disclaimer": "SAMPLE ONLY: I have been offered a choice of currencies and choose to pay in the selected currency above. Dynamic Currency Conversion (DCC) is provided by the <MERCHANT>."
    }
  }
}
RELATED TO THIS PAGE