FX Quotes API in Connect verwenden

Verwenden Sie die FX Quotes API, um Preise in den Währungen Ihrer Kundinnen und Kunden festzulegen und Unsicherheiten in Bezug auf sich ändernde Wechselkurse zu verringern. Sie können beim Erstellen eines PaymentIntent mit der dargestellten Währung Ihres Kunden/Ihrer Kundin ein Devisenangebot angeben. Sie können beim Erstellen einer Überweisung auch einen Wechselkurs angeben, um den Abrechnungsbetrag auf dem verbundenen Konto zu bestätigen. Weitere Informationen finden Sie unter Wechselkurse.

Beispielszenarien für Währungsumrechnungen

Bei verschiedenen Connect-Zahlungstypen erfolgt die Währungsumrechnung auf unterschiedliche Weise.

Direkte Abrechnung

Direct Charges werden immer aus der Transaktionswährung in die Standardwährung des verbundenen Kontos umgerechnet. Die Plattformgebühr 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 ü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. 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 https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.basil; fx_quote_preview=v1" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_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 für Direct Charges 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.

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 ohne on_behalf_of verarbeiten, rechnet Stripe diese zunächst von der dargestellten Währung 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 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.

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 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. 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 https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.basil; fx_quote_preview=v1" \
  -d to_currency=gbp \
  -d "from_currencies[]"=usd \
  -d "from_currencies[]"=eur \
  -d lock_duration=hour \
  -d "usage[type]"=payment \
  -d "usage[payment][destination]"=
{{CONNECTED_ACCOUNT_ID}}

Wir konvertieren Plattformgebühren, die mit dem Parameter application_fee_amount erhoben wurden, nicht erneut für Destination Charges. 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 mit on_behalf_of verarbeitet werden, wandelt Stripe diese zunächst von der dargestellten Währung in die Standardwährung des verbundenen Kontos um. Die Plattformgebühr 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 Kursangebote aus der API für FX-Angebote verwenden, um die FX-Unsicherheit bei Destination Charges mit on_behalf_of zu verringern. Übergeben Sie beim Erstellen einer Zahlung die FX-Angebots-ID an den PaymentIntent. Im obigen Beispiel erhalten Sie so Sicherheit über den Wechselkurs, der für die Umrechnung von USD (der Währung der Endkundin/des Endkunden) in EUR (die Währung des verbundenen Kontos) verwendet wird. Geben Sie bei Devisenkursen die Währung der Endkundin/des Endkunden als from_currency an. Geben Sie als to_currency die Standard-Abrechnungswährung Ihres verbundenen Kontos an.

Erstellen eines Wechselkurses

curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.basil; fx_quote_preview=v1" \
  -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]"=
{{CONNECTED_ACCOUNT_ID}} \
  -d "usage[payment][destination]"=
{{CONNECTED_ACCOUNT_ID}}

Wir konvertieren Plattformgebühren, die mit dem Parameter application_fee_amount erhoben wurden, nicht erneut für Destination Charges. 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 dargestellt, wobei currency als Währung des Ausgangssaldos festgelegt ist:

curl https://api.stripe.com/v1/payouts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.

Separate Zahlungen und Überweisungen ohne on_behalf_of

Wir rechnen separate Gebühren von der dargestellten Währung 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 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 https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.basil; fx_quote_preview=v1" \
  -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 https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.basil; fx_quote_preview=v1" \
  -d to_currency=eur \
  -d "from_currencies[]"=gbp \
  -d lock_duration=five_minutes \
  -d "usage[type]"=transfer \
  -d "usage[transfer][destination]"=
{{CONNECTED_ACCOUNT_ID}}

Übergeben Sie beim Erstellen einer Zahlung die FX-Angebots-ID an den PaymentIntent. 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. 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.

Separate Zahlungen und Überweisungen mit on_behalf_of

Wir rechnen separate Zahlungen aus der dargestellten Währung 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 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 https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.basil; fx_quote_preview=v1" \
  -d to_currency=gbp \
  -d "from_currencies[]"=usd \
  -d lock_duration=hour \
  -d "usage[type]"=payment \
  -d "usage[payment][on_behalf_of]"=
{{CONNECTED_ACCOUNT_ID}}

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 nicht.

Wechselkurs bei Auszahlungen

Die Abrechnungswährung ist die Währung, in der Sie Auszahlungen erhalten können. Siehe unterstützte Abrechnungswährungen.

Je nach Verfügbarkeit des Bankkontos oder der Debitkarte geschieht bei der Auszahlung eines Guthabens Folgendes: