# FX Quotes API in Connect verwenden Wählen Sie aus, welche Währungen lokal angepasst werden sollen, sichern Sie sich Wechselkurse und entscheiden Sie, ob Sie Gebühren an Ihre Kundschaft weitergeben möchten. Verwenden Sie die [FX Quotes API](https://docs.stripe.com/api/fx_quotes.md?api-version=2025-07-30.preview), um die Preise in den Währungen Ihrer Kunden lokal anzupassen und Unsicherheiten hinsichtlich veränderlicher Wechselkurse zu reduzieren. Sie können beim Erstellen eines [PaymentIntent](https://docs.stripe.com/api/payment_intents/create.md) mit der Transaktionswährung Ihrer Kunden ein FX Quote angeben. Sie können auch beim [Erstellen einer Übertragung](https://docs.stripe.com/api/transfers/create.md) ein FX Quote angeben, um die Zahlungsabwicklung auf dem verbundenen Konto zu bestätigen. Weitere Informationen finden Sie unter [FX Quotes](https://docs.stripe.com/api/fx_quotes.md?api-version=2025-07-30.preview). ## Beispielszenarien für Währungsumrechnungen Bei verschiedenen Connect-[Zahlungstypen](https://docs.stripe.com/connect/charges.md#types) erfolgt die Währungsumrechnung auf unterschiedliche Weise. > #### Zahlungsabwicklung in Multi-Währungen > > Wenn für das verbundene Konto die Transaktionswährung über die [Multi-Währungsabrechnung](https://docs.stripe.com/connect/multicurrency-settlement.md) aktiviert ist, rechnet Stripe in diese Währung um, anstatt die in den folgenden Beispielen beschriebene Standardwährung zu verwenden. ### Direkte Abrechnung [Direct Charges](https://docs.stripe.com/connect/direct-charges.md) werden immer aus der [Transaktionswährung](https://docs.stripe.com/currencies.md#presentment-currencies) in die Standardwährung des verbundenen Kontos umgerechnet. Die [Plattformgebühr](https://docs.stripe.com/connect/direct-charges.md#collect-fees) wird in die Standardwährung der Plattform umgerechnet. Angenommen, Sie nehmen eine Zahlung für ein verbundenes Konto in USD an. Das verbundene Konto erhält Gelder in EUR. Die an das verbundene Konto gesendeten Gelder werden in EUR umgerechnet, und die Plattformgebühr wird von EUR zurück auf Ihre Plattform in USD umgerechnet. Sie können [erweiterte Kursangebote](https://docs.stripe.com/payments/currencies/localize-prices/fx-quotes-api.md#quote-durations-and-rate-changes) über die FX Quotes API verwenden, um die Wechselkursunsicherheit bei Direct Charges zu verringern. Wenn Sie eine Direct Charge erstellen, übergeben Sie die [FX-Angebots-ID an den PaymentIntent](https://docs.stripe.com/payments/currencies/localize-prices/fx-quotes-api.md#use-localized-prices-payments). Geben Sie die Währung des Endkunden/der Endkundin als `from_currency` an. Geben Sie als `to_currency` die Standard-Abrechnungswährung Ihres verbundenen Kontos an. #### Wechselkurs erstellen ```curl curl https://api.stripe.com/v1/fx_quotes \ -u "<>:" \ -H "Stripe-Version: 2025-03-31.preview" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d to_currency=gbp \ -d "from_currencies[]=usd" \ -d "from_currencies[]=eur" \ -d lock_duration=hour \ -d "usage[type]=payment" ``` Obwohl Direct Charges in der Standardwährung des verbundenen Kontos anfallen, erhält Ihre Plattform die [Plattformgebühren](https://docs.stripe.com/api.md#application_fees) für [Direct Charges](https://docs.stripe.com/connect/direct-charges.md) in der Standardwährung Ihrer Plattform. Die Verwendung der erweiterten Kursnotierungen für Direct Charges in der FX Quotes API hat keinen Einfluss auf den Wechselkurs, zu dem Plattformgebühren umgerechnet werden. | Verfügbarkeit eines Bankkontos oder einer Debitkarte | Umrechnungsaktion | | ---------------------------------------------------- | ------------------------------------------------------------------------------------------- | | Verfügbar für die Auszahlungswährung | Keine Umrechnung | | Nicht verfügbar für die Auszahlungswährung | Stripe rechnet die Plattformgebühr basierend auf der Standardwährung des Plattformkontos um | Wenn Ihre Plattform keine Plattformgebühren erhebt und stattdessen einen Teil der Gebühren einbehält, werden diese Gelder auf die gleiche Weise ausgezahlt wie andere Zahlungen auf dem Plattformkonto. ### Destination Charges ohne on_behalf_of Wenn Stripe [Destination Charges](https://docs.stripe.com/connect/destination-charges.md) ohne `on_behalf_of` verarbeiten, rechnet Stripe diese zunächst von der [dargestellten Währung](https://docs.stripe.com/currencies.md#presentment-currencies) in die Standardwährung der Plattform um. Die an das verbundene Konto gesendeten Gelder werden dann in die Standardwährung des verbundenen Kontos umgerechnet. - Wenn Sie `application_fee_amount` verwenden, erheben wir die [Plattformgebühr](https://docs.stripe.com/connect/destination-charges.md?fee-type=application-fee#collect-fees) nach der Umrechnung in die Standardwährung des verbundenen Kontos. Die Gebühr verbleibt in dieser Währung, wenn sie der Plattform hinzugefügt wird. - Wenn Sie `transfer_data[amount]` verwenden, erheben wir die Gebühr nach der ersten Währungsumrechnung und verbleiben in der Standardwährung der Plattform. > Dieser Zahlungsablauf unterliegt den regionalen [länderübergreifenden Richtlinien](https://docs.stripe.com/connect/cross-border-payouts.md) von Stripe. Angenommen, Sie akzeptieren eine Zahlung für ein verbundenes Konto in EUR. Das verbundene Konto wird in GBP abgerechnet und Ihre Plattform in USD. Die Zahlung wird von EUR in USD umgerechnet und die an das verbundene Konto gesendeten Gelder werden in GBP umgerechnet. - Wenn Sie `application_fee_amount` verwenden, wird der Betrag der Plattformgebühr von EUR in GBP umgerechnet und wir ziehen ihn von dem Betrag ab, der auf dem verbundenen Konto abgerechnet wird. - Wenn Sie `transfer_data[amount]` verwenden, wird die Gebühr nach der Umrechnung von der anfänglichen dargestellten Währung in USD einbehalten. Sie können [erweiterte Kursangebote](https://docs.stripe.com/payments/currencies/localize-prices/fx-quotes-api.md#quote-durations-and-rate-changes) aus der FX Quotes API verwenden, um die FX-Unsicherheit bei Destination Charges ohne `on_behalf_of` zu verringern. Übergeben Sie beim Erstellen einer Zahlung die [FX-Angebots-ID an den PaymentIntent](https://docs.stripe.com/payments/currencies/localize-prices/fx-quotes-api.md#use-localized-prices-payments). Im obigen Beispiel erhalten Sie so Sicherheit über den Wechselkurs, der für die Umrechnung von EUR (der Endkundenwährung) in USD (die Plattformwährung) verwendet wird. Geben Sie bei Devisenkursen die Währung der Endkundin/des Endkunden als `from_currency` an. Als Standard-Abrechnungswährung Ihrer Plattform geben Sie `to_currency` an. Sie können Devisenkurse nicht für Umrechnungen von Übertragungen von der Plattform auf verbundene Konten oder von Plattformgebühren verwenden. #### Erstellen eines Wechselkurses ```curl curl https://api.stripe.com/v1/fx_quotes \ -u "<>:" \ -H "Stripe-Version: 2025-03-31.preview" \ -d to_currency=gbp \ -d "from_currencies[]=usd" \ -d "from_currencies[]=eur" \ -d lock_duration=hour \ -d "usage[type]=payment" \ -d "usage[payment][destination]={{CONNECTEDACCOUNT_ID}}" ``` Wir konvertieren Plattformgebühren, die mit dem Parameter `application_fee_amount` erhoben wurden, nicht erneut für [Destination Charges](https://docs.stripe.com/connect/destination-charges.md). Plattformen erhalten Plattformgebühren immer in der Abrechnungswährung des verbundenen Kontos. Verwenden Sie den Parameter `transfer_data[amount]`, um einen geringeren Teil des Transaktionsbetrags zu überweisen und Gebühren in der Standardabrechnungswährung der Plattform einzuziehen. ### Destination Charges mit on_behalf_of Wenn [Destination Charges](https://docs.stripe.com/connect/destination-charges.md) mit `on_behalf_of` verarbeitet werden, wandelt Stripe diese zunächst von der [dargestellten Währung](https://docs.stripe.com/currencies.md#presentment-currencies) in die Standardwährung des verbundenen Kontos um. Die [Plattformgebühr](https://docs.stripe.com/connect/destination-charges.md?fee-type=application-fee#collect-fees) verbleibt in der Währung des verbundenen Kontos, unabhängig davon, ob Sie `application_fee_amount` oder `transfer_data[amount]` verwenden. Beispiel: Das verbundene Konto akzeptiert eine Zahlung in USD, diese wird aber in EUR abgerechnet. Die Zahlung wird in EUR umgerechnet und wir senden sie in EUR an das verbundene Konto. Wir erheben die Gebühr in EUR, unabhängig davon, ob Sie `application_fee_amount` oder `transfer_data[amount]` verwenden. Sie können [erweiterte Kursnotierungen](https://docs.stripe.com/payments/currencies/localize-prices/fx-quotes-api.md#quote-durations-and-rate-changes) aus der FX Quotes API verwenden, um die Wechselkursunsicherheit bei Zielgebühren mit `on_behalf_of` zu reduzieren. Geben Sie beim Erstellen einer Gebühr die [FX Quote ID in die PaymentIntent](https://docs.stripe.com/payments/currencies/localize-prices/fx-quotes-api.md#use-localized-prices-payments) ein. Im obigen Beispiel erhalten Sie so Gewissheit über den Wechselkurs, der für die Umrechnung von USD (der Währung des Endkunden) in EUR (der Währung des verbundenen Kontos) verwendet wird. Geben Sie in den FX-Kursnotierungen die Währung des Endkunden als `from_currency` an. Geben Sie die Standardabrechnungswährung Ihres verbundenen Kontos als `to_currency` an. #### Erstellen eines Wechselkurses ```curl curl https://api.stripe.com/v1/fx_quotes \ -u "<>:" \ -H "Stripe-Version: 2025-03-31.preview" \ -d to_currency=gbp \ -d "from_currencies[]=usd" \ -d "from_currencies[]=eur" \ -d lock_duration=hour \ -d "usage[type]=payment" \ -d "usage[payment][on_behalf_of]={{CONNECTEDACCOUNT_ID}}" \ -d "usage[payment][destination]={{CONNECTEDACCOUNT_ID}}" ``` Wir konvertieren Plattformgebühren, die mit dem Parameter `application_fee_amount` erhoben wurden, nicht erneut für [Destination Charges](https://docs.stripe.com/connect/destination-charges.md). Plattformen erhalten Plattformgebühren immer in der Abrechnungswährung des verbundenen Kontos. Verwenden Sie den Parameter `transfer_data[amount]`, um einen geringeren Teil des Transaktionsbetrags zu überweisen und Gebühren in der Standardabrechnungswährung der Plattform einzuziehen. Wenn Sie auf der Plattform Zahlungen mit den Parametern `destination` oder `on_behalf_of` erstellen, werden möglicherweisee Salden in mehreren Währungen angesammelt. Wenn Sie nicht über Bankkonten für diese anderen Währungen verfügen, bietet Stripe eine Möglichkeit, Guthaben in Nicht-Standardwährungen auf das Standardbankkonto Ihrer Plattform auszuzahlen. Stripe rechnet die Währungen um und sie werden als [manuelle Auszahlungen](https://docs.stripe.com/connect/currencies/fx-quotes-api.md#fx-on-payouts) dargestellt, wobei `currency` als Währung des Ausgangssaldos festgelegt ist: ```curl curl https://api.stripe.com/v1/payouts \ -u "<>:" \ -d amount=1000 \ -d currency=xaf ``` Wenn das Guthaben für die angegebene Währung ausreicht, rechnet Stripe die Gelder automatisch in die Standardwährung des Bankkontos um. Die Verwendung von Wechselkursnotierungen bei Auszahlungen wird von uns nicht unterstützt. > Dieser Zahlungsablauf unterliegt den regionalen [länderübergreifenden Richtlinien](https://docs.stripe.com/connect/cross-border-payouts.md) von Stripe. ### Separate Zahlungen und Überweisungen ohne on_behalf_of Wir rechnen [separate Gebühren](https://docs.stripe.com/connect/separate-charges-and-transfers.md) von der [dargestellten Währung](https://docs.stripe.com/currencies.md#presentment-currencies) in die Standardwährung der Plattform um und die Plattform überweist die Gelder später auf das verbundene Konto. Die Parameter `application_fee_amount` und `transfer_data[amount]` werden nicht verwendet, um Gebühren einzuziehen, da die Plattform den entsprechenden zu sendenden Betrag zum Zeitpunkt der Überweisung auswählen kann. Nehmen wir als Beispiel eine Zahlung in USD. Die Standardwährung des Plattformkontos ist GBP. Die Währungsumrechnung von USD in GBP erfolgt im Rahmen der Zahlung. Wenn die Plattform diese Gelder auf ein verbundenes Konto mit EUR als Standardwährung überweist, wird eine weitere Währungsumrechnung durchgeführt, diesmal von GBP in EUR. Sie können [erweiterte Kursangebote](https://docs.stripe.com/payments/currencies/localize-prices/fx-quotes-api.md#quote-durations-and-rate-changes) aus der API für Devisenkurse verwenden, um die Unsicherheit hinsichtlich des Wechselkurses zu verringern, wenn Sie separate Zahlungen und Überweisungen ohne `on_behalf_of` verwenden. Dies gilt sowohl für die Zahlung als auch für die eigenständige Überweisung. #### Wechselkurs für die Zahlung ```curl curl https://api.stripe.com/v1/fx_quotes \ -u "<>:" \ -H "Stripe-Version: 2025-03-31.preview" \ -d to_currency=gbp \ -d "from_currencies[]=usd" \ -d "from_currencies[]=cad" \ -d lock_duration=hour \ -d "usage[type]=payment" ``` #### Wechselkurs für die Überweisung ```curl curl https://api.stripe.com/v1/fx_quotes \ -u "<>:" \ -H "Stripe-Version: 2025-03-31.preview" \ -d to_currency=eur \ -d "from_currencies[]=gbp" \ -d lock_duration=five_minutes \ -d "usage[type]=transfer" \ -d "usage[transfer][destination]={{CONNECTEDACCOUNT_ID}}" ``` Übergeben Sie beim Erstellen einer Zahlung die [FX-Angebots-ID an den PaymentIntent](https://docs.stripe.com/payments/currencies/localize-prices/fx-quotes-api.md#use-localized-prices-payments). Im obigen Beispiel erhalten Sie Sicherheit über den Wechselkurs, der für die Umrechnung von USD (der Währung der Endkundinnen/Endkunden) in GBP (die Währung der Connect-Plattform) verwendet wird. Geben Sie bei Devisenkursen die Währung der Endkundin/des Endkunden als `from_currency` an. Als Standard-Abrechnungswährung Ihrer Plattform geben Sie `to_currency` an. Wenn Sie eine Überweisung erstellen, übergeben Sie die [FX-Angebots-ID in die Überweisung](https://docs.stripe.com/payments/currencies/localize-prices/fx-quotes-api.md#use-localized-prices-payments). Im obigen Beispiel erhalten Sie Sicherheit über den Wechselkurs, der für die Umrechnung von GBP (der Währung der Connect-Plattform) in EUR (der Währung des verbundenen Kontos) verwendet wird. Geben Sie in den Wechselkursnotierungen die Währung der Connect-Plattform als `from_currency` an. Geben Sie die Standardwährung Ihres verbundenen Kontos als `to_currency` an. > Dieser Zahlungsablauf unterliegt den regionalen [länderübergreifenden Richtlinien](https://docs.stripe.com/connect/cross-border-payouts.md) von Stripe. ### Separate Zahlungen und Überweisungen mit on_behalf_of Wir rechnen [separate Zahlungen](https://docs.stripe.com/connect/separate-charges-and-transfers.md) aus der [dargestellten Währung](https://docs.stripe.com/currencies.md#presentment-currencies) in die Standardwährung des verbundenen Kontos um. Die Plattform überweist die Gelder später an das verbundene Konto. Wir verwenden die Parameter `application_fee_amount` und `transfer_data[amount]` nicht, um Gebühren einzuziehen, da die Plattform den entsprechenden zu sendenden Betrag zum Zeitpunkt der Überweisung auswählen kann. Nehmen wir als Beispiel eine Zahlung in USD. Die Standardwährung des verbundenen Kontos ist EUR. Die Währungsumrechnung von USD in EUR ist Teil der Zahlung. Während der Übertragung findet keine Währungsumrechnung statt, da sich die Gelder bereits in der Währung des verbundenen Kontos befinden. Sie können [erweiterte Kursnotierungen](https://docs.stripe.com/payments/currencies/localize-prices/fx-quotes-api.md#quote-durations-and-rate-changes) aus der FX Quote API verwenden, um die Unsicherheit hinsichtlich des Wechselkurses zu verringern, wenn Sie separate Zahlungen und Überweisungen mit `on_behalf_of` verwenden. #### Wechselkurs für die Abbuchung ```curl curl https://api.stripe.com/v1/fx_quotes \ -u "<>:" \ -H "Stripe-Version: 2025-03-31.preview" \ -d to_currency=gbp \ -d "from_currencies[]=usd" \ -d lock_duration=hour \ -d "usage[type]=payment" \ -d "usage[payment][on_behalf_of]={{CONNECTEDACCOUNT_ID}}" ``` > Dieser Zahlungsablauf unterliegt den regionalen [länderübergreifenden Richtlinien](https://docs.stripe.com/connect/cross-border-payouts.md) von Stripe. ### Wechselkurs bei Rückerstattungen Wenn Sie eine Zahlung zurückerstatten, die ursprünglich in eine andere Währung umgerechnet wurde, verwenden wir den Live-Wechselkurs zum Zeitpunkt der Rückerstattung. Dies gilt unabhängig davon, ob Sie bei der ursprünglichen Zahlung Wechselkursnotierungen verwendet haben, um Ihren Wechselkurs festzulegen. Stripe erhebt bei der Rückerstattung keine Wechselkursgebühr für Umrechnungen. Stripe [erstattet die bei der ursprünglichen Transaktion erhobene Wechselkursgebühr](https://support.stripe.com/questions/h2-2023-changes-to-currency-conversion-fees-for-refunds) nicht. ### Wechselkurs bei Auszahlungen Die Abrechnungswährung ist die Währung, in der Sie *Auszahlungen* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) erhalten können. Siehe [unterstützte Abrechnungswährungen](https://docs.stripe.com/connect/payouts-connected-accounts.md#supported-settlement). Je nach Verfügbarkeit des Bankkontos oder der Debitkarte geschieht bei der Auszahlung eines [Guthabens](https://docs.stripe.com/connect/account-balances.md) Folgendes: | Verfügbarkeit eines Bankkontos oder einer Debitkarte | Umrechnungsaktion | | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | Verfügbar für die Währung | Keine Umrechnung | | Mehrere Bankkonten oder Debitkarten für die Währung verfügbar | Keine Umrechnung – Stripe verwendet das als `default_for_currency` festgelegte Bankkonto bzw. die Debitkarte | | Nicht verfügbar für die Währung | Stripe rechnet den Auszahlungsbetrag basierend auf der Standardwährung des Stripe-Kontos um |