Adaptive Pricing

Verwalten Sie Adaptive Pricing in Ihren Zahlungseinstellungen. Sie können Adaptive Pricing in einer Sandbox und im Live-Modus aktivieren. Die Deaktivierung von Adaptive Pricing hat keine Auswirkungen auf bereits konvertierte Checkout-Sitzungen.

Adaptive Pricing can increase the usage of local payment methods by ensuring customers have the option to pay in their local currency and with payment methods most relevant to them. As an example, 70% of all e-commerce transactions in the Netherlands use iDEAL, but it only works with EUR. You can configure which payment methods you accept in your payment methods settings if you use dynamic payment methods. Adaptive Pricing unlocks access to the following payment methods that require presenting in local currency:

• Bancontact
• EPS
• iDEAL
• Link
• P24

Adaptive Pricing can affect some parts of your integration, such as event destinations and reporting. Review your integration to make sure any event destinations can handle PaymentIntent objects with local currencies.

• Use the Checkout Session object’s currency and total amount to determine what your customer paid in your integration currency, which is the currency you specified for your prices.
• Use the presentment_details hash on the Checkout Session object to determine what your customer paid in their local currency.

The Checkout Session and the underlying PaymentIntent objects reflect your integration currency and amount.

Wenn ein Kunde/eine Kundin in seiner/ihrer Landeswährung bezahlt, enthält das Ereignis checkout.session.completed einen presentment_details-Hash, der den presentment_amount und die presentment_currency beinhaltet. Der Betrag und die Währung spiegelt wider, was Ihre Kundin/Ihr Kunde in seiner/ihrer Landeswährung gezahlt hat.

{
  "id": 
'{{EVENT_ID}}',
  "object": "event",
  "type": "checkout.session.completed",
  "data": {
    "object": {
      "id": 
'{{SESSION_ID}}',
      "object": "checkout.session",
      "currency": "usd",
      "amount_total": 1000,
      "amount_subtotal": 1000,
      "presentment_details": {
        "presentment_amount": 1370,
        "presentment_currency": "cad"
      }
    }
  }
}

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. Eine Checkout-Sitzung, die mit einer nach Standort formatierten E-Mail-Adresse erstellt wurde, zeigt die gleiche Währung wie das angegebene Land an.

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=embedded \
  -d return_url="https://example.com/return" \
  --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 gewohnt.

Adaptive Pricing ist derzeit nicht für Unternehmen verfügbar, die Connect oder Elements mit der Payment Intents API verwenden.

Additionally, Adaptive Pricing requires the currency for your prices to be one of your settlement currencies. Prices automatically convert during checkout. This applies to prices you create and reference with a price ID and prices you create inline with price_data when you create a Checkout Session.

Adaptive Pricing gilt nicht für Checkout-Sitzungen mit folgenden Eigenschaften:

• Enthalten explizit definierte manuelle Währungspreise.
• Sind im subscription-Modus.
• Verwenden Sie Connect-Parameter wie application_fee_amount, on_behalf_of und transfer_data.
• 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.