Preise lokal anpassenÖffentliche Vorschau

Bei Verkäufen in einem ausländischen Markt verbessert die Verwendung der lokalen Währung des Kunden/der Kundin die Konversionsraten der Kundinnen/Kunden und die Autorisierungsraten für Zahlungen. Bei diesem Ansatz müssen Sie jedoch mehrere Faktoren berücksichtigen:

• Die entsprechenden Fremdwährungsbeträge werden vor dem Checkout auf Ihrer Website angezeigt.
• Die aktuellen Wechselkurse und Wechselkursgebühren (FX) für Transaktionen.
• Der Betrag, der Ihrem Stripe-Saldo in Ihrer Währung gutgeschrieben wird.
• Die Häufigkeit von Wechselkursänderungen und wann lokal angepasste Preise zu aktualisieren sind.

Die FX Quotes API von Stripe trägt diesen Überlegungen Rechnung, indem sie Folgendes bietet:

• Aktuelle Wechselkurse: Der aktuelle Wechselkurs von Stripe für ein bestimmtes Währungspaar.
• Erweiterte Wechselkursnotierungen: Kursnotierungen gelten für Zeiträume von 5 Minuten, 1 Stunde und 24 Stunden, wodurch die Unsicherheit aufgrund von Wechselkursschwankungen verringert wird.
• Informationen zu FX-Gebühren: Details zu den FX-Gebühren von Stripe für Ihre Transaktionen, damit Sie die Abrechnungsbeträge vor den Zahlungskosten abschätzen können.

Terms of use

By using the FX Quotes service, you agree to these Terms of Service.

As part of using FX Quotes you agree and understand:

• FX Quotes is currently offered as a preview service. This means Stripe offers the service “as is” and disclaims all expressed or implied warranties and guarantees around this service. You’re relying on a preview service at your own risk and Stripe isn’t liable for losses, damages, or costs arising that relate to the accuracy of the preview service.
• FX Quotes might provide you with a quote for a specific currency pair that’s valid for a time in the future. This is called an Extended Rate Quote. This quote isn’t an offer to enter into foreign exchange, and we can withdraw it at any time.
• Use of FX Quotes and Extended Rate Quotes must be used as part of a commercial transaction of goods and services you sell on Stripe.
• Extended Rate Quotes can help you manage general uncertainty in foreign exchange (FX) rates. You’re not permitted to use Extended Rate Quotes only in instances where the market FX rate is less favorable than the Extended Rate Quote.
• Stripe might add or remove supported currencies from FX Quotes at any time, without notice.

Verfügbar in Preview

Setup to use FX Quotes

If you’re using the SDK, refer to SDK versioning to add configurations to access preview features. If you’re not using the SDK and calling the API endpoints directly, specify a beta header along with your API version in the API call

require 'stripe'
Stripe.api_key = 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
Stripe.api_version = '2025-03-31.basil'
Stripe.add_beta_version("fx_quote_preview", "v1")

Den optimalen lokal angepassten Preis festlegen

Möglicherweise möchten Sie Ihre ortsgebundenen Preise für andere Länder auf der Grundlage dessen festlegen, was Sie inländischen Kundinnen/Kunden in Rechnung stellen würden. Sie können die von FX Quotes bereitgestellten Kurse verwenden, um Ihre inländischen Preise in die Landeswährung anderer Länder umzurechnen. Ziehen Sie in Erwägung, Preise und lokale Marktpreise zu runden, wenn Sie sich für Ihre Preise in der Region entscheiden.

Um sicherzustellen, dass die Gelder, die Sie für eine Transaktion erhalten, in allen Märkten konsistent bleiben, können Sie die Währungsumrechnungsgebühr von Stripe an den Kunden/die Kundin weitergeben. Beispiel: Ein amerikanischer Händler möchte sein Produkt im Wert von 100 USD in Frankreich verkaufen. Um den entsprechenden Preis in Euro zu berechnen, verwenden Sie den Parameter exchange_rate, um die Währungsumrechnungsgebühr an die Kundin/den Kunden weiterzugeben. Wenn Sie diese Gebühr nicht weitergeben möchten, verwenden Sie den Parameter base_rate. Die folgende FX Quotes-Beispielantwort zeigt einen Devisenkurs, der erstellt wurde, um Preise, die in der lokalen Währung EUR angezeigt werden, in Ihre Abrechnungswährung USD umzurechnen:

