Adaptive Pricing

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

Il est important d’afficher les prix de manière homogène en fonction de la devise sélectionnée sur l’ensemble de votre page de paiement, y compris les postes de facture, les frais de livraison, les remises, les taxes et les totaux.

Lorsque vous utilisez des composants intégrés avec Adaptive Pricing, l’objet Session des composants intégrés peut contenir des valeurs localisées si Adaptive Pricing est actif. Concevez votre intégration de manière à ce que la session contienne des montants et des devises pertinents pour les pays à partir desquels vos clients sont susceptibles de consulter votre site. Ce workflow s’appuie sur des champs préformatés comme session.total.total.amount. L’objet Checkout Session renvoyé dans l’API Stripe reste dans la même devise que celle définie dans votre intégration Stripe avec le contexte client disponible sous presentment_details. Il ne correspondra pas exactement à l’objet Session des composants intégrés.

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

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

Le Currency Selector Element est un composant d’interface utilisateur intégrable qui facilite la fonction Adaptive Pricing. Affichez-le à côté du total de la commande.

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

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

Bonnes pratiques en matière de conception

Nous proposons un élément Currency Selector configurable pour votre page de paiement. Suivez ces bonnes pratiques lorsque vous choisissez l’emplacement de votre sélecteur :

• Ajoutez le sélecteur de devise à côté du champ de saisie des informations de paiement, idéalement directement au-dessus du composant Payment Element, car la devise sélectionnée peut affecter les moyens de paiement disponibles.
• Si Payment Element n’est pas visible au départ (en raison de flux à plusieurs étapes ou d’une position plus basse sur la page), placez Currency Selector près de l’affichage du prix total.
• Si vous utilisez le composant Express Checkout Element, nous vous recommandons de placer le composant Currency Selector Element au-dessus du composant Express Checkout Element pour que vos clients sachent dans quelle devise ils seront facturés.
• Appliquez ces conseils à vos mises en page pour toutes les tailles d’écran.

Une fois que vous avez localiser et formaté vos tarifs et affiché le sélecteur de devise, marquez votre intégration comme prête pour Adaptive Pricing en définissant le paramètre adaptivePricing.allowed lorsque vous initialisez le paiement.

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

Une fois votre intégration marquée comme prête, vous pouvez gérer Adaptive Pricing dans vos paramètres de paiement dans le Dashboard, ou par session de paiement à l’aide du paramètre adaptive_pricing.enabled.

Adaptive Pricing peut augmenter l’utilisation des moyens de paiement locaux en garantissant aux clients la possibilité de payer dans leur monnaie locale et avec les moyens de paiement qui leur conviennent le mieux. À titre d’exemple, 70 % de toutes les transactions de commerce électronique aux Pays-Bas se font via iDEAL, mais ce système ne fonctionne qu’avec l’euro. Vous pouvez configurer les moyens de paiement que vous acceptez dans vos paramètres de moyens de paiement si vous utilisez des moyens de paiement dynamiques. Adaptive Pricing donne accès aux moyens de paiement suivants qui doivent être présentés dans la monnaie locale :

• Amazon Pay
• Bancontact
• BLIK
• EPS
• iDEAL
• Link
• P24
• Pix
• Cartes bancaires sud-coréennes
• Naver Pay
• Kakao Pay
• PAYCO
• Revolut Pay
• Samsung Pay
• Wechat Pay

Pour tester la présentation en devise locale, transmettez l’adresse e-mail en précisant le pays du client au moyen d’un suffixe au format +location_XX dans la partie dédiée de l’e-mail. XX doit être 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.

Lorsque vous affichez votre page de paiement avec le Currency Selector Element et le Payment Element à l’aide d’une CheckoutSession créée à l’aide d’un e-mail au format de l’emplacement, la devise est identique à celle qui est présentée à un client du pays en question.

Lorsque vous créez une session Checkout, transmettez l’adresse e-mail précisant le pays du client dans le champ customer_email pour simuler un paiement à partir d’un pays particulier.

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"

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 comme d’habitude.

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

L’Adaptive Pricing n’est pas prise en charge pour les entreprises indiennes.

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 :

• Contenir des prix manuels des 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.