Adaptive Pricing

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

La fonctionnalité Adaptive Pricing peut augmenter l’utilisation des moyens de paiement locaux en permettant aux clients de payer dans leur devise et avec leurs moyens de paiement habituels. À titre d’exemple, 70 % des transactions d’e-commerce effectuées aux Pays-Bas utilisent iDEAL, mais ce moyen de paiement ne fonctionne qu’en EUR. Vous pouvez configurer les moyens de paiement que vous acceptez dans les paramètres des moyens de paiement si vous utilisez des moyens de paiement dynamiques. Adaptive Pricing débloque l’accès aux moyens de paiement suivants, qui nécessitent une présentation dans la devise locale :

• Bancontact
• BLIK
• EPS
• iDEAL
• Link
• P24
• South Korean cards
• Naver Pay
• Kakao Pay
• PAYCO
• Samsung Pay

Adaptive Pricing peut affecter certaines parties de votre intégration, comme les destinations d’événements et la création de rapports. Vérifiez votre intégration pour vous assurer que toutes les destinations d’événements peuvent traiter les objets PaymentIntent en devises locales.

• Utilisez la devise et le montant total de l’objet CheckoutSession pour déterminer ce que votre client a payé dans votre devise de votre intégration, qui est celle que vous avez indiquée pour vos tarifs.
• Utilisez le hachage presentment_details sur l’objet Checkout Session pour déterminer ce que votre client a payé dans sa devise locale.

La session Checkout et les objets PaymentIntent sous-jacents tiennent compte de la devise et du montant de votre intégration.

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 lui indiquer une adresse e-mail comportant le suffixe +location_XX. Les cartes de test Stripe fonctionnent normalement.

Adaptive Pricing n’est pas disponible pour les entreprises qui utilisent Elements avec l’API Payment Intents.

De plus, Adaptive Pricing exige que la devise de vos tarifs soit l’une de vos devises de règlement. Les tarifs sont automatiquement convertis au moment du paiement. Ce comportement s’applique aux tarifs que vous créez et référencez avec un ID de tarif, ainsi qu’aux tarifs créés en série avec le paramètre price_data à la création d’une session Checkout.

Si vous traitez des paiements via une plateforme, nous exigeons que la devise d’intégration de votre plateforme soit la devise de règlement du marchand officiel associé au paiement.

Adaptive Pricing ne s’applique pas aux sessions Checkout :

• Contenant des tarifs manuels de devises explicitement définis.
• en mode subscription.
• 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.