# Get Dynamic Currency Conversion quote.

This endpoint is used to retrieve a Dynamic Currency Conversion (DCC) quote for a given transaction amount and card BIN.

Endpoint: POST /services/dcc/quote
Version: 2.2.0
Security: bearerAuth, basicAuth

## Header parameters:

  - `Idempotency-Key` (string)
    A unique key provided by you to ensure that a particular operation is not processed multiple times in case of retries.

## Request fields (application/json):

  - `bin` (string, required)
    Card BIN (first digits of the card number) used to determine cardholder country and DCC eligibility.

  - `amount` (object, required)

  - `amount.value` (number, required)
    Transaction amount in merchant base currency for which the DCC quote is requested.

  - `amount.currency` (string, required)
    Merchant base currency (ISO 4217 alphabetic code) of the transaction amount.

## Response 200 fields (application/json):

  - `status` (string)
    Indicates whether DCC is available for the given BIN and transaction data.
    Enum: "AVAILABLE", "NOT_AVAILABLE"

  - `provider` (string)
    DCC service provider identifier.

  - `dccRequestId` (string)
    Unique identifier of the DCC quote request.

  - `rate` (object)

  - `rate.exchangeRate` (number)
    Applied exchange rate used for the DCC calculation.

  - `rate.markupPercentage` (number)
    Markup percentage applied on top of the base exchange rate.

  - `rate.timestamp` (string)
    Timestamp indicating when the DCC rate was generated.

  - `amounts` (object)

  - `amounts.merchant` (object)

  - `amounts.merchant.value` (number)
    Merchant transaction amount as provided in the request.

  - `amounts.merchant.currency` (string)
    Merchant base currency as provided in the request.

  - `amounts.cardholder` (object)

  - `amounts.cardholder.value` (number)
    Cardholder amount converted from merchant amount, expressed as integer value.

  - `amounts.cardholder.currency` (string)
    Cardholder currency (ISO 4217 alphabetic code) determined based on the card BIN.

  - `amounts.cardholder.decimalValue` (number)
    Cardholder amount converted from merchant amount, expressed with decimal precision.

## Response 400 fields (application/json):

  - `type` (string)
    A URI reference that identifies the problem type
    Example: "https://tools.ietf.org/html/rfc9110#section-15.5.1"

  - `title` (string)
    A short, human-readable summary of the problem type
    Example: "One or more validation errors occurred."

  - `status` (integer)
    The HTTP status code
    Example: 400

  - `traceId` (string)
    Trace Id
    Example: "00-a06284de9126d7fa46a5d112b3a721c3-c923572965eea46b-00"

  - `errors` (object)
    Example: {"Object":["Error 1","Error 2"]}

## Response 422 fields (application/json):

  - `status` (string)
    Indicates whether DCC is available for the given BIN and transaction data.
    Enum: "AVAILABLE", "NOT_AVAILABLE"

## Response 500 fields (application/json):

  - `responseCode` (string)
    Example: "A specific identifier for the error cause"

  - `responseDescription` (string)
    Example: "A brief message explaining the error"


## Response 503 fields