Struct ExchangeRate

pub struct ExchangeRate {
    pub id: ExchangeRateId,
    pub rates: HashMap<String, f64>,
}

ExchangeRate objects allow you to determine the rates that Stripe is currently using to convert from one currency to another. Since this number is variable throughout the day, there are various reasons why you might want to know the current rate (for example, to dynamically price an item for a user with a default payment in a foreign currency).

Please refer to our Exchange Rates API guide for more details.

[Note: this integration path is supported but no longer recommended] Additionally, you can guarantee that a charge is made with an exchange rate that you expect is current. To do so, you must pass in the exchange_rate to charges endpoints. If the value is no longer up to date, the charge won’t go through. Please refer to our Using with charges guide for more details.

---

 

This Exchange Rates API is a Beta Service and is subject to Stripe’s terms of service. You may use the API solely for the purpose of transacting on Stripe. For example, the API may be queried in order to:.

• localize prices for processing payments on Stripe
• reconcile Stripe transactions
• determine how much money to send to a connected account
• determine app fees to charge a connected account

Using this Exchange Rates API beta for any purpose other than to transact on Stripe is strictly prohibited and constitutes a violation of Stripe’s terms of service..

Fields

id: ExchangeRateId

Unique identifier for the object. Represented as the three-letter ISO currency code in lowercase.

rates: HashMap<String, f64>

Hash where the keys are supported currencies and the values are the exchange rate at which the base id currency converts to the key currency.

Trait Implementations

impl Clone for ExchangeRate

fn clone(&self) -> ExchangeRate

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExchangeRate

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deserialize for ExchangeRate

fn begin(out: &mut Option<Self>) -> &mut dyn Visitor

The only correct implementation of this method is:

impl FromValueOpt for ExchangeRate

fn from_value(v: Value) -> Option<Self>

impl Object for ExchangeRate

type Id = ExchangeRateId

The canonical id type for this object.

fn id(&self) -> &Self::Id

The id of the object.

fn into_id(self) -> Self::Id

The owned id of the object.

impl ObjectDeser for ExchangeRate

type Builder = ExchangeRateBuilder