Adaptive Pricing

Verwalten Sie Adaptive Pricing für Checkout in Ihren Payments-Einstellungen 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.

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 Verwendung von eingebetteten Komponenten mit Adaptive Pricing kann das Sitzungsobjekt der eingebetteten Komponenten lokalisierte Werte enthalten, wenn Adaptive Pricing aktiviert ist. Sie sollten Ihre Integration so gestalten, dass die Sitzung Beträge und Währungen enthalten könnte, die für jedes Land relevant sind, aus dem Ihre Käufer/innen Ihre Website besuchen. Dieser Ablauf basiert auf vorformatierten Feldern wie session.total.total.amount. Das in der Stripe API zurückgegebene Checkout-Sitzungsobjekt hat weiterhin dieselbe Währung, die in Ihrer Stripe Integration mit dem Kundenkontext unter presentment_details angegeben ist, und stimmt nicht genau mit dem Sitzungsobjekt der eingebetteten Komponenten überein.

const { actions } = await checkout.loadActions();
const { total } = actions.getSession();

// Display the formatted amounts in your UI
document.getElementById('order-total').textContent = total.total.amount;

Das Währungsauswahlelement ist eine einbettbare Nutzeroberflächenkomponente, die Adaptive Pricing ermöglicht. Zeigen Sie es in der Nähe der Bestellsumme an.

<div id="currency-selector"></div>

const currencySelectorElement = checkout.createCurrencySelectorElement();
currencySelectorElement.mount('#currency-selector');

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.
• Wenn Sie das Express Checkout Element 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.

Sobald Sie Ihre Preise lokalisiert und formatiert und den Währungswähler gerendert haben, markieren Sie Ihre Integration als bereit für Adaptive Pricing, indem Sie beim Initialisieren von Checkout den Parameter adaptivePricing.allowed setzen.

const checkout = stripe.initCheckout({
  clientSecret,
  // Mark your integration as ready for Adaptive Pricing
  adaptivePricing: {
    allowed: true
  }
});
// Use `checkout` to build your checkout page

Nachdem Ihre Integration als bereit markiert wurde, können Sie Adaptive Pricing in Ihren Payments-Einstellungen im Dashboard oder pro Checkout-Sitzung über den Parameter adaptive_pricing.enabled verwalten.

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 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
• Bancontact
• BLIK
• EPS
• iDEAL
• Link
• P24
• Pix
• Südkoreanische Karten
• Naver Pay
• Kakao Pay
• PAYCO
• Revolut Pay
• Samsung Pay
• Wechat Pay

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 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 Ihre Bezahlseite mit dem Currency Selector Element und dem Payment Element anzeigen, indem Sie eine CheckoutSession nutzen, 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, um einen Bezahlvorgang eines bestimmten Lands zu simulieren.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"={{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d ui_mode=custom \
  -d "adaptive_pricing[enabled]"=true \
  -d return_url={{RETURN_URL}} \
  --data-urlencode customer_email="test+location_FR@example.com"

Sie können auch einen Kunden/eine Kundin erstellen und seine/ihre E-Mail-Adresse angeben, die das Suffix +location_XX enthält. Stripe-Testkarten funktionieren wie üblich.

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 eine Ihrer Abrechnungswährungen ist. Preise werden während des Bezahlvorgangs automatisch umgerechnet. Dies gilt für Preise, die Sie mit einer Preis-ID erstellen und referenzieren, und für Preise, die Sie inline mit 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 explizit definierte Preise in manuellen Währungen.
• Sind im subscription-Modus.
• Verwenden Sie manual als capture_method.
• Verwenden Sie nutzerdefinierte Beträge.

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.