# Adaptive Pricing Offrez à vos clients la possibilité de payer dans leur devise locale grâce à la fonction Adaptive Pricing. # Page hébergée > This is a Page hébergée for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing?payment-ui=stripe-hosted. Adaptive Pricing permet à vos clients de payer dans leur devise locale dans plus de [150pays](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#supported-currencies). Avec Adaptive Pricing, Stripe utilise le machine learning pour déterminer la devise de présentation la plus pertinente, puis calcule automatiquement le prix localisé et gère toutes les conversions de devises. Utilisez Adaptive Pricing pour : - Afficher les tarifs dans la devise locale de votre client en fonction de sa localisation - Calculer les tarifs en temps réel et avec un taux de change garanti pendant 24 heures - Débloquer les moyens de paiement qui requièrent une présentation en devise locale - Faciliter votre conformité lorsque vous affichez des devises prises en charge #### Effort d’intégration Complexity: 1/5 #### Frais Consultez les informations sur [les frais et notre FAQ](https://support.stripe.com/questions/adaptive-pricing). ## Activer Adaptive Pricing dans le Dashboard [Dashboard] Adaptive Pricing est toujours activé pour Payment Links. Gérez Adaptive Pricing pour Checkout dans vos [paramètres de paiement](https://dashboard.stripe.com/settings/adaptive-pricing) du Dashboard. Vous pouvez activer Adaptive Pricing en environnement de test et en mode production. La désactivation d’Adaptive Pricing n’affecte pas les Checkout Sessions qui ont déjà été converties ni les abonnements actifs payés dans la devise locale des clients. ## Configurer des moyens de paiement locaux [Dashboard] 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](https://dashboard.stripe.com/settings/payment_methods) 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 - MB WAY - Naver Pay - Kakao Pay - PAYCO - PayPal - Revolut Pay - Samsung Pay - TWINT - Wechat Pay - Klarna (UE + RU uniquement) - UPI > Pour les abonnements internationaux, Adaptive Pricing ne prend en charge que les paiements par carte bancaire, Link, Apple Pay et Google Pay. ## Destinations des événements et rapports [Côté serveur] La Session Checkout et les objets `PaymentIntent` sous-jacents indiquent ce que votre client a payé dans la devise et le montant de votre intégration, c’est-à-dire la devise que vous avez spécifiée pour vos prix. Si un client paie dans sa monnaie locale, les événements [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed) et [payment_intent.succeeded](https://docs.stripe.com/api/events/types.md#event_types-payment_intent.succeeded) contiennent un hachage du champ `presentment_details` qui inclut les champs `presentment_amount` et `presentment_currency`. #### JSON ```json { "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" } } } } ``` Lorsqu’une facture d’abonnement récurrent est payée dans la monnaie locale, l’événement [payment_intent.succeeded](https://docs.stripe.com/api/events/types.md#event_types-payment_intent.succeeded) pour chaque `PaymentIntent` associé à la facture contient un hachage du champ `presentment_details` qui inclut les champs `presentment_amount` et `presentment_currency`. #### JSON ```json { "id": "{{PAYMENT_INTENT_ID}}", "object": "payment_intent", "currency": "usd", "amount": 1000,"presentment_details": { "presentment_amount": 1370, "presentment_currency": "cad" } } ``` Lorsqu’un abonnement récurrent est créé dans la devise locale, l’événement [customer.subscription.created](https://docs.stripe.com/api/events/types.md#event_types-customer.subscription.created) contient un hash `presentment_details` qui inclut `presentment_currency`, laquelle correspond à la devise locale utilisée pour les paiements hors session. ## Test Pour tester la présentation en devise locale pour Checkout et Payment Links, transmettez un e-mail de client formaté par lieu qui inclut un suffixe au format `+location_XX` dans la partie locale de l’e-mail. `XX` doit être un [code pays ISO à deux lettres valide](https://www.nationsonline.org/oneworld/country_code_list.htm). 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`. La devise que vous voyez quand vous utilisez l’URL d’une session Checkout ou d’un lien de paiement créée à l’aide d’une adresse e-mail précisant le pays du client est identique à celle qui est présentée à un client du pays en question. ### Test de Checkout Lorsque vous créez une session Checkout, transmettez l’adresse e-mail précisant le pays du client dans le champ [customer_email](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_email) pour simuler un paiement à partir d’un pays particulier. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u <>: \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=1 \ -d mode=payment \ -d return_url="https://example.com/return" \ --data-urlencode customer_email="test+location_FR@example.com" ``` Vous pouvez également créer un objet [Customer](https://docs.stripe.com/api/customers/create.md) et indiquer son adresse e-mail en y ajoutant un suffixe de type `+location_XX`. Les cartes de test Stripe fonctionnent comme d’habitude. ### Test de Payment Links Pour Payment Links, transmettez une adresse e-mail précisant le pays du client dans le [paramètre d’URL](https://docs.stripe.com/payment-links/customize.md#customize-checkout-with-url-parameters) `prefilled_email` afin de tester les devises présentées aux clients de différents pays. ## Restrictions 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](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-currency) soit l’une de vos devises de règlement. Les tarifs sont automatiquement convertis au moment du paiement. Ce comportement s’applique aux [tarifs](https://docs.stripe.com/products-prices/manage-prices.md#prices-create) 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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items-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 : - Contain prices where the customer’s local currency is already defined in the price’s [currency_options](https://docs.stripe.com/payments/checkout/localize-prices/manual-currency-prices.md). For example, if a price has `currency_options` for EUR and GBP, Adaptive Pricing won’t convert to EUR or GBP, but it can still convert to other currencies like CAD or JPY. - Utilisant le paramètre [capture_method](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-capture_method) défini sur `manual`. - Utilisez des [montants personnalisés](https://docs.stripe.com/payments/checkout/pay-what-you-want.md). Les sessions Checkout qui ne sont pas prises en charge par Adaptive Pricing présentent les tarifs dans leur devise d’origine. ## Devises prises en charge Les entreprises des régions prises en charge peuvent automatiquement convertir les tarifs dans les devises locales de leurs clients sur les marchés suivants : ### Amérique du Nord - AG - AW - BS - BB - BZ - BM - CA - KY - CR - DM - DO - GD - GT - HT - HN - MX - JM - PA - KN - LC - VC - TT - US ### Amérique du Sud - BR - BO - CO - CL - FK - GY - PY - PE - UY ### Europe - AL - AD - AT - BE - BA - HR - CY - CZ - DK - EE - FI - FR - DE - GI - GR - HU - IS - IE - IT - LV - LT - LU - MT - MC - MD - ME - NL - MK - NO - PL - PT - RO - SM - RS - SK - SI - ES - SE - CH - UA - GB - VA ### Asie - AF - AM - AZ - BD - BN - KH - CN - GE - HK - IN - ID - IL - JP - KZ - KG - MO - MY - MV - MN - NP - PK - PH - QA - SA - SG - KR - LK - TW - TJ - TH - TR - AE - UZ - VN - YE ### Océanie - AU - PF - NC - NZ - WF ### Afrique - AO - DZ - BJ - BW - BF - BI - CM - CV - CF - TD - CI - DJ - GQ - GA - GM - GN - GW - KE - LR - MG - ML - MU - MA - MZ - NA - NE - CG - RW - SH - ST - SN - ZA - TZ - TG - UG - ZM ## Tarifs - Vous payez 0 % - Vos clients paient des frais allant de 2 à 4 % Vous ne payez pas directement de frais Stripe supplémentaires pour la tarification adaptative, car tous ces frais sont pris en charge par vos clients. Le taux de change fourni par Stripe que vous présentez à vos clients comprend des frais de conversion de 2 à 4 %, ce qui augmente le prix d’achat d’un montant correspondant. Stripe détermine les frais, qui varient dans le but d’augmenter la conversion des clients. Vos clients ne paient pas ces frais s’ils choisissent de payer dans la devise de votre intégration, mais le taux de change et les frais de leur banque peuvent s’appliquer. Pour en savoir plus sur les frais Stripe actuels, consultez notre [page de tarification](https://stripe.com/pricing). ## Taux de change Stripe utilise le taux de change moyen du marché et applique des frais pour garantir le taux par règlement. En savoir plus sur la façon dont Stripe gère les [conversions de devises](https://docs.stripe.com/currencies.md) et les [frais Adaptive Pricing](https://support.stripe.com/questions/adaptive-pricing#:~:text=Adaptive%20Pricing%20is%20a%20Checkout,latest%20Stripe%2Dprovided%20exchange%20rates). ## Remboursements Vous pouvez émettre un remboursement dans votre devise d’intégration et Stripe rembourse votre client dans la devise qu’il a utilisée pour effectuer le paiement. Le remboursement utilise le même taux de change que la transaction initiale, de sorte qu’il n’y a pas de frais supplémentaires pour vous et votre client récupère le montant exact qu’il a payé. Découvrez comment Stripe peut vous aider à gérer vos [remboursements](https://docs.stripe.com/refunds.md). # Page intégrée > This is a Page intégrée for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing?payment-ui=embedded-form. Adaptive Pricing permet à vos clients de payer dans leur devise locale dans plus de [150 pays](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#supported-currencies). Avec Adaptive Pricing, Stripe utilise le machine learning pour déterminer la devise de présentation la plus pertinente, puis calcule automatiquement le prix localisé et gère toutes les conversions de devises. Utilisez Adaptive Pricing pour : - Afficher les tarifs dans la devise locale de votre client en fonction de sa localisation - Calculer les tarifs en temps réel et avec un taux de change garanti pendant 24 heures - Débloquer les moyens de paiement qui requièrent une présentation en devise locale - Faciliter votre conformité lorsque vous affichez des devises prises en charge #### Effort d’intégration Complexity: 1/5 #### Frais Consultez les informations sur [les frais et notre FAQ](https://support.stripe.com/questions/adaptive-pricing). ## Activer Adaptive Pricing dans le Dashboard [Dashboard] Gérez Adaptive Pricing pour Checkout dans vos [paramètres de paiement](https://dashboard.stripe.com/settings/adaptive-pricing) du Dashboard. Vous pouvez activer Adaptive Pricing en environnement de test et en mode production. La désactivation d’Adaptive Pricing n’affecte pas les Checkout Sessions qui ont déjà été converties ni les abonnements actifs payés dans la devise locale des clients. ## Configurer des moyens de paiement locaux [Dashboard] 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](https://dashboard.stripe.com/settings/payment_methods) 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 - MB WAY - Naver Pay - Kakao Pay - PAYCO - PayPal - Revolut Pay - Samsung Pay - TWINT - Wechat Pay - Klarna (UE + RU uniquement) - UPI > Pour les abonnements internationaux, Adaptive Pricing ne prend en charge que les paiements par carte bancaire, Link, Apple Pay et Google Pay. ## Destinations des événements et rapports [Côté serveur] La Session Checkout et les objets `PaymentIntent` sous-jacents indiquent ce que votre client a payé dans la devise et le montant de votre intégration, c’est-à-dire la devise que vous avez spécifiée pour vos prix. Si un client paie dans sa monnaie locale, les événements [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed) et [payment_intent.succeeded](https://docs.stripe.com/api/events/types.md#event_types-payment_intent.succeeded) contiennent un hachage du champ `presentment_details` qui inclut les champs `presentment_amount` et `presentment_currency`. #### JSON ```json { "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" } } } } ``` Lorsqu’une facture d’abonnement récurrent est payée dans la monnaie locale, l’événement [payment_intent.succeeded](https://docs.stripe.com/api/events/types.md#event_types-payment_intent.succeeded) pour chaque `PaymentIntent` associé à la facture contient un hachage du champ `presentment_details` qui inclut les champs `presentment_amount` et `presentment_currency`. #### JSON ```json { "id": "{{PAYMENT_INTENT_ID}}", "object": "payment_intent", "currency": "usd", "amount": 1000,"presentment_details": { "presentment_amount": 1370, "presentment_currency": "cad" } } ``` Lorsqu’un abonnement récurrent est créé dans la devise locale, l’événement [customer.subscription.created](https://docs.stripe.com/api/events/types.md#event_types-customer.subscription.created) contient un hash `presentment_details` qui inclut `presentment_currency`, laquelle correspond à la devise locale utilisée pour les paiements hors session. ## Test 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](https://www.nationsonline.org/oneworld/country_code_list.htm) 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 curl https://api.stripe.com/v1/checkout/sessions \ -u <>: \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=1 \ -d mode=payment \ -d ui_mode=embedded_page \ -d return_url="https://example.com/return" \ --data-urlencode customer_email="test+location_FR@example.com" ``` Vous pouvez également créer un objet [Customer](https://docs.stripe.com/api/customers/create.md) et lui indiquer une adresse e-mail comportant le suffixe `+location_XX`. Les cartes de test Stripe fonctionnent normalement. ## Restrictions 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](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-currency) soit l’une de vos devises de règlement. Les tarifs sont automatiquement convertis au moment du paiement. Ce comportement s’applique aux [tarifs](https://docs.stripe.com/products-prices/manage-prices.md#prices-create) 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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items-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 : - Contain prices where the customer’s local currency is already defined in the price’s [currency_options](https://docs.stripe.com/payments/checkout/localize-prices/manual-currency-prices.md). For example, if a price has `currency_options` for EUR and GBP, Adaptive Pricing won’t convert to EUR or GBP, but it can still convert to other currencies like CAD or JPY. - Utilisant le paramètre [capture_method](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-capture_method) défini sur `manual`. - Utilisez des [montants personnalisés](https://docs.stripe.com/payments/checkout/pay-what-you-want.md). Les sessions Checkout qui ne sont pas prises en charge par Adaptive Pricing présentent les tarifs dans leur devise d’origine. ## Devises prises en charge Les entreprises des régions prises en charge peuvent automatiquement convertir les tarifs dans les devises locales de leurs clients sur les marchés suivants : ### Amérique du Nord - AG - AW - BS - BB - BZ - BM - CA - KY - CR - DM - DO - GD - GT - HT - HN - MX - JM - PA - KN - LC - VC - TT - US ### Amérique du Sud - BR - BO - CO - CL - FK - GY - PY - PE - UY ### Europe - AL - AD - AT - BE - BA - HR - CY - CZ - DK - EE - FI - FR - DE - GI - GR - HU - IS - IE - IT - LV - LT - LU - MT - MC - MD - ME - NL - MK - NO - PL - PT - RO - SM - RS - SK - SI - ES - SE - CH - UA - GB - VA ### Asie - AF - AM - AZ - BD - BN - KH - CN - GE - HK - IN - ID - IL - JP - KZ - KG - MO - MY - MV - MN - NP - PK - PH - QA - SA - SG - KR - LK - TW - TJ - TH - TR - AE - UZ - VN - YE ### Océanie - AU - PF - NC - NZ - WF ### Afrique - AO - DZ - BJ - BW - BF - BI - CM - CV - CF - TD - CI - DJ - GQ - GA - GM - GN - GW - KE - LR - MG - ML - MU - MA - MZ - NA - NE - CG - RW - SH - ST - SN - ZA - TZ - TG - UG - ZM ## Tarifs - Vous payez 0 % - Vos clients paient des frais allant de 2 à 4 % Vous ne payez pas directement de frais Stripe supplémentaires pour la tarification adaptative, car tous ces frais sont pris en charge par vos clients. Le taux de change fourni par Stripe que vous présentez à vos clients comprend des frais de conversion de 2 à 4 %, ce qui augmente le prix d’achat d’un montant correspondant. Stripe détermine les frais, qui varient dans le but d’augmenter la conversion des clients. Vos clients ne paient pas ces frais s’ils choisissent de payer dans la devise de votre intégration, mais le taux de change et les frais de leur banque peuvent s’appliquer. Pour en savoir plus sur les frais Stripe actuels, consultez notre [page de tarification](https://stripe.com/pricing). ## Taux de change Stripe utilise le taux de change moyen du marché et applique des frais pour garantir le taux par règlement. En savoir plus sur la façon dont Stripe gère les [conversions de devises](https://docs.stripe.com/currencies.md) et les [frais Adaptive Pricing](https://support.stripe.com/questions/adaptive-pricing#:~:text=Adaptive%20Pricing%20is%20a%20Checkout,latest%20Stripe%2Dprovided%20exchange%20rates). ## Remboursements Vous pouvez émettre un remboursement dans votre devise d’intégration et Stripe rembourse votre client dans la devise qu’il a utilisée pour effectuer le paiement. Le remboursement utilise le même taux de change que la transaction initiale, de sorte qu’il n’y a pas de frais supplémentaires pour vous et votre client récupère le montant exact qu’il a payé. Découvrez comment Stripe peut vous aider à gérer vos [remboursements](https://docs.stripe.com/refunds.md). # Éléments Checkout > This is a Éléments Checkout for when payment-ui is embedded-components. View the full page at https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing?payment-ui=embedded-components. > Adaptive Pricing n’est pris en charge que pour les éléments Checkout. Cette fonctionnalité n’est pas disponible avec l’API Payment Intents. Adaptive Pricing permet à vos clients de payer dans leur devise locale dans plus de [150 pays](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#supported-currencies). Avec Adaptive Pricing, Stripe détermine la devise de présentation à partir de l’adresse IP publique du client, puis calcule automatiquement le prix localisé et gère toutes les conversions de devises. Utilisez Adaptive Pricing pour : - Afficher les tarifs dans la devise locale de votre client en fonction de sa localisation les tarifs dans la devise locale en fonction du pays à l’aide du composant [Currency Selector Element](https://docs.stripe.com/elements/currency-selector-element.md) - Calculer les prix en temps et avec un taux de change garanti pendant 24 heures - Débloquer les moyens de paiement qui requièrent une présentation en devise locale - Faciliter votre conformité lorsque vous affichez des devises prises en charge #### Effort d’intégration Complexity: 2/5 #### Frais Consultez les informations sur [les frais et notre FAQ](https://support.stripe.com/questions/adaptive-pricing). #### Personnalisation de l’interface utilisateur Placez le [Currency Selector Element](https://docs.stripe.com/elements/currency-selector-element.md) à n’importe quel endroit de votre page de paiement. ## Activer Adaptive Pricing dans le Dashboard [Dashboard] Gérez Adaptive Pricing pour Paiement dans vos [paramètres Paiements](https://dashboard.stripe.com/settings/adaptive-pricing) 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. ## Localisation et formatage des prix [Côté client] 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](https://docs.stripe.com/js/custom_checkout/session_object) 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](https://docs.stripe.com/js/custom_checkout/session_object#custom_checkout_session_object-total-total-amount). L’objet [Checkout Session](https://docs.stripe.com/api/checkout/sessions/object.md) 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](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-presentment_details). Il ne correspondra pas exactement à l’[objet Session](https://docs.stripe.com/js/custom_checkout/session_object) des composants intégrés. #### HTML + JS L’[objet Session](https://docs.stripe.com/js/custom_checkout/session_object) fournit des valeurs monétaires formatées que vous pouvez utiliser directement dans votre interface utilisateur. ```javascript const { actions } = await checkout.loadActions(); const { total } = actions.getSession(); // Display the formatted amounts in your UI document.getElementById('order-total').textContent = total.total.amount; ``` #### React Le hook [useCheckout](https://docs.stripe.com/js/react_stripe_js/checkout/use_checkout) fournit des valeurs de devise formatées que vous pouvez utiliser directement dans votre interface utilisateur. ```jsx import React from 'react'; import {useCheckout} from '@stripe/react-stripe-js/checkout'; const OrderSummary = () => { const checkoutState = useCheckout(); if (checkoutState.type === 'success') { // Display the formatted amounts in your UI return (
Total: {checkoutState.checkout.total.total.amount}
); } }; ``` ## Afficher le Currency Selector Element [Côté client] Le [Currency Selector Element](https://docs.stripe.com/elements/currency-selector-element.md) est un composant d’interface utilisateur intégrable qui facilite la fonction Adaptive Pricing. Affichez-le à côté du total de la commande. > Vous êtes responsable du respect des réglementations applicables à la localisation des tarifs dans votre région ou celles de vos clients. Vous devez afficher le Currency Selector Element lorsque vous utilisez Adaptive Pricing avec Elements. Stripe vous recommande de consulter votre conseiller juridique pour obtenir des conseils adaptés à votre entreprise. #### HTML + JS Créez un élément DOM de type conteneur pour monter le composant Currency Selector Element. Créez ensuite une instance de ce composant à l’aide de [checkout.createCurrencySelectorElement](https://docs.stripe.com/js/custom_checkout/create_currency_selector_element) et montez-le en appelant [element.mount](https://docs.stripe.com/js/element/mount), et en fournissant soit un sélecteur CSS, soit l’élément DOM conteneur. Vous pouvez décider de ne créer le composant Currency Selector Element que lorsque les [Options de devise](https://docs.stripe.com/js/custom_checkout/session_object#custom_checkout_session_object-currencyOptions) sont renseignées. S’il n’y a pas de `currencyOptions` et que le composant Currency Selector Element est monté, rien ne s’affiche. ```html
``` ```javascript const currencySelectorElement = checkout.createCurrencySelectorElement(); currencySelectorElement.mount('#currency-selector'); ``` #### React Montez le composant `CurrencySelectorElement` dans le `CheckoutElementsProvider`. Vous pouvez choisir de monter le `CurrencySelectorElement` uniquement lorsque les [currencyOptions](https://docs.stripe.com/js/react_stripe_js/checkout/use_checkout#react_use_checkout-currencyOptions) sont renseignées. S’il n’existe aucune `currencyOptions` et que le `CurrencySelectorElement` est monté, rien ne s’affiche. ```jsx import React from 'react'; import {CurrencySelectorElement} from '@stripe/react-stripe-js/checkout'; const OrderSummary = () => { return ( ); }; ``` ### 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](https://docs.stripe.com/elements/express-checkout-element.md), 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. ![Élément Currency Selector placé au-dessus de Payment Element](https://b.stripecdn.com/docs-statics-srv/assets/adaptive-pricing-do-illustration.d74714dab5286f4a75521ba5b35b4a3c.png) > #### À faire > > Placez le sélecteur de devises au-dessus du Payment Element. Si vous n’acceptez que les cartes, vous pouvez également le placer directement sous le Payment Element. ## Marquer votre intégration comme prête pour Adaptive Pricing [Côté client] Une fois que vous avez [localiser et formaté vos tarifs](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#localize-prices) et [affiché le sélecteur de devise](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#render-currency-selector-element), marquez votre intégration comme prête pour Adaptive Pricing en définissant le paramètre [adaptivePricing.allowed](https://docs.stripe.com/js/custom_checkout/init#custom_checkout_init-options-adaptivePricing-allowed) lorsque vous initialisez le paiement. #### HTML + JS ```js const checkout = stripe.initCheckoutElementsSdk({ clientSecret, // Mark your integration as ready for Adaptive PricingadaptivePricing: { allowed: true } }); // Use `checkout` to build your checkout page ``` #### React ```jsx >")} options={{ clientSecret, // Mark your integration as ready for Adaptive PricingadaptivePricing: {allowed: true} }} > {/* your components here */} ``` Une fois votre intégration marquée comme prête, vous pouvez gérer Adaptive Pricing dans vos [paramètres de paiement](https://dashboard.stripe.com/settings/adaptive-pricing) dans le Dashboard, ou par [session de paiement](https://docs.stripe.com/api/checkout/sessions.md) à l’aide du paramètre [adaptive_pricing.enabled](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-adaptive_pricing-enabled). ## Configurer des moyens de paiement locaux [Dashboard] 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](https://dashboard.stripe.com/settings/payment_methods) 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 - MB WAY - Naver Pay - Kakao Pay - PAYCO - PayPal - Revolut Pay - Samsung Pay - TWINT - Wechat Pay - Klarna (UE + RU uniquement) - UPI > Pour les abonnements internationaux, Adaptive Pricing ne prend en charge que les paiements par carte bancaire, Link, Apple Pay et Google Pay. ## Test Pour tester la présentation en devise locale, utilisez l’[assistant de test Stripe.js](https://docs.stripe.com/sdks/stripejs-testing-assistant.md#elements-inspector) pour simuler l’emplacement du client et voir comment votre intégration se comportera dans différents pays. Chaque fois qu’il sera possible de présenter un tarif dans la monnaie locale du client dans Checkout, l’objet [Checkout Session](https://docs.stripe.com/api/checkout/sessions/object.md) sera modifié en conséquence. Les champs `currency`, `payment_method_types` et `amount_total` reflèteront la devise locale et un tarif converti. ### Test avec l’adresse e-mail du client Vous pouvez également tester la présentation en devise locale à l’aide d’une adresse e-mail de client formatée par emplacement. Transmettez une adresse e-mail de client contenant un suffixe au format `+location_XX` dans la partie locale de l’e-mail. `XX` doit être un [code pays ISO à deux lettres valide](https://www.nationsonline.org/oneworld/country_code_list.htm). 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`. La devise que vous voyez quand vous affichez la page de paiement avec les Composants Element Currency Selector et Payment utilisant une Checkout Session créée à l’aide d’une adresse e-mail précisant le pays du client est identique à celle qui est présentée à un client du pays en question. Lorsque vous créez une session Checkout, transmettez l’e-mail formaté par lieu sous la forme : [customer_email](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_email) pour simuler un pays particulier. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u <>: \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=1 \ -d mode=payment \ -d ui_mode=elements \ -d return_url="https://example.com/return" \ --data-urlencode customer_email="test+location_FR@example.com" ``` Vous pouvez également créer un objet [Customer](https://docs.stripe.com/api/customers/create.md) et indiquer son adresse e-mail en y ajoutant un suffixe de type `+location_XX`. Les cartes de test Stripe fonctionnent comme d’habitude. ## Restrictions 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](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-currency) soit l’une de vos devises de règlement. Les tarifs sont automatiquement convertis au moment du paiement. Ce comportement s’applique aux [tarifs](https://docs.stripe.com/products-prices/manage-prices.md#prices-create) 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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items-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 : - Contain prices where the customer’s local currency is already defined in the price’s [currency_options](https://docs.stripe.com/payments/checkout/localize-prices/manual-currency-prices.md). For example, if a price has `currency_options` for EUR and GBP, Adaptive Pricing won’t convert to EUR or GBP, but it can still convert to other currencies like CAD or JPY. - Utilisant le paramètre [capture_method](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-capture_method) défini sur `manual`. - Utilisez des [montants personnalisés](https://docs.stripe.com/payments/checkout/pay-what-you-want.md). Les sessions Checkout qui ne sont pas prises en charge par Adaptive Pricing présentent les tarifs dans leur devise d’origine. Consultez notre [page de support](https://support.stripe.com/questions/adaptive-pricing) pour plus d’informations. ## Devises prises en charge Les entreprises des régions prises en charge peuvent automatiquement convertir les tarifs dans les devises locales de leurs clients sur les marchés suivants : ### Amérique du Nord - AG - AW - BS - BB - BZ - BM - CA - KY - CR - DM - DO - GD - GT - HT - HN - MX - JM - PA - KN - LC - VC - TT - US ### Amérique du Sud - BR - BO - CO - CL - FK - GY - PY - PE - UY ### Europe - AL - AD - AT - BE - BA - HR - CY - CZ - DK - EE - FI - FR - DE - GI - GR - HU - IS - IE - IT - LV - LT - LU - MT - MC - MD - ME - NL - MK - NO - PL - PT - RO - SM - RS - SK - SI - ES - SE - CH - UA - GB - VA ### Asie - AF - AM - AZ - BD - BN - KH - CN - GE - HK - IN - ID - IL - JP - KZ - KG - MO - MY - MV - MN - NP - PK - PH - QA - SA - SG - KR - LK - TW - TJ - TH - TR - AE - UZ - VN - YE ### Océanie - AU - PF - NC - NZ - WF ### Afrique - AO - DZ - BJ - BW - BF - BI - CM - CV - CF - TD - CI - DJ - GQ - GA - GM - GN - GW - KE - LR - MG - ML - MU - MA - MZ - NA - NE - CG - RW - SH - ST - SN - ZA - TZ - TG - UG - ZM ## Tarifs - Vous payez 0 % - Vos clients paient des frais allant de 2 à 4 % Vous ne payez pas directement de frais Stripe supplémentaires pour la tarification adaptative, car tous ces frais sont pris en charge par vos clients. Le taux de change fourni par Stripe que vous présentez à vos clients comprend des frais de conversion de 2 à 4 %, ce qui augmente le prix d’achat d’un montant correspondant. Stripe détermine les frais, qui varient dans le but d’augmenter la conversion des clients. Vos clients ne paient pas ces frais s’ils choisissent de payer dans la devise de votre intégration, mais le taux de change et les frais de leur banque peuvent s’appliquer. Pour en savoir plus sur les frais Stripe actuels, consultez notre [page de tarification](https://stripe.com/pricing). ## Taux de change Stripe utilise le taux de change moyen du marché et applique des frais pour garantir le taux par règlement. En savoir plus sur la façon dont Stripe gère les [conversions de devises](https://docs.stripe.com/currencies.md) et les [frais Adaptive Pricing](https://support.stripe.com/questions/adaptive-pricing#:~:text=Adaptive%20Pricing%20is%20a%20Checkout,latest%20Stripe%2Dprovided%20exchange%20rates). ## Remboursements Vous pouvez émettre un remboursement dans votre devise d’intégration et Stripe rembourse votre client dans la devise qu’il a utilisée pour effectuer le paiement. Le remboursement utilise le même taux de change que la transaction initiale, de sorte qu’il n’y a pas de frais supplémentaires pour vous et votre client récupère le montant exact qu’il a payé. Découvrez comment Stripe peut vous aider à gérer vos [remboursements](https://docs.stripe.com/refunds.md). # Page de facture hébergée > This is a Page de facture hébergée for when payment-ui is invoices. View the full page at https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing?payment-ui=invoices. Adaptive Pricing permet à vos clients de payer dans leur devise locale dans plus de [150 pays](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#supported-currencies). Avec Adaptive Pricing, Stripe détermine la devise de présentation à partir de l’adresse IP publique du client, puis calcule automatiquement le prix localisé et gère toutes les conversions de devises. Utilisez Adaptive Pricing pour : - Afficher les tarifs dans la devise locale de votre client en fonction de sa localisation - Calculer les tarifs en temps réel et avec un taux de change garanti pendant 24 heures - Faciliter votre conformité lorsque vous affichez des devises prises en charge #### Effort d’intégration Complexity: 1/5 #### Frais Lisez notre FAQ sur les [frais](https://support.stripe.com/questions/adaptive-pricing). ## Activer Adaptive Pricing dans le Dashboard [Dashboard] Gérez Adaptive Pricing pour les pages de facture hébergée dans vos [paramètres de paiement](https://dashboard.stripe.com/settings/adaptive-pricing) du Dashboard. Vous pouvez activer Adaptive Pricing dans un environnement de test ou en mode production. La désactivation d’Adaptive Pricing affecte les pages de factures hébergées déjà créées. ## Configurer des moyens de paiement locaux [Dashboard] 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. Vous pouvez configurer les moyens de paiement acceptés pour les factures dans vos [paramètres de facture](https://dashboard.stripe.com/settings/billing/invoice) ou lors de la création d’une facture. Adaptive Pricing présente uniquement les moyens de paiement qui prennent en charge à la fois la devise locale du client et la devise dans laquelle vous émettez la facture. ## Destinations des événements et rapports [Côté serveur] Lors de l’envoi d’une facture, l’événement [invoice.sent](https://docs.stripe.com/api/events/types.md#event_types-invoice.sent) affiche le montant et la devise dans lesquels vous envoyez la facture. Une fois la facture payée, utilisez l’ID de facture de l’événement [invoice.payment_succeeded](https://docs.stripe.com/api/events/types.md#event_types-invoice.payment_succeeded) pour récupérer les paiements associés à la facture : #### JSON ```json { "object": {"id": "{{INVOICE_ID}}", "object": "invoice", "amount_paid": 1000, "currency": "usd" ... } } ``` À l’aide de l’API [v1/invoice_payments](https://docs.stripe.com/api/invoice-payment/list.md) : #### curl ```bash curl --request GET \ --url https://api.stripe.com/v1/invoice_payments \ -u sk_test_123: \ --data 'expand[]=data.payment.payment_intent' \ --data limit=20 \ --data invoice='{{INVOICE_ID}}' ``` Si un client paie dans sa monnaie locale, l’objet `PaymentIntent` contient un hachage du champ `presentment_details` qui inclut les champs `presentment_amount` et `presentment_currency`. Lorsqu’une facture est payée, des événements [payment_intent.succeeded](https://docs.stripe.com/api/events/types.md#event_types-payment_intent.succeeded) sont générés pour chaque PaymentIntent associé à la facture. Ces objets contiennent le hachage `presentment_details`. Le montant et la devise de présentation reflètent ce que votre client a payé dans sa devise locale. #### JSON ```json { "id": "{{PAYMENT_INTENT_ID}}", "object": "payment_intent", "currency": "usd", "amount": 1000,"presentment_details": { "presentment_amount": 1370, "presentment_currency": "cad" } } ``` ## Test Pour tester la présentation d’une devise locale sur une page de facture hébergée, créez un objet [Customer](https://docs.stripe.com/api/customers/create.md) avec une adresse e-mail incluant un suffixe précisant le pays, au format `+location_XX` dans la partie locale de l’adresse, où `XX` est un [code pays ISO à deux lettres](https://www.nationsonline.org/oneworld/country_code_list.htm) valide. Par exemple, pour tester la devise présentée à un client français, créez un client et émettez une facture à une adresse e-mail de type `test+location_FR@example.com`. Lorsque vous accédez à l’URL de la page de facture hébergée envoyée à une adresse e-mail précisant le pays du client, vous avez la possibilité de payer dans la devise locale du pays spécifié. ![Création d’un client avec une adresse e-mail précisant le pays du client lors de la création de la facture](https://b.stripecdn.com/docs-statics-srv/assets/adaptive_pricing_hip_customer.eb3b947172844c48105619355fc3b986.png) ## Restrictions Adaptive Pricing n’est pas pris en charge pour les entreprises indiennes ou pour les factures qui acceptent les débits préautorisés canadiens. Vous devez émettre les factures dans l’une de vos devises de règlement. Si vous traitez les paiements via une plateforme, nous exigeons que la facture soit émise dans la devise de règlement du marchand enregistré pour la transaction. Sur la page de facturation hébergée, les prix sont automatiquement convertis dans la devise appropriée. Les factures qui ne sont pas prises en charge par Adaptive Pricing continuent de présenter les tarifs dans la devise d’émission de la facture. ## Devises prises en charge Les entreprises des régions prises en charge peuvent automatiquement convertir les tarifs dans les devises locales de leurs clients sur les marchés suivants : ### Amérique du Nord - AG - AW - BS - BB - BZ - BM - CA - KY - CR - DM - DO - GD - GT - HT - HN - MX - JM - PA - KN - LC - VC - TT - US ### Amérique du Sud - BR - BO - CO - CL - FK - GY - PY - PE - UY ### Europe - AL - AD - AT - BE - BA - HR - CY - CZ - DK - EE - FI - FR - DE - GI - GR - HU - IS - IE - IT - LV - LT - LU - MT - MC - MD - ME - NL - MK - NO - PL - PT - RO - SM - RS - SK - SI - ES - SE - CH - UA - GB - VA ### Asie - AF - AM - AZ - BD - BN - KH - CN - GE - HK - IN - ID - IL - JP - KZ - KG - MO - MY - MV - MN - NP - PK - PH - QA - SA - SG - KR - LK - TW - TJ - TH - TR - AE - UZ - VN - YE ### Océanie - AU - PF - NC - NZ - WF ### Afrique - AO - DZ - BJ - BW - BF - BI - CM - CV - CF - TD - CI - DJ - GQ - GA - GM - GN - GW - KE - LR - MG - ML - MU - MA - MZ - NA - NE - CG - RW - SH - ST - SN - ZA - TZ - TG - UG - ZM ## Tarifs - Vous payez 0 % - Vos clients paient des frais allant de 2 à 4 % Vous ne payez pas directement de frais Stripe supplémentaires pour la tarification adaptative, car tous ces frais sont pris en charge par vos clients. Le taux de change fourni par Stripe que vous présentez à vos clients comprend des frais de conversion de 2 à 4 %, ce qui augmente le prix d’achat d’un montant correspondant. Stripe détermine les frais, qui varient dans le but d’augmenter la conversion des clients. Vos clients ne paient pas ces frais s’ils choisissent de payer dans la devise dans laquelle vous avez émis votre facture, mais le taux de change et les frais de leur banque peuvent s’appliquer. Pour en savoir plus sur les frais Stripe actuels, consultez notre [page de tarification](https://stripe.com/pricing). ## Taux de change Stripe utilise le taux de change moyen du marché et applique des frais pour garantir le taux par règlement. En savoir plus sur la façon dont Stripe gère les [conversions de devises](https://docs.stripe.com/currencies.md) et les [frais Adaptive Pricing](https://support.stripe.com/questions/adaptive-pricing#:~:text=Adaptive%20Pricing%20is%20a%20Checkout,latest%20Stripe%2Dprovided%20exchange%20rates). ## Remboursements Vous pouvez émettre un remboursement dans la devise dans laquelle vous avez émis votre facture et Stripe rembourse votre client dans la devise qu’il a utilisée pour effectuer le paiement. Le remboursement utilise le même taux de change que la transaction initiale, de sorte qu’il n’y a pas de frais supplémentaires pour vous et votre client récupère le montant exact qu’il a payé. Découvrez comment Stripe peut vous aider à gérer vos [remboursements](https://docs.stripe.com/refunds.md). ## See also - [FAQ sur la fonctionnalité Adaptive Pricing](https://support.stripe.com/questions/adaptive-pricing)