Mit mehreren Währungen arbeiten

Stripe unterstützt die Zahlungsabwicklung in über 135 Währungen. Auf diese Weise können Sie Preise in der Landeswährung des Kunden/der Kundin anzeigen und Kosten für die Währungsumrechnung vermeiden. Die lokale Darstellung kann auch die Konversionsrate und die Autorisierungsraten von Kundinnen und Kunden verbessern.

Die Währungsumrechnung (FX) kann bei Zahlungen, Überweisungen, Auszahlungen, Plattformgebühren und anderen Arten von Transaktionen erfolgen. Währungsumrechnung findet statt, wenn die Startwährung einer Geldbewegung von der Zielwährung abweicht. Eine Zahlungswährung tritt beispielsweise auf, wenn sich die dargestellte Währung von der Abrechnungswährung unterscheidet. Bei Überweisungen tritt eine Währungsumrechnung auf, wenn das Guthaben der Plattform, die die Überweisung sendet, in einer anderen Währung angegeben ist als das Guthaben des verbundenen Kontos, auf dem die Überweisung eingeht.

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 einen Wechselkurs angeben, wenn Sie mit der dargestellten Währung Ihres Kunden/Ihrer Kundin ein PaymentIntent erstellen. 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.

Direct Charges

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 Kursnotierungen über die FX Quotes API verwenden, um die Wechselkursunsicherheit bei Direct Charges zu verringern. Wenn Sie eine Direct Charge erstellen, übergeben Sie die FX-Wechselkurs-ID an den Payment Intent. Geben Sie die Endkundenwährung 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-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 Kursnotierungen aus der FX Quotes API verwenden, um die Wechselkursunsicherheit bei Destination Charges ohne on_behalf_of zu verringern. Übergeben Sie beim Erstellen einer Zahlung die FX-Wechselkurs-ID an den Payment Intent. Im obigen Beispiel haben Sie so Gewissheit über den Wechselkurs, der für die Umrechnung von EUR (der Endkundenwährung) in USD (der Plattformwährung) verwendet wird. Geben Sie bei Wechselkursen die Währung des Kunden/der Kundin als from_currency an. Als Standard-Abrechnungswährung Ihrer Plattform geben Sie to_currency an. Sie dürfen Wechselkursnotierungen weder für Umrechnungen bei der Überweisung von der Plattform auf das verbundene Konto noch bei der Umrechnung der Plattformgebühren verwenden.

Erstellen eines Wechselkurses

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

Plattformgebühren, die mit dem Parameter application_fee_amount erhoben wurden, werden für Destination Charges nicht erneut umgerechnet. Plattformen erhalten Plattformgebühren immer in der Auszahlungswä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 Kursnotierungen aus der FX Quotes API verwenden, um die Wechselkursunsicherheit bei Destination Charges mit on_behalf_of zu verringern. Übergeben Sie beim Erstellen einer Zahlung die FX-Wechselkurs-ID an den Payment Intent. Im obigen Beispiel erhalten Sie Sicherheit über den Wechselkurs, der für die Umrechnung von USD (der Endkundenwährung) in EUR (die Währung des verbundenen Kontos) verwendet wird. Geben Sie bei Wechselkursnotierungen die Endkundenwährung 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
:" \
  -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}}

Plattformgebühren, die mit dem Parameter application_fee_amount erhoben wurden, werden für Destination Charges nicht erneut umgerechnet. Plattformen erhalten Plattformgebühren immer in der Auszahlungswä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. Falls 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

Solange das Guthaben für die angegebene Währung ausreicht, rechnet Stripe den Betrag 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 Zahlungsseite. 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 Kursnotierungen aus der FX Quotes API verwenden, um die Wechselkursunsicherheit zu verringern, wenn Sie separate Gebühren und Überweisungen ohne on_behalf_of verwenden. Dies gilt sowohl für die Zahlungsseite als auch für die eigenständige Überweisungsseite.

Wechselkurs für die Zahlung

curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
:" \
  -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-Wechselkurs-ID an den Payment Intent. Im obigen Beispiel erhalten Sie Sicherheit über den Wechselkurs, der für die Umrechnung von USD (Endkundenwährung) in GBP (Währung der Connect-Plattform) verwendet wird. Geben Sie bei Wechselkursnotierungen die Endkundenwährung als from_currency an. Als Standard-Abrechnungswährung Ihrer Plattform geben Sie to_currency an.

Übergeben Sie beim Erstellen einer Überweisung die FX-Wechselkurs-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 bei Wechselkursen 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 Plattformkontos ist GBP. Die Währungsumrechnung von USD in GBP erfolgt im Rahmen der Zahlungsseite. 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 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. Dies gilt sowohl für die Zahlungsseite als auch für die eigenständige Überweisungsseite.

FX-Angebot für die Zahlung

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

FX-Angebot für den Transfer

curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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-Wechselkurs-ID an den Payment Intent. Im obigen Beispiel erhalten Sie Sicherheit über den Wechselkurs, der für die Umrechnung von USD (Endkundenwährung) in GBP (Währung der Connect-Plattform) verwendet wird. Geben Sie bei Wechselkursnotierungen die Endkundenwährung als from_currency an. Als Standard-Abrechnungswährung Ihrer Plattform geben Sie to_currency an.

Übergeben Sie beim Erstellen einer Überweisung die FX-Wechselkurs-ID in die Überweisung. Im obigen Beispiel gibt Ihnen dies die Gewissheit, dass der Wechselkurs für die Umrechnung von GBP (Währung der Connect-Plattform) in EUR (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.

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: