---
title: "Create Exchange Rate Quote"
method: POST
path: "/v2/pricing/quote-exchange-rates"
tags: ["quote-exchange-rates"]
---

# Create Exchange Rate Quote

`POST /v2/pricing/quote-exchange-rates`

<strong>Purpose:</strong><ul><p>The PayPal Exchange Rate Quote API enables businesses to dynamically display prices in multiple currencies by generating exchange rate quotes for currency pair.</p></ul><strong>Key Features:</strong><ul><p>FX Rate Guarantee: Guarantees exchange rates for a specified duration, ensuring stability and consistency in currency presentment scenarios.</p><p>Customizable Pricing: Provides flexible exchange rate options tailored to business needs, allowing customization through negotiated rates and dynamic pricing models to align with business requirements.</p><p>Provides functionality to source wholesale market rates with the addition of a percentage-based currency conversion fee. This enables the delivery of retail exchange rates without offering a rate guarantee.</p><p>FX Rate Revenue Markup: Offers merchants the flexibility to apply customized markups on exchange rates, allowing them to generate additional revenue from currency conversions. Enables businesses to define their own pricing strategies by setting adjustable markups based on transaction volume, customer segments, or market conditions, ensuring greater control over foreign exchange earnings while maintaining competitive pricing for end users.</p></ul><strong>Quote API Usage:</strong><ul><p>Need a Guaranteed Rate for a Certain Timeframe: Businesses want to lock in an exchange rate for a defined period to protect against market fluctuations and reduce the risk of FX volatility.</p><p>Offer Customers Stable, Upfront Pricing for a Limited Time: Displaying FX rates but ensuring the rate remains fixed for a short duration, allowing customers to complete their purchase without unexpected price changes.</p><p>Integrate with PayPal as Payment Processor for Real-Time Quoting Scenarios: Leveraging PayPal’s payment processing capabilities, ensuring seamless multi-currency support.</p></ul><strong>Sample Use cases:</strong> Multi-Currency Presentment, Real-Time Checkout Quotes, Subscription Pricing with Guaranteed Rate, Buy-Now-Price Guarantee for Cross-Border Seller.

## Request body

- QuoteExchangeRatesRequest — Request Object for quoting exchange rates.
  - `organization` string — Organization this managed account belongs to, in the partner's hierarchy, in the form of a path.
  - `quote_items` QuoteItem[], required — Parameters required to request an exchange rate, passed in the quote_items array: <ul><li>base_currency</li><li>base_amount</li><li>quote_currency</li><li>markup_percent</li><li>fx_id.</li></ul>
    - `base_currency` string, ppaas_common_currency_code_v2 — The [three-character ISO-4217 currency code](/docs/integration/direct/rest/currency-codes/) that identifies the currency.
    - `base_amount` string — Product price in base currency. If not provided, PayPal returns only the exchange rate and does not calculate the <code>quote_amount</code>.
    - `quote_currency` string, ppaas_common_currency_code_v2 — The [three-character ISO-4217 currency code](/docs/integration/direct/rest/currency-codes/) that identifies the currency.
    - `markup_percent` string, ppaas_common_percentage_v2 — The percentage, as a fixed-point, signed decimal number. For example, define a 19.99% interest rate as `19.99`.
    - `fx_id` string — Unique identifier that links a quoted FX rate to an order.

## Response `200`

A successful request returns the HTTP `200 OK` status code and a JSON response body that shows quote exchange rate details.

- QuoteExchangeRatesResponse — Response Object for quoting exchange rates.
  - `exchange_rate_quotes` RateDetail[], required — Exchange rate details, specified as an array of object.
    - `base_amount` Money, required — The currency and amount for a financial transaction, such as a balance or payment due.
      - `currency_code` string, ppaas_common_currency_code_v2, required — The [three-character ISO-4217 currency code](/docs/integration/direct/rest/currency-codes/) that identifies the currency.
      - `value` string, required — The value, which might be:<ul><li>An integer for currencies like `JPY` that are not typically fractional.</li><li>A decimal fraction for currencies like `TND` that are subdivided into thousandths.</li></ul>For the required number of decimal places for a currency code, see [Currency Codes](/docs/integration/direct/rest/currency-codes/).
    - `quote_amount` Money, required — The currency and amount for a financial transaction, such as a balance or payment due.
      - `currency_code` string, ppaas_common_currency_code_v2, required — The [three-character ISO-4217 currency code](/docs/integration/direct/rest/currency-codes/) that identifies the currency.
      - `value` string, required — The value, which might be:<ul><li>An integer for currencies like `JPY` that are not typically fractional.</li><li>A decimal fraction for currencies like `TND` that are subdivided into thousandths.</li></ul>For the required number of decimal places for a currency code, see [Currency Codes](/docs/integration/direct/rest/currency-codes/).
    - `exchange_rate` string, required — Conversion rate between the base and quote currencies. Includes markup if <code>markup_percent</code> is provided in the request.
    - `fx_id` string — Unique identifier that links a quoted FX rate to an order. Must be passed in further API calls.
    - `expiry_time` string, ppaas_date_time_v3 — The date and time, in [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6). Seconds are required while fractional seconds are optional.<blockquote><strong>Note:</strong> The regular expression provides guidance but does not reject all invalid dates.</blockquote>
    - `rate_refresh_time` string, ppaas_date_time_v3 — The date and time, in [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6). Seconds are required while fractional seconds are optional.<blockquote><strong>Note:</strong> The regular expression provides guidance but does not reject all invalid dates.</blockquote>
    - `update_time` string, ppaas_date_time_v3 — The date and time, in [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6). Seconds are required while fractional seconds are optional.<blockquote><strong>Note:</strong> The regular expression provides guidance but does not reject all invalid dates.</blockquote>

## Other responses

- `400` — Request is not well-formed, syntactically incorrect, or violates schema.
- `403` — The authorization failed due to insufficient permissions.
- `422` — The requested action could not be performed, semantically incorrect, or failed business validation.
- `500` — An internal server error has occurred.
- `default` — The error response.

---

[API](https://skmtc.net/paypal/apis/payments.md) · [All operations](https://skmtc.net/paypal/apis/payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paypal/payments/revisions/672aceee1190/schema)