# 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.7.0
Security: bearer, basic, apiKey

## Security:

  - `bearer` (unknown)
    http bearer JWT

  - `basic` (unknown)
    http basic

  - `apiKey` (unknown)
    apiKey in header X-API-Key

## 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)
    Card BIN (first 10 digits of the card number) used to determine cardholder country and DCC eligibility.

  - `pseudoCardNumber` (string)
    Pseudo card number.

  - `amount` (object, required)
    Amount object of the payment plan.

  - `amount.value` (integer)
    Total order amount in the smallest currency unit, including taxes, shipping costs, discounts, etc.

  - `amount.currency` (string)
    3-character ISO currency code.

## Request examples:

  - `Default` (unknown)

## Response 200:

  - `200` (unknown)
    Successfully received and processed

## Response 200 fields (application/json):

  - `dccInfo` (object)

  - `dccInfo.status` (string)
    Enum: "AVAILABLE", "NOT_AVAILABLE"

  - `dccInfo.provider` (string)

  - `dccInfo.dccRequestId` (string)

  - `dccInfo.rate` (object)

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

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

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

  - `dccInfo.amounts` (object)

  - `dccInfo.amounts.merchant` (object)

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

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

  - `dccInfo.amounts.cardholder` (object)

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

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

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

## Response 400:

  - `400` (unknown)
    Bad request, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400)

## Response 400 fields (application/json):

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

  - `type` (string)
    A URI reference that identifies the problem type

  - `title` (string)
    A short, human-readable summary of the problem type

  - `status` (string)
    The HTTP status code

  - `detail` (string)

  - `instance` (string)

## Response 422:

  - `422` (unknown)
    Unprocessable Entity, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422)

## Response 422 fields (application/json):

  - `dccInfo` (object)

  - `dccInfo.status` (string)
    Enum: "AVAILABLE", "NOT_AVAILABLE"

  - `dccInfo.provider` (string)

  - `dccInfo.dccRequestId` (string)

  - `dccInfo.rate` (object)

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

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

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

  - `dccInfo.amounts` (object)

  - `dccInfo.amounts.merchant` (object)

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

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

  - `dccInfo.amounts.cardholder` (object)

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

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

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

## Response 500:

  - `500` (unknown)
    Internal Server Error

## Response 500 fields (application/json):

  - `type` (string)

  - `title` (string)

  - `status` (string)

  - `detail` (string)

  - `instance` (string)

## Response 503:

  - `503` (unknown)
    Service Unavailable

## Response 503 fields (application/json):

  - `type` (string)

  - `title` (string)

  - `status` (string)

  - `detail` (string)

  - `instance` (string)

## Response 200 examples:

  - `Default` (unknown)

## Response 422 examples:

  - `Default` (unknown)

