Adaptive Pricing

Adaptive Pricing ist für Payment Links immer aktiviert. Verwalten Sie Adaptive Pricing für Checkout in Ihren Zahlungseinstellungen im Dashboard. Sie können Adaptive Pricing in einer Sandbox und im Live-Modus aktivieren. Die Deaktivierung von Adaptive Pricing wirkt sich nicht auf Checkout-Sitzungen aus, die bereits konvertiert wurden.

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.

If a customer pays in their local currency, the checkout.session.completed event contains a presentment_details hash that includes the presentment_amount, presentment_currency. The amount and currency reflect what your customer paid in the local currency.

{
  "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"
      }
    }
  }
}

To test local currency presentment for Checkout and Payment Links, pass in a location-formatted customer email that includes a suffix in a +location_XX format in the local part of the email. XX must be a valid two-letter ISO country code.

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 .

When you visit the URL for a Checkout Session or Payment Link created with a location-formatted email, you see the same currency as a customer does in the specified country.

Checkout testen

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 success_url="https://example.com/success" \
  --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.

Wenn es möglich ist, die lokale Währung des Kunden/der Kundin 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.

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.
• Legen Sie den Wert der Währung bei Erstellung fest.
• 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.