# Preise in manuellen Währungen Zeigen Sie Ihren Kundinnen und Kunden lokale Währungen mit Preisen in manuellen Währungen an. # Vollständige gehostete Seite > This is a Vollständige gehostete Seite for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/localize-prices/manual-currency-prices?payment-ui=stripe-hosted. Stripe unterstützt die manuelle Definition von Preisen in verschiedenen Währungen beim Erstellen von [Produkten](https://docs.stripe.com/products-prices/overview.md#get-started). Stripe empfiehlt jedoch die Verwendung von [Adaptive Pricing](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md) anstelle von manuellen Währungspreisen, um das Risiko von Wechselkursschwankungen zu reduzieren und die Unterstützung für mehr als 100 lokale Währungen automatisch zu aktivieren. Verwenden Sie in folgenden Fällen manuelle Währungspreise anstelle von Adaptive Pricing: - Adaptive Pricing wird für Ihr Unternehmen oder Ihre Checkout-Konfiguration nicht [unterstützt](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#restrictions). - Sie unterstützen eine Region, in der Sie kein Problem mit Wechselkursschwankungen haben. Manuell definierte Preise in mehreren Währungen setzen Adaptive Pricing für diese Währungen außer Kraft, auch wenn die Option aktiviert ist. > #### Lokal angepasste Preisgestaltung > > Wenn Sie [Rechnungspositionen](https://docs.stripe.com/api/invoiceitems/create.md) oder Abbuchungen mit der API erstellen, verarbeitet Stripe den Betrag und die Währung, die Sie explizit angeben. Der lokalisierte Preis wird nicht automatisch berechnet, und Sie sind dafür verantwortlich, den korrekten Betrag und die korrekte Währung für die Region Ihres Endkunden/Ihrer Endkundin anzugeben. Wir empfehlen, den Parameter [pricing.price](https://docs.stripe.com/api/invoiceitems/create.md#create_invoiceitem-pricing-price) zu verwenden, um die Preis-ID zu übergeben. ## Einen Preis mit mehreren Währungen erstellen [Dashboard] [Serverseitig] #### Dashboard 1. Gehen Sie zu einem Produkt im [Dashboard](https://dashboard.stripe.com/products?active=true). 1. Klicken Sie auf **+Weiteren Preis hinzufügen**, um einen neuen Preis zu erstellen. 1. Geben Sie den Preis ein und wählen Sie eine Währung aus. Die erste Währung ist die Standardwährung des Preises. Stellen Sie sicher, dass alle Ihre Preise dieselbe Standardwährung haben. 1. Klicken Sie auf **+Preis nach Währung hinzufügen**, um unterstützte Währungen zu suchen, auszuwählen und zu Ihrem Preis hinzuzufügen. 1. Verwenden Sie den von Ihnen erstellten Preis mit mehreren Währungen, indem Sie seine ID an die [Posten](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items-price) weitergeben, wenn Sie eine Checkout-Sitzung erstellen. #### API Fügen Sie einem Preis mehrere Währungen hinzu, indem Sie bei Verwendung der [Prices API](https://docs.stripe.com/api/prices/object.md#price_object-currency_options) `currency_options` angeben. ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d currency=usd \ -d unit_amount=1000 \ -d "currency_options[eur][unit_amount]=950" \ -d "currency_options[jpy][unit_amount]=1500" \ -d "product_data[name]=My Product" ``` In diesem Beispiel wird der Preis in USD erstellt, mit zusätzlichen Währungsoptionen in EUR und JPY. ## Checkout-Sitzung erstellen [Serverseitig] Erstellen Sie eine Checkout-Sitzung mit dem Preis in mehreren Währungen: ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` ## Testen [Serverseitig] [Clientseitig] Um die Darstellung der Landeswährung für Checkout, Payment Links und die [Preistabelle](https://docs.stripe.com/payments/checkout/pricing-table.md) zu testen, übergeben Sie eine für einen Standort formatierte Kunden-E-Mail-Adresse, die ein Suffix enthält, im Format `+location_XX` im lokalen Teil der E-Mail. `XX` muss ein gültiger [aus zwei Buchstaben bestehender ISO-Ländercode](https://www.nationsonline.org/oneworld/country_code_list.htm) sein. Beispiel: Um eine Währungsdarstellung für eine Kundin/einen Kunden in Frankreich zu testen, übergeben Sie eine E-Mail-Adresse wie `test+location_FR@example.com`. Wenn Sie die URL für eine Checkout-Sitzung, einen Payment Link oder eine Preistabelle aufrufen, die mit einer nach Standort formatierten E-Mail-Adresse erstellt wurde, sehen Sie für das angegebene Land die gleiche Währung wie eine Kundin/ein Kunde. ### Checkout testen Wenn Sie Checkout für ein bestimmtes Land simulieren möchten, erstellen Sie eine Checkout-Sitzung und übergeben dort die für den Standort formatierte E-Mail-Adresse als [customer_email](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_email). ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u <>: \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=1 \ -d mode=payment \ -d success_url="https://example.com/success" \ --data-urlencode customer_email="test+location_FR@example.com" ``` Sie können auch eine neue Kundin oder einen neuen Kunden erstellen und eine E-Mail-Adresse angeben, die das Suffix `+location_XX` enthält. Stripe-Testkarten funktionieren wie üblich. Wenn es möglich ist, die lokale Währung der Kundin/des Kunden in Checkout darzustellen, wird das [Checkout Session](https://docs.stripe.com/api/checkout/sessions/object.md)-Objekt geändert. Felder wie `currency`, `payment_method_types` und `amount_total` spiegeln die Landeswährung und den Preis vor Ort wider. ### Payment Links testen Übergeben Sie für Payment Links die für den Standort formatierte E-Mail-Adresse als [URL-Parameter](https://docs.stripe.com/payment-links/customize.md#customize-checkout-with-url-parameters) der `prefilled_email`, um die Währungsdarstellung für Kundinnen und Kunden in verschiedenen Ländern zu testen. ### Preistabelle testen Übergeben Sie für die Preistabelle die für den Standort formatierte E-Mail-Adresse als Attribut [customer-email](https://docs.stripe.com/payments/checkout/pricing-table.md#customer-email), um die Währungsdarstellung für Kundinnen und Kunden in verschiedenen Ländern zu testen. ## Optional: Eine Währung angeben [Serverseitig] Wenn Sie Preise mit Multi-Währungen in einer Sitzung verwenden, übernimmt Checkout automatisch die Lokalisierung der Währung für Ihre Kundinnen/Kunden. Sie können dieses Verhalten jedoch außer Kraft setzen, indem Sie bei der Erstellung der Checkout-Sitzung eine Währung angeben. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d currency=eur \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` In diesem Beispiel ist die Währung der Checkout-Sitzung unabhängig vom Kundenstandort immer EUR (`eur`). ## Durch Angebot lokaler Zahlungsmethoden Die Checkout-Sitzung bietet Kundinnen/Kunden beliebte Zahlungsmethoden an, die mit ihren Landeswährungen kompatibel sind. Für Kundinnen/Kunden in den Niederlanden beispielsweise rechnet die Checkout Session Preise in EUR um und bietet außerdem beliebte niederländische Zahlungsmethoden wie iDEAL an. Sie können in Ihren [Einstellungen für Zahlungsmethoden](https://dashboard.stripe.com/settings/payment_methods) konfigurieren, welche Zahlungsmethoden Sie akzeptieren. ## Preistabellen Preise mit manuellen Währungen können auch mit [Preistabellen](https://docs.stripe.com/payments/checkout/pricing-table.md) verwendet werden, Um Kundinnen und Kunden, die Ihre Preistabelle ansehen, lokale Währungen anzuzeigen, müssen alle Preise der Preistabelle die lokale Währung des Kunden/der Kundin in ihren `currency_options` enthalten. Wenn Sie Stripe Tax verwenden, müssen sie zudem ein `tax_behavior` für die angegebene Währung enthalten. ## Unterstützte Integrationen Checkout zeigt Kundinnen und Kunden automatisch die Landeswährung an, wenn alle folgenden Punkte zutreffen: - Die relevante Währung der Preise, Versandraten und Rabatte der Checkout-Sitzung ist in den `currency_options` angegeben. - Wenn ein Preis der Checkout-Sitzung ein Upselling hat, ist die relevante Währung des Preises in den `currency_options` des Upselling enthalten. - Bei einer Checkout-Sitzung mit Stripe Tax wird das `tax_behavior` der Checkout-Sitzung in der relevanten Währung für alle Preise, Versandraten und Rabatte der Checkout-Sitzung angegeben. - Sie haben bei der Erstellung der Checkout-Sitzung keine Währung angegeben. Wenn Checkout die Währung nicht lokalisieren kann, weil die entsprechende Währungsoption oder `tax_behavior` fehlt, wird die Sitzung dem Kunden/der Kundin in der Standardwährung angezeigt. Die Standardwährung muss für alle Preise, Versandraten und Rabatte gleich sein. ### Einschränkungen Die Preislokalisierung ist für Checkout-Sitzungen nicht verfügbar, für die Folgendes gilt: - Verwenden Sie manuelle Steuersätze. - Verwenden Sie `payment_intent_data.application_fee_amount` oder `payment_intent_data.transfer_data.amount` . ## Gebühren Für automatisch umgerechnete Transaktionen gelten die Standard-Transaktionsgebühren von Stripe: - Gebühr für Karten oder Zahlungsmethoden - Gebühr für internationale Karten oder Zahlungsmethoden (falls anfallend) - Gebühr für die Währungsumrechnung Weitere Informationen zu diesen Gebühren finden Sie auf der [Preisseite](https://stripe.com/pricing). # Vollständige eingebettete Seite > This is a Vollständige eingebettete Seite for when payment-ui is embedded-page. View the full page at https://docs.stripe.com/payments/checkout/localize-prices/manual-currency-prices?payment-ui=embedded-page. Stripe unterstützt die manuelle Definition von Preisen in verschiedenen Währungen beim Erstellen von [Produkten](https://docs.stripe.com/products-prices/overview.md#get-started). Stripe empfiehlt jedoch die Verwendung von [Adaptive Pricing](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md) anstelle von manuellen Währungspreisen, um das Risiko von Wechselkursschwankungen zu reduzieren und die Unterstützung für mehr als 100 lokale Währungen automatisch zu aktivieren. Verwenden Sie in folgenden Fällen manuelle Währungspreise anstelle von Adaptive Pricing: - Adaptive Pricing wird für Ihr Unternehmen oder Ihre Checkout-Konfiguration nicht [unterstützt](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#restrictions). Wenden Sie sich an [adaptive-pricing-beta@stripe.com](mailto:adaptive-pricing-beta@stripe.com), um zu erfahren, ob Sie an der Vorschau teilnehmen möchten. - Sie unterstützen eine Region, in der Sie kein Problem mit Wechselkursschwankungen haben. Manuell definierte Preise in mehreren Währungen setzen Adaptive Pricing für diese Währungen außer Kraft, auch wenn die Option aktiviert ist. > #### Lokal angepasste Preisgestaltung > > Wenn Sie [Rechnungspositionen](https://docs.stripe.com/api/invoiceitems/create.md) oder Abbuchungen mit der API erstellen, verarbeitet Stripe den Betrag und die Währung, die Sie explizit angeben. Der lokalisierte Preis wird nicht automatisch berechnet, und Sie sind dafür verantwortlich, den korrekten Betrag und die korrekte Währung für die Region Ihres Endkunden/Ihrer Endkundin anzugeben. Wir empfehlen, den Parameter [pricing.price](https://docs.stripe.com/api/invoiceitems/create.md#create_invoiceitem-pricing-price) zu verwenden, um die Preis-ID zu übergeben. ## Einen Preis mit mehreren Währungen erstellen [Dashboard] [Serverseitig] #### Dashboard 1. Gehen Sie zu einem Produkt im [Dashboard](https://dashboard.stripe.com/products?active=true). 1. Klicken Sie auf **+Weiteren Preis hinzufügen**, um einen neuen Preis zu erstellen. 1. Geben Sie den Preis ein und wählen Sie eine Währung aus. Die erste Währung ist die Standardwährung des Preises. Stellen Sie sicher, dass alle Ihre Preise dieselbe Standardwährung haben. 1. Klicken Sie auf **+Preis nach Währung hinzufügen**, um unterstützte Währungen zu suchen, auszuwählen und zu Ihrem Preis hinzuzufügen. 1. Verwenden Sie den von Ihnen erstellten Preis mit mehreren Währungen, indem Sie seine ID an die [Posten](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items-price) weitergeben, wenn Sie eine Checkout-Sitzung erstellen. #### API Fügen Sie einem Preis mehrere Währungen hinzu, indem Sie bei Verwendung der [Prices API](https://docs.stripe.com/api/prices/object.md#price_object-currency_options) `currency_options` angeben. ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d currency=usd \ -d unit_amount=1000 \ -d "currency_options[eur][unit_amount]=950" \ -d "currency_options[jpy][unit_amount]=1500" \ -d "product_data[name]=My Product" ``` In diesem Beispiel wird der Preis in USD erstellt, mit zusätzlichen Währungsoptionen in EUR und JPY. ## Checkout-Sitzung erstellen [Serverseitig] Erstellen Sie eine Checkout-Sitzung mit dem Preis in mehreren Währungen: ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` ## Testen [Serverseitig] [Clientseitig] Um die Darstellung der Landeswährung zu testen, übergeben Sie eine für einen Standort formatierte Kunden-E-Mail-Adresse, die im lokalen Teil der E-Mail ein Suffix im Format `+location_XX` enthält. `XX` muss ein gültiger [zweistelliger ISO-Ländercode](https://www.nationsonline.org/oneworld/country_code_list.htm) sein. Um beispielsweise die Währungsdarstellung für einen Kunden/eine Kundin in Frankreich zu testen, übergeben Sie eine E-Mail-Adresse wie `test+location_FR@example.com`. Wenn Sie die URL für eine Checkout-Sitzung aufrufen, die mit einer für den Standort formatierten E-Mail-Adresse erstellt wurde, sehen Sie die gleiche Währung wie ein Kunde/eine Kundin im angegebenen Land. Wenn Sie eine Checkout-Sitzung erstellen, übergeben Sie die für den Standort formatierte E-Mail-Adresse als [customer_email](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_email), um ein bestimmtes Land zu simulieren. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u <>: \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=1 \ -d mode=payment \ -d ui_mode=embedded_page \ -d return_url="https://example.com/return" \ --data-urlencode customer_email="test+location_FR@example.com" ``` Sie können auch eine neue Kundin oder einen neuen Kunden erstellen und eine E-Mail-Adresse angeben, die das Suffix `+location_XX` enthält. Stripe-Testkarten funktionieren wie üblich. Wenn es möglich ist, die lokale Währung des Kunden/der Kundin darzustellen, ändert sich das [Checkout Session](https://docs.stripe.com/api/checkout/sessions/object.md)-Objekt. Felder wie `currency`, `payment_method_types` und `amount_total` spiegeln die lokale Währung und den Preis wider. ## Optional: Eine Währung angeben [Serverseitig] Wenn Sie Preise in mehreren Währungen verwenden, übernimmt die Checkout-Sitzung automatisch die Währungslokalisierung für Ihre Kundinnen/Kunden. Sie können dieses Verhalten jedoch außer Kraft setzen, indem Sie beim Erstellen der Checkout-Sitzung eine Währung angeben. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d currency=eur \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` In diesem Beispiel ist die Währung der Checkout-Sitzung unabhängig vom Kundenstandort immer EUR (`eur`). ## Durch Angebot lokaler Zahlungsmethoden Die Checkout-Sitzung bietet Kundinnen/Kunden beliebte Zahlungsmethoden an, die mit ihren Landeswährungen kompatibel sind. Für Kundinnen/Kunden in den Niederlanden beispielsweise rechnet die Checkout Session Preise in EUR um und bietet außerdem beliebte niederländische Zahlungsmethoden wie iDEAL an. Sie können in Ihren [Einstellungen für Zahlungsmethoden](https://dashboard.stripe.com/settings/payment_methods) konfigurieren, welche Zahlungsmethoden Sie akzeptieren. ## Unterstützte Integrationen Checkout zeigt Kundinnen und Kunden automatisch die Landeswährung an, wenn alle folgenden Punkte zutreffen: - Die relevante Währung der Preise, Versandraten und Rabatte der Checkout-Sitzung ist in den `currency_options` angegeben. - Wenn ein Preis der Checkout-Sitzung ein Upselling hat, ist die relevante Währung des Preises in den `currency_options` des Upselling enthalten. - Bei einer Checkout-Sitzung mit Stripe Tax wird das `tax_behavior` der Checkout-Sitzung in der relevanten Währung für alle Preise, Versandraten und Rabatte der Checkout-Sitzung angegeben. - Sie haben bei der Erstellung der Checkout-Sitzung keine Währung angegeben. Wenn Checkout die Währung nicht lokalisieren kann, weil die entsprechende Währungsoption oder `tax_behavior` fehlt, wird die Sitzung dem Kunden/der Kundin in der Standardwährung angezeigt. Die Standardwährung muss für alle Preise, Versandraten und Rabatte gleich sein. ### Einschränkungen Die Preislokalisierung ist für Checkout-Sitzungen nicht verfügbar, für die Folgendes gilt: - Verwenden Sie manuelle Steuersätze. - Verwenden Sie `payment_intent_data.application_fee_amount` oder `payment_intent_data.transfer_data.amount` . ## Gebühren Für automatisch umgerechnete Transaktionen gelten die Standard-Transaktionsgebühren von Stripe: - Gebühr für Karten oder Zahlungsmethoden - Gebühr für internationale Karten oder Zahlungsmethoden (falls anfallend) - Gebühr für die Währungsumrechnung Weitere Informationen zu diesen Gebühren finden Sie auf der [Preisseite](https://stripe.com/pricing).