# Adaptive Pricing
Ermöglichen Sie es Ihren Kundinnen und Kunden mit Adaptive Pricing in ihrer Landeswährung zu zahlen.
# Elements
> Adaptive Pricing wird nur für Elements mit Checkout Sessions unterstützt. Adaptive Pricing wird auf der Payment Intents API nicht unterstützt.
Mit Adaptive Pricing können Ihre Kundinnen und Kunden in mehr als [150 Ländern](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#supported-currencies) in ihrer lokalen Währung zahlen. Mit Adaptive Pricing leitet Stripe automatisch die Transaktionswährung von der öffentlichen IP-Adresse des Kunden ab. Dann berechnet Stripe automatisch den lokalisierten Preis und wickelt die gesamte Währungsumrechnung ab.
Mit Adaptive Pricing können Sie:
- Zeigen Sie mit dem [Währungsauswahlelement](https://docs.stripe.com/elements/currency-selector-element.md) Preise in lokaler Währung basierend auf dem Standort an
- Berechnen Sie die Preise in Echtzeit mit einem für 24 Stunden garantierten Wechselkurs
- Auch lokale Zahlungsmethoden anderer Länder anbieten
- Einhaltung von Vorschriften bei der Angabe unterstützter Währungen erleichtern
#### Integrationsaufwand
Complexity: 2/5
#### Transaktionsgebühren
Informationen zu [Gebühren und unseren FAQs](https://support.stripe.com/questions/adaptive-pricing) anzeigen.
#### Anpassung der Nutzeroberfläche
Platzieren Sie das [Währungsauswahlelement](https://docs.stripe.com/elements/currency-selector-element.md) an einer beliebigen Stelle auf der Bezahlseite.
## Adaptive Pricing im Dashboard aktivieren [Dashboard]
Verwalten Sie Adaptive Pricing für Checkout in Ihren [Payments-Einstellungen](https://dashboard.stripe.com/settings/adaptive-pricing) im Dashboard. Sie können Adaptive Pricing im Sandbox- als auch im Live-Modus aktivieren. Die Deaktivierung von Adaptive Pricing hat keine Auswirkungen auf Checkout-Sitzungen, die bereits konvertiert wurden.
## Preise lokalisieren und formatieren [Clientseitig]
Es ist wichtig, dass die Preise auf Ihrer Bezahlseite einheitlich entsprechend der ausgewählten Währung angezeigt werden, einschließlich Einzelposten, Versandkosten, Rabatte, Steuern und Gesamtsummen.
Bei der Verwendung von Elements mit Adaptive Pricing kann das Elements-[Session-Objekt](https://docs.stripe.com/js/custom_checkout/session_object) lokalisierte Werte enthalten, wenn Adaptive Pricing aktiv ist. Sie sollten Ihre Integration so gestalten, als könnte die Session Beträge und Währungen enthalten, die für jedes Land relevant sind, aus dem Ihre Käufer/innen Ihre Website besuchen könnten. Dieser Workflow basiert auf vorformatierten Feldern wie [session.total.total.amount](https://docs.stripe.com/js/custom_checkout/session_object#custom_checkout_session_object-total-total-amount). Das in der Stripe-API zurückgegebene [Checkout Session](https://docs.stripe.com/api/checkout/sessions/object.md)-Objekt verbleibt in der Währung, die in Ihrer Stripe-Integration festgelegt wurde, wobei der Endkunden-/Endkundinnenkontext unter [presentment_details](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-presentment_details) verfügbar ist, und stimmt nicht exakt mit dem Elements-[Session-Objekt](https://docs.stripe.com/js/custom_checkout/session_object) überein.
#### HTML + JS
Das [Session-Objekt](https://docs.stripe.com/js/custom_checkout/session_object) stellt formatierte Währungswerte bereit, die Sie direkt in Ihrer Nutzeroberfläche verwenden können.
```javascript
const { actions } = await checkout.loadActions();
const { total } = actions.getSession();
// Display the formatted amounts in your UI
document.getElementById('order-total').textContent = total.total.amount;
```
#### React
Der Hook [useCheckoutElements](https://docs.stripe.com/js/react_stripe_js/checkout/use_checkout_elements) stellt formatierte Währungen bereit, die Sie direkt auf Ihrer Nutzeroberfläche verwenden können.
```jsx
import React from 'react';
import {useCheckoutElements} from '@stripe/react-stripe-js/checkout';
const OrderSummary = () => {
const checkoutState = useCheckoutElements();
if (checkoutState.type === 'success') {
// Display the formatted amounts in your UI
return (
Total: {checkoutState.checkout.total.total.amount}
);
}
};
```
## Währungsauswahlelement rendern [Clientseitig]
Das [Währungsauswahlelement](https://docs.stripe.com/elements/currency-selector-element.md) ist eine einbettbare Nutzeroberflächenkomponente, die Adaptive Pricing ermöglicht. Zeigen Sie es in der Nähe der Bestellsumme an.
> Sie sind für die Einhaltung der Gesetze verantwortlich, die für die Preislokalisierung in Ihrer Region oder in der Region Ihrer Kundschaft gelten. Bei der Verwendung von Adaptive Pricing mit Elements müssen Sie das Währungsauswahlelement anzeigen. Stripe empfiehlt Ihnen, Ihren Rechtsbeistand zu konsultieren, um auf Ihr Unternehmen zugeschnittenen Rat einzuholen.
#### HTML + JS
Erstellen Sie ein Container-DOM-Element, um das Währungsauswahlelement einzubinden. Erstellen Sie dann mit [checkout.createCurrencySelectorElement](https://docs.stripe.com/js/custom_checkout/create_currency_selector_element) eine Instanz des Währungsauswahlelements und binden Sie es durch den Aufruf von [element.mount](https://docs.stripe.com/js/element/mount) ein, wobei Sie entweder einen CSS-Selektor oder das Container-DOM-Element angeben. Sie können festlegen, dass das Währungsauswahlelement nur erstellt wird, wenn die [currencyOptions](https://docs.stripe.com/js/custom_checkout/session_object#custom_checkout_session_object-currencyOptions) ausgefüllt sind. Wenn keine `currencyOptions` vorhanden sind und das Währungsauswahlelement bereitgestellt ist, wird nichts angezeigt.
```html
```
```javascript
const currencySelectorElement = checkout.createCurrencySelectorElement();
currencySelectorElement.mount('#currency-selector');
```
#### React
Binden Sie die Komponente `CurrencySelectorElement` in den `CheckoutElementsProvider` ein. Sie können festlegen, dass das `CurrencySelectorElement` erst dann eingebunden wird, wenn die [currencyOptions](https://docs.stripe.com/js/react_stripe_js/checkout/use_checkout_elements#react_use_checkout_elements-currencyOptions) ausgefüllt sind. Wenn keine `currencyOptions` vorhanden sind und das `CurrencySelectorElement` eingebunden ist, wird nichts angezeigt.
```jsx
import React from 'react';
import {CurrencySelectorElement} from '@stripe/react-stripe-js/checkout';
const OrderSummary = () => {
return (
);
};
```
### Best Practices für das Design
Wir bieten ein konfigurierbares **Währungsauswahlelement** für Ihre Bezahlseite an. Befolgen Sie diese Best Practices, wenn Sie auswählen, wo die Auswahl platziert werden soll:
- Fügen Sie die **Währungsauswahl** in der Nähe der Eingabe der Zahlungsdetails hinzu, idealerweise direkt über dem **Payment Element**, da sich die ausgewählte Währung auf die verfügbaren Zahlungsmethoden auswirken kann.
- Wenn das **Payment Element** anfangs nicht sichtbar ist (aufgrund von mehrstufigen Abläufen oder weil es sich weiter unten auf der Seite befindet), positionieren Sie die **Währungsauswahl** in der Nähe der Gesamtpreisanzeige.
- Für einmalige Zahlungen sind die lokalen und die Integrationsbeträge in der **Währungsauswahl** sichtbar. Für Abonnements zeigt die **Währungsauswahl** diese Beträge nicht an. Stellen Sie sicher, dass Sie den Gesamtpreis auf Ihrer Bezahlseite anzeigen.
- Wenn Sie das [Express Checkout Element](https://docs.stripe.com/elements/express-checkout-element.md) verwenden, empfehlen wir, das Currency Selector Element üer dem Express Checkout Element anzuordnen, um sicherzustellen, dass Ihre Kundinnen und Kunden wissen, in welcher Währung sie belastet werden.
- Wenden Sie diese Tipps auf Ihre Seiten-Layouts für alle Bildschirmgrößen an.
> #### Das sollten Sie tun
>
> Platzieren Sie die Währungsauswahl über dem Payment Element. Wenn Sie nur Karten akzeptieren, können Sie sie auch direkt unter dem Payment Element platzieren.
## Markieren Sie Ihre Integration als bereit für Adaptive Pricing [Clientseitig]
Sobald Sie [Ihre Preise lokalisiert und formatiert](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#localize-prices) und [den Währungswähler](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#render-currency-selector-element) gerendert haben, markieren Sie Ihre Integration als bereit für Adaptive Pricing, indem Sie beim Initialisieren von Checkout den Parameter [adaptivePricing.allowed](https://docs.stripe.com/js/custom_checkout/init#custom_checkout_init-options-adaptivePricing-allowed) setzen.
#### HTML + JS
```js
const checkout = stripe.initCheckoutElementsSdk({
clientSecret,
// Mark your integration as ready for Adaptive PricingadaptivePricing: {
allowed: true
}
});
// Use `checkout` to build your checkout page
```
#### React
```jsx
>")}
options={{
clientSecret,
// Mark your integration as ready for Adaptive PricingadaptivePricing: {allowed: true}
}}
>
{/* your components here */}
```
Nachdem Ihre Integration als bereit markiert wurde, können Sie Adaptive Pricing in Ihren [Payments-Einstellungen](https://dashboard.stripe.com/settings/adaptive-pricing) im Dashboard oder pro [Checkout-Sitzung](https://docs.stripe.com/api/checkout/sessions.md) über den Parameter [adaptive_pricing.enabled](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-adaptive_pricing-enabled) verwalten.
## Lokal bevorzugte Zahlungsmethoden konfigurieren [Dashboard]
Adaptive Pricing kann die Nutzung lokaler Zahlungsmethoden erhöhen, indem den Kundinnen und Kunden die Möglichkeit gegeben wird, in ihrer Landeswährung und mit den für sie relevantesten Zahlungsmethoden zu bezahlen. Beispielsweise wird für 70 % aller E-Commerce-Transaktionen in den Niederlanden iDEAL verwendet, doch es funktioniert nur mit EUR. Sie können in Ihren [Einstellungen der Zahlungsmethoden](https://dashboard.stripe.com/settings/payment_methods) konfigurieren, welche Zahlungsmethoden Sie akzeptieren, wenn Sie dynamische Zahlungsmethoden verwenden. Adaptive Pricing bietet Zugriff auf die folgenden Zahlungsmethoden, für die die Angabe in der Landeswährung erforderlich ist:
- Amazon Pay
- BACS-Lastschrift
- Bancontact
- Bizum
- BLIK
- EPS
- iDEAL
- Link
- P24
- Pix
- Südkoreanische Karten
- MB WAY
- Naver Pay
- Kakao Pay
- Pay by Bank
- PAYCO
- PayPal
- Revolut Pay
- Samsung Pay
- Satispay
- SEPA-Lastschrift
- TWINT
- WeChat Pay
- Klarna (nur EU und Vereinigtes Königreich)
- UPI
> Für grenzüberschreitende Abonnements unterstützt Adaptive Pricing ausschließlich Kartenzahlungen, Link, Apple Pay und Google Pay.
## Testen
Um die Darstellung lokaler Währungen zu testen, verwenden Sie den [Stripe.js-Testassistenten](https://docs.stripe.com/sdks/stripejs-testing-assistant.md#elements-inspector), um den Kundenstandort zu simulieren und zu sehen, wie sich Ihre Integration in verschiedenen Ländern verhalten wird.
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.
### Testen mit Kunden-E-Mail-Adresse
Sie können die Darstellung lokaler Währungen auch mit einer standortformatierten Kunden-E-Mail-Adresse testen.
Geben Sie eine Kunden-E-Mail-Adresse ein, die im lokalen Teil ein Suffix im Format `+Standort_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 Darstellung von Währungen für Kunden in Frankreich zu testen, übergeben Sie eine E-Mail-Adresse im Format `test+location_FR@example.com`. Wenn Sie Ihre Checkout-Seite mit dem Currency Selector Element und Payment Element mithilfe einer Checkout-Sitzung anzeigen, die mit einer standortformatierten E-Mail-Adresse erstellt wurde, sehen Sie dieselbe Währung wie die Kunden im jeweiligen Land.
Wenn Sie eine Checkout-Sitzung erstellen, übergeben Sie die für den Standort formatierte E-Mail 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=elements \
-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.
## Einschränkungen
Adaptive Pricing ist für Unternehmen, die Elements mit der Payment Intents API verwenden, nicht verfügbar.
Adaptive Pricing wird für indische Unternehmen nicht unterstützt.
Darüber hinaus wird für Adaptive Pricing vorausgesetzt, dass die [Währung für Ihre Preise](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-currency) eine Ihrer Abrechnungswährungen ist. Preise werden während des Bezahlvorgangs automatisch umgerechnet. Dies gilt für [Preise](https://docs.stripe.com/products-prices/manage-prices.md#prices-create), die Sie mit einer Preis-ID erstellen und referenzieren, und für Preise, die Sie inline mit [price_data](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items-price_data) bei der Einrichtung einer Checkout-Sitzung erstellen.
Wenn Sie Zahlungen über eine Plattform abwickeln, muss die Integrationswährung Ihrer Plattform die Abrechnungswährung des für die Zahlung eingetragenen Händlers sein.
Adaptive Pricing gilt nicht für Checkout-Sitzungen mit folgenden Eigenschaften:
- Enthalten Preise, in denen die lokale Währung der Kundin oder des Kunden bereits in den [currency_options](https://docs.stripe.com/payments/checkout/localize-prices/manual-currency-prices.md) des Preises definiert ist. Zum Beispiel: Wenn ein Preis über `currency_options` für EUR und GBP verfügt, führt Adaptive Pricing keine Umrechnung in EUR oder GBP aus, kann aber weiterhin Umrechnungen in andere Währungen wie CAD oder JPY durchführen.
- Verwenden Sie `manual` als [capture_method](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-capture_method).
- Verwenden Sie [nutzerdefinierte Beträge](https://docs.stripe.com/payments/checkout/pay-what-you-want.md).
Checkout-Sitzungen, die nicht von Adaptive Pricing unterstützt werden, zeigen die Preise in der ursprünglichen Währung an, in der Sie Ihre Preise festgelegt haben.
Weitere Informationen finden Sie auf unserer [Support-Seite](https://support.stripe.com/questions/adaptive-pricing).
## Unterstützte Währungen
Unternehmen in unterstützten Regionen können Preise automatisch in die lokalen Währungen ihrer Kundinnen und Kunden in den folgenden Märkten umrechnen:
### Nordamerika
- AG
- AW
- BS
- BB
- BZ
- BM
- CA
- KY
- CR
- DM
- DO
- GD
- GT
- HT
- HN
- MX
- JM
- PA
- KN
- LC
- VC
- TT
- US
### Südamerika
- BR
- BO
- CO
- CL
- FK
- GY
- PY
- PE
- UY
### Europa
- AL
- AD
- AT
- BE
- BA
- HR
- CY
- CZ
- DK
- EE
- FI
- FR
- DE
- GI
- GR
- HU
- IS
- IE
- IT
- LV
- LT
- LU
- MT
- MC
- MD
- ME
- NL
- MK
- NO
- PL
- PT
- RO
- SM
- RS
- SK
- SI
- ES
- SE
- CH
- UA
- GB
- VA
### Asien
- AF
- AM
- AZ
- BD
- BN
- KH
- CN
- GE
- HK
- IN
- ID
- IL
- JP
- KZ
- KG
- MO
- MY
- MV
- MN
- NP
- PK
- PH
- QA
- SA
- SG
- KR
- LK
- TW
- TJ
- TH
- TR
- AE
- UZ
- VN
- YE
### Ozeanien
- AU
- PF
- NC
- NZ
- WF
### Afrika
- AO
- DZ
- BJ
- BW
- BF
- BI
- CM
- CV
- CF
- TD
- CI
- DJ
- GQ
- GA
- GM
- GN
- GW
- KE
- LR
- MG
- ML
- MU
- MA
- MZ
- NA
- NE
- CG
- RW
- SH
- ST
- SN
- ZA
- TZ
- TG
- UG
- ZM
## Preisgestaltung
- Sie zahlen 0 %
- Ihre Kundschaft zahlt 2 bis 4 %
Sie zahlen keine zusätzlichen Stripe-Gebühren für Adaptive Pricing direkt, da alle diese Gebühren von Ihren Kundinnen und Kunden bezahlt werden. Der von Stripe angegebene Wechselkurs, den Sie Ihren Kundinnen und Kunden vorlegen, beinhaltet eine Umrechnungsgebühr von 2 bis 4 %, wodurch sich ihr Kaufpreis um einen entsprechenden Betrag erhöht. Stripe bestimmt die Gebühr, die zum Zwecke der Steigerung der Kunden-Conversion variiert. Ihre Kundinnen und Kunden zahlen diese Gebühr nicht, wenn sie sich dafür entscheiden, mit mit der Währung Ihrer Integration zu bezahlen, doch es können der Wechselkurs und die Gebühren ihrer Bank bei der Kundin oder dem Kunden zu Buche schlagen. Detaillierte Informationen zu den aktuellen Stripe-Gebühren finden Sie auf unserer [Preisseite](https://stripe.com/pricing).
## Wechselkurs
Stripe verwendet den mittleren marktüblichen Wechselkurs und erhebt eine Transaktionsgebühr, um den Kurs bis zur Zahlungsabwicklung zu garantieren.
Erfahren Sie mehr darüber, wie Stripe mit [Währungsumrechnungen](https://docs.stripe.com/currencies.md) und [Adaptive Pricing-Gebühren](https://support.stripe.com/questions/adaptive-pricing#:~:text=Adaptive%20Pricing%20is%20a%20Checkout,latest%20Stripe%2Dprovided%20exchange%20rates) umgeht.
## Rückerstattungen
Sie können eine Rückerstattung in Ihrer Integrationswährung ausstellen. Stripe erstattet Ihrem Kunden/Ihrer Kundin den Betrag in der Währung, in der er/sie die Zahlung getätigt hat. Für die Rückerstattung gilt derselbe Wechselkurs wie bei der ursprünglichen Transaktion. Dadurch entstehen Ihnen keine zusätzlichen Kosten und Ihre Kundinnen und Kunden erhalten genau den Betrag zurück, den sie bezahlt haben.
Erfahren Sie mehr darüber, wie Stripe Sie bei der Verwaltung von [Rückerstattungen](https://docs.stripe.com/refunds.md) unterstützt.
## See also
- [FAQ zu Adaptive Pricing](https://support.stripe.com/questions/adaptive-pricing)