Adaptive Pricing

Gérez Adaptive Pricing dans vos paramètres de paiement. Vous pouvez activer Adaptive Pricing dans un environnement de test ou en mode production. Sa désactivation n’affecte pas les sessions Checkout déjà converties.

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.

Si un client paie dans sa devise locale, l’événement checkout.session.completed contient un hachage presentment_details qui inclut presentment_amount et presentment_currency. Le montant et la devise reflètent la somme payée par votre client dans la devise locale.

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

Pour tester la présentation dans la devise locale, transmettez l’adresse e-mail du client accompagnée d’un suffixe au format +location_XX dans la partie locale de l’adresse, où XX est un code pays ISO à deux lettres valide.

Par exemple, pour tester la devise présentée à un client français, transmettez une adresse e-mail de type test+location_FR@example.com. Une session Checkout créée à l’aide d’une adresse e-mail précisant le pays du client affiche la même devise que le pays spécifié.

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"

Vous pouvez également créer un objet Customer et indiquer son adresse e-mail en y ajoutant un suffixe de type +location_XX. Les cartes de test Stripe fonctionnent normalement.

La fonction Adaptive Pricing n’est actuellement pas disponible pour les entreprises qui utilisent Connect ou Elements avec l’API Payment Intents.

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 ne s’applique pas aux sessions Checkout :

• Contenant des tarifs manuels de devises explicitement définis.
• en mode subscription.
• utilisant des paramètres Connect comme application_fee_amount, on_behalf_of et transfer_data.
• Utilisant le paramètre capture_method défini sur manual.
• Utilisez des montants personnalisés.

Les sessions Checkout qui ne sont pas prises en charge par Adaptive Pricing présentent les tarifs dans leur devise d’origine.