{
  "id": "fxq_1R6BWhL05bA97JHQELB5EROs",
  "object": "fx_quote",
  "created": 1742824731,
  "lock_duration": "five_minutes",
  "lock_expires_at": 1742825031,
  "lock_status": "active",
  "to_currency": "usd",
  "rates": {
    "eur": {
      "exchange_rate": 1.06053,
      "rate_details": {
        "base_rate": 1.08295,
        "duration_premium": 0.0007,
        "fx_fee_rate": 0.02,
        "reference_rate": 1.0827,
        "reference_rate_provider": "ecb"
      }
    }
  },
  "usage": {
    "payment": {
      "destination": null,
      "on_behalf_of": null
    },
    "transfer": null,
    "type": "payment"
  }
}

Um die FX-Gebühr an den Kunden/die Kundin weiterzugeben, nehmen Sie in diesem Beispiel den Produktpreis 100 USD, dividiert durch den Wechselkurs (1,0791), um den Kurs in Euro zu erhalten92.67 EUR. Wenn Sie die Wechselkursgebühr nicht weitergeben möchten, nehmen Sie den Produktpreis 100 USD und dividieren Sie ihn durch den Basiskurs (1,09) für den Euro-Kurs 91.74 EUR. Beachten Sie, dass bei grenzüberschreitenden Transaktionen je nach Region und Zahlungsmethode auch eine Gebühr für internationale Zahlungsmethoden erhoben wird. Weitere Informationen finden Sie auf der Preisseite von Stripe.

Angebotslaufzeiten und Änderungen an den Raten

Wenn Sie Ihre Preise mithilfe von Wechselkursinformationen lokalisieren, die von der FX Quotes API bereitgestellt werden, möchten Sie möglicherweise sicher sein, wie lange ein bestimmter Kurs gültig ist. Die FX Quotes API bietet drei Zeiträume für lock_duration: five_minutes, hour und day. Diese Zeitspanne gibt an, dass Ihre Transaktion zum notierten Wechselkurs umgerechnet wird, solange Sie den angegebenen Kurs verwenden, bevor er abläuft, wie durch lock_expires_at angegeben.

Die FX Quotes API bietet außerdem Wechselkursinformationen für den aktuellen Live-Wechselkurs von Stripe. Wählen Sie dazu lock_duration = none. Wenn eine lock_duration, die nicht none ist, zum Erstellen eines Kursangebots verwendet wird, enthält das Feld base_rate einen Aufschlag für den erweiterten Kurs. Um den richtigen erweiterten Zeitraum für die Kursnotierung zu bestimmen, sollten Sie den lokalen Preisaktualisierungsrhythmus und die Dauer des Bezahlvorgangs berücksichtigen.

Auf den Devisenmärkten kann es zu Schwankungen kommen, die unsere Fähigkeit beeinträchtigen, einen bestimmten Kurs beizubehalten. Devisenkurse, die für Zahlungen erstellt werden, haben eine Kursschwelle von 3,5 % und solche für Überweisungen haben einen Kursschwelle von 1 %. Alle Kursangebote, die diese Schwellenwerte überschreiten, werden ungültig und lock_status ändert sich in expired.

Wenn Sie ein abgelaufenes Angebot für einen PaymentIntent oder eine Überweisung verwenden, erhalten Sie einen der folgenden error.code: payment_intent_fx_quote_invalid oder transfers_fx_quote_invalid. Mit diesen Fehlercodes können Sie abgelaufene Angebote bearbeiten.

Zahlungen mit lokalisierten Preisen tätigen

Nehmen wir an, Sie sind ein/e im Vereinigten Königreich ansässige/r Händler/in, der/die an Kundschaft in den USA verkauft, und Sie möchten garantieren, dass Sie auch bei Verkäufen an US-Kundinnen/Kunden und unabhängig von Wechselkursänderungen 100 GBP erhalten. In diesem Szenario empfehlen wir, einen Wechselkurstarif mit dem lock_duration-Wert hour abzurufen:

curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-03-31.basil; fx_quote_preview=v1" \
  -d to_currency=gbp \
  -d "from_currencies[]"=eur \
  -d lock_duration=day

