Preise in manuellen Währungen

Add multiple currencies to a price

You can manually add multiple currencies to a Price using the Dashboard or the API.

Dashboard

1. Navigate to a product in the Dashboard.
2. Click +Add another price to create a new price.
3. Fill in the price and select a currency. This first currency is the price’s default currency. Make sure all of your prices have the same default currency.
4. Click +Add a price by currency to search and select from supported currencies, adding them to your price.
5. Use the multi-currency price you created by passing its ID into line items when you create a Checkout Session.

Preis-API

Add multiple currencies to a Price by specifying currency_options when using the Prices API.

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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 this example, the Price is created in USD, with additional currency options in EUR and JPY.

Local payment methods

Checkout und Payment Links bieten Kundinnen und Kunden beliebte Zahlungsmethoden an, die mit ihren Landeswährungen kompatibel sind.

For example, for customers located in the Netherlands, Checkout and Payment Links convert prices to EUR and also present popular Dutch payment methods like iDEAL.

Sie können in Ihren Einstellungen für Zahlungsmethoden konfigurieren, welche Zahlungsmethoden Sie akzeptieren.

Preistabellen

Preise mit manuellen Währungen können auch mit Preistabellen 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.

Supported integrations

Checkout automatically presents the local currency to customers if all of the following are true:

• The Checkout Session’s prices, shipping rates, and discounts have the relevant currency in their currency_options.
• If a price on the Checkout Session has an upsell, the upsell’s price has the relevant currency in its currency_options.
• For a Checkout Session using Stripe Tax, the tax_behavior on the Checkout Session is specified for the relevant currency for all of the Checkout Session’s prices, shipping rates, and discounts.
• You didn’t specify a currency during Checkout Session creation.

If Checkout can’t localize the currency because the relevant currency option or tax_behavior is missing, the Session presents to the customer in the default currency. The default currency must be the same across all prices, shipping rates, and discounts.

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 .

Fees

Stripe’s standard transaction fees apply to automatically converted transactions:

• Gebühr für Karten oder Zahlungsmethoden
• Gebühr für internationale Karten oder Zahlungsmethoden (falls anfallend)
• Gebühr für die Währungsumrechnung

See the pricing page for more details about these fees.

Währung angeben

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 https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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).

Testen

Um die Darstellung der Landeswährung für Checkout, Payment Links und die Preistabelle 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 sein.

For example, to test currency presentment for a customer in France, pass in an email such as 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.

curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -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 Kundin/einen Kunden erstellen und ihre/seine 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-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 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, um die Währungsdarstellung für Kundinnen und Kunden in verschiedenen Ländern zu testen.