Verwenden Sie den neuesten Wechselkurstarif, um Preise zu jedem Zeitpunkt während Ihrer Customer Journey zu lokalisieren, in dem Wissen, dass Ihr Wechselkurs für die nächste Stunde fest ist. Wenn Sie 100 GBP erhalten möchten, wenn das Wechselkursfeld für USD 0,8 beträgt, dividieren Sie den GBP-Preis 100 GBP durch den Wechselkurs, um einen Betrag von 125 USD zu erhalten.

Dieser Betrag von 125 USD kann an die Payment Intents API übergeben werden, um die Zahlung mit dem fx_quote-Parameter vorzunehmen:

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-03-31.basil; fx_quote_preview=v1" \
  -d amount=125 \
  -d currency=usd \
  -d fx_quote=fxq_1QBck4FTKRd55CNDdboZYz9g

Umgang mit kleineren Einheiten

Alle API-Anfragen erwarten amount-Werte in der Untereinehit der Währung. Nachdem Sie die von der FX Quotes API bereitgestellten Kurse verwendet haben, konvertieren Sie den resultierenden umgerechneten Betrag in die Untereinheiten von Stripe. Weitere Informationen finden Sie unter Untereinheiten in API-Beträgen und Währungen ohne Dezimalstellen.

Umrechnung bei angefochtenen Zahlungen und Rückerstattungen

Wenn eine währungsumgerechnete Zahlung, für die ein Devisenkurs verwendet wurde, angefochten oder zurückerstattet wird, wird der Betrag, den Sie erhalten haben, zum aktuellen Wechselkurs zurück in die Transaktionswährung umgerechnet. Wechselkurse schwanken mit dem Markt, sodass der bei der Zahlung verwendete Wechselkurs häufig von dem Wechselkurs zum Zeitpunkt einer angefochtenen Zahlung oder Rückerstattung abweicht. Der Betrag, der von Ihrem Händlerguthaben abgezogen wird, hängt vom aktuellen Kurs ab und kann höher oder niedriger als die ursprüngliche Zahlung ausfallen. Dem Kunden/der Kundin wird immer genau der gezahlte Betrag und die Währung zurückerstattet, in der er/sie bezahlt hat, unabhängig von Kursschwankungen.

Ablauf der Kursnotierung handhaben

Stripe sendet den Webhook fx_quote.expired, wenn eine Kursnotierung aufgrund des Ablaufs oder wegen erheblicher Kursabweichungen ungültig wird. Das Anhängen eines bereits abgelaufenen FX Quote-Objekts an die PaymentIntent API oder die Transfer API führt zu einer 400-Antwort. Wir empfehlen, das Webhook-Ereignis fx_quote.expired zu abonnieren und nach Empfang des Ereignisses einen neuen Devisenkurs zu erstellen, damit ortsgebundene Preise basierend auf dem neuen FX Quote-Objekt aktualisiert werden können.

Ausweichlösung für den Mid-Market-Kurs

Bei einigen kartenlosen Zahlungsmethoden dauert die Verarbeitung von Zahlungen länger als eine Sperrfrist von 24 Stunden abdeckt. Für diese Zahlungen kann der Devisenkurs aufgrund erheblicher Änderungen des Mittelkurses ablaufen oder unbrauchbar werden. In diesen Fällen verwenden wir den Mittelkurs zur Abwicklung der Zahlung.

Aufschlag

Wir erheben keine Gebühren für die Verwendung von FX Quotes mit einer Sperrdauer von none. Stripe erhebt einen Aufschlag für die Verwendung erweiterter Kursnotierungen. Mit diesem Aufschlag können wir das Risiko und die Kosten abdecken, die durch das Angebot erweiterter Kursnotierungen entstehen. Die genauen Kosten werden durch die lock_duration und das Währungspaar in der Währungsumrechnung bestimmt.

Für ein bestimmtes Währungspaar wird die höhere Prämie der beiden verwendet, wenn die Währungen unterschiedliche Prämien haben. Zum Beispiel hat ein USD-KRW-Währungspaar mit einer Dauer von 1 Stunde einen Aufschlag von 0,15 %. Wenn beide Währungen zur gleichen Gruppe gehören, wird die Fremdwährungsgebühr für diese Gruppe erhoben.

Devisenkurse unterstützen nur die Währungen der folgenden zwei Gruppen: