# Tarifs manuels des devises Présentez vos tarifs dans la devise de vos clients grâce aux tarifs manuels. # 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/checkout/localize-prices/manual-currency-prices?payment-ui=stripe-hosted. Stripe prend en charge la saisie manuelle des tarifs dans différentes devises lors de la création de [produits](https://docs.stripe.com/products-prices/overview.md#get-started). Stripe recommande toutefois d’utiliser [Adaptive Pricing](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md) plutôt que des tarifs saisis manuellement afin de réduire le risque de fluctuation des taux de change et d’activer automatiquement la prise en charge de plus de 100 devises locales. Utilisez les tarifs saisis manuellement au lieu d’Adaptive Pricing dans les cas suivants : - Adaptive Pricing n’est pas [pris en charge](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#restrictions) pour votre entreprise ou votre configuration Checkout. - Vous prenez en charge une région dans laquelle vous pouvez assumer les fluctuations du taux de change de la devise. Les tarifs multidevises définis manuellement remplacent la tarification adaptative, même si la fonction Adaptative Pricing est activée. ## Créer un tarif multidevises [Dashboard] [Côté serveur] #### Dashboard 1. Accédez à un produit dans le [Dashboard](https://dashboard.stripe.com/products?active=true). 1. Cliquez sur **+ Ajouter un autre tarif** pour créer un nouveau tarif. 1. Renseignez le tarif et sélectionnez une devise. Cette première devise sera la devise par défaut du tarif. Veillez à ce que tous vos tarifs aient la même devise par défaut. 1. Cliquez sur **+Ajouter un tarif par devise** pour rechercher et sélectionner les devises prises en charge et les ajouter à votre tarif. 1. Utilisez le tarif multidevise que vous avez créé en transmettant son ID dans les [postes de facture](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items-price) lorsque vous créez une session Checkout. #### API Ajoutez plusieurs devises à un objet Price en spécifiant des `currency_options` lorsque vous utilisez l’[API Prices](https://docs.stripe.com/api/prices/object.md#price_object-currency_options). ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d currency=usd \ -d unit_amount=1000 \ -d "currency_options[eur][unit_amount]=950" \ -d "currency_options[jpy][unit_amount]=1500" \ -d "product_data[name]=My Product" ``` Dans cet exemple, le tarif est créé en USD, avec des devises supplémentaires possibles comme l’EUR et le JPY. ## Créer une session Checkout [Côté serveur] Créez une session de paiement en utilisant le tarif multidevises : ```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 \ --data-urlencode "success_url=https://example.com/success" ``` ## Tests [Côté serveur] [Côté client] Pour tester la présentation en devise locale de Checkout, de Payment Links et de la [grille tarifaire](https://docs.stripe.com/payments/checkout/pricing-table.md), transmettez l’adresse e-mail du client accompagnée d’un suffixe au format`+location_XX`, où `XX` est un [code pays ISO à deux lettres](https://www.nationsonline.org/oneworld/country_code_list.htm) valide, pour indiquer sa localisation. 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 suivez l’URL d’une session Checkout, d’un lien de paiement ou d’une grille tarifaire 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 success_url="https://example.com/success" \ --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. 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 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. ### Test de grille tarifaire Pour la grille tarifaire, transmettez une adresse e-mail précisant le pays du client dans l’attribut [customer-email](https://docs.stripe.com/payments/checkout/pricing-table.md#customer-email) afin de tester les devises présentées aux clients de différents pays. ## Optional: Spécifier une devise [Côté serveur] Lorsque vous utilisez des tarifs multi-devises dans une session, Checkout se charge automatiquement de présenter le tarif dans la devise de vos clients. Toutefois, vous pouvez empêcher cette action en précisant une devise lors de la création de la session Checkout. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d currency=eur \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` Dans cet exemple, la devise de la session Checkout est toujours EUR (`eur`), quel que soit le pays du client. ## Moyens de paiement locaux La session Checkout présente aux clients des moyens de paiement populaires compatibles avec leur devise locale. Par exemple, pour les clients situés aux Pays-Bas, la session Checkout convertit les tarifs en euros et présente des moyens de paiement néerlandais répandus comme iDEAL. Vous pouvez configurer les moyens de paiement que vous souhaitez accepter dans les [paramètres des moyens de paiement](https://dashboard.stripe.com/settings/payment_methods). ## Grilles tarifaires Les tarifs manuels fonctionnent également avec les [grilles tarifaires](https://docs.stripe.com/payments/checkout/pricing-table.md). Pour que les clients voient votre grille tarifaire s’afficher dans leur devise locale, tous les tarifs qui y figurent doivent inclure la devise locale du client dans leur paramètre `currency_options`. Si vous utilisez Stripe Tax, ils doivent également inclure un paramètre `tax_behavior` pour la devise donnée. ## Intégrations prises en charge Checkout présente automatiquement les tarifs dans la devise locale du client si toutes les conditions suivantes sont respectées : - La devise concernée apparaît dans le paramètre `currency_options` des tarifs, les frais de livraison et les réductions de la session Checkout. - Dans le cas d’un tarif de vente additionnelle pour une session Checkout, celui-ci présente la devise appropriée dans le paramètre `currency_options`. - Si la session Checkout utilise Stripe Tax, la devise concernée apparaît dans le paramètre `tax_behavior` de tous les tarifs, frais de livraison et réductions de la session. - Vous n’avez pas spécifié de devise lors de la création de la session Checkout. Si la devise voulue ou le paramètre `tax_behavior` concerné manque, Checkout ne parviendra pas à localiser la devise et la session présentera au client la devise par défaut. La devise par défaut doit être la même pour tous les tarifs, frais de livraison et réductions. ### Restrictions La présentation du tarif en devise locale n’est pas disponible pour les sessions Checkout qui : - utilisent des taux de taxe manuels. - utilisent `payment_intent_data.application_fee_amount` ou `payment_intent_data.transfer_data.amount`. ## Frais Les transactions ayant fait l’objet d’une conversion automatique des devises se voient appliquer les frais de transaction standard de Stripe : - Frais liés aux cartes ou aux moyens de paiement - Frais pour carte ou moyen de paiement international (le cas échéant) - Frais de conversion de devises Consultez la [page des tarifs](https://stripe.com/pricing) pour en savoir plus sur ces frais. # 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/checkout/localize-prices/manual-currency-prices?payment-ui=embedded-form. Stripe prend en charge la saisie manuelle des tarifs dans différentes devises lors de la création de [produits](https://docs.stripe.com/products-prices/overview.md#get-started). Stripe recommande toutefois d’utiliser [Adaptive Pricing](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md) plutôt que des tarifs saisis manuellement afin de réduire le risque de fluctuation des taux de change et d’activer automatiquement la prise en charge de plus de 100 devises locales. Utilisez les tarifs saisis manuellement au lieu d’Adaptive Pricing dans les cas suivants : - Adaptive Pricing n’est pas [pris en charge](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#restrictions) pour votre entreprise ou votre configuration Checkout. Contactez [adaptive-pricing-beta@stripe.com](mailto:adaptive-pricing-beta@stripe.com) pour accéder à la version bêta. - Vous prenez en charge une région dans laquelle vous pouvez assumer les fluctuations du taux de change de la devise. Les tarifs multidevises définis manuellement remplacent la tarification adaptative, même si la fonction Adaptative Pricing est activée. ## Créer un tarif multidevises [Dashboard] [Côté serveur] #### Dashboard 1. Accédez à un produit dans le [Dashboard](https://dashboard.stripe.com/products?active=true). 1. Cliquez sur **+ Ajouter un autre tarif** pour créer un nouveau tarif. 1. Renseignez le tarif et sélectionnez une devise. Cette première devise sera la devise par défaut du tarif. Veillez à ce que tous vos tarifs aient la même devise par défaut. 1. Cliquez sur **+Ajouter un tarif par devise** pour rechercher et sélectionner les devises prises en charge et les ajouter à votre tarif. 1. Utilisez le tarif multidevise que vous avez créé en transmettant son ID dans les [postes de facture](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items-price) lorsque vous créez une session Checkout. #### API Ajoutez plusieurs devises à un objet Price en spécifiant des `currency_options` lorsque vous utilisez l’[API Prices](https://docs.stripe.com/api/prices/object.md#price_object-currency_options). ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d currency=usd \ -d unit_amount=1000 \ -d "currency_options[eur][unit_amount]=950" \ -d "currency_options[jpy][unit_amount]=1500" \ -d "product_data[name]=My Product" ``` Dans cet exemple, le tarif est créé en USD, avec des devises supplémentaires possibles comme l’EUR et le JPY. ## Créer une session Checkout [Côté serveur] Créez une session de paiement en utilisant le tarif multidevises : ```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 \ --data-urlencode "return_url=https://example.com/return" ``` ## Tests [Côté serveur] [Côté client] 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`. La devise que vous voyez quand vous suivez l’URL d’une session Checkout 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’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 pays spécifique. ```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 indiquer son adresse e-mail en y ajoutant un suffixe de type `+location_XX`. Les cartes de test Stripe fonctionnent comme d’habitude. Chaque fois qu’il sera possible de présenter un tarif dans la monnaie locale du client, 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. ## Optional: Spécifier une devise [Côté serveur] Lorsque vous utilisez des tarifs multidevises, la session Checkout se charge automatiquement de présenter le tarif dans la devise de vos clients. Toutefois, vous pouvez empêcher cette action en précisant une devise lors de la création de la session Checkout. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d currency=eur \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` Dans cet exemple, la devise de la session Checkout est toujours EUR (`eur`), quel que soit le pays du client. ## Moyens de paiement locaux La session Checkout présente aux clients des moyens de paiement populaires compatibles avec leur devise locale. Par exemple, pour les clients situés aux Pays-Bas, la session Checkout convertit les tarifs en euros et présente des moyens de paiement néerlandais répandus comme iDEAL. Vous pouvez configurer les moyens de paiement que vous souhaitez accepter dans les [paramètres des moyens de paiement](https://dashboard.stripe.com/settings/payment_methods). ## Intégrations prises en charge Checkout présente automatiquement les tarifs dans la devise locale du client si toutes les conditions suivantes sont respectées : - La devise concernée apparaît dans le paramètre `currency_options` des tarifs, les frais de livraison et les réductions de la session Checkout. - Dans le cas d’un tarif de vente additionnelle pour une session Checkout, celui-ci présente la devise appropriée dans le paramètre `currency_options`. - Si la session Checkout utilise Stripe Tax, la devise concernée apparaît dans le paramètre `tax_behavior` de tous les tarifs, frais de livraison et réductions de la session. - Vous n’avez pas spécifié de devise lors de la création de la session Checkout. Si la devise voulue ou le paramètre `tax_behavior` concerné manque, Checkout ne parviendra pas à localiser la devise et la session présentera au client la devise par défaut. La devise par défaut doit être la même pour tous les tarifs, frais de livraison et réductions. ### Restrictions La présentation du tarif en devise locale n’est pas disponible pour les sessions Checkout qui : - utilisent des taux de taxe manuels. - utilisent `payment_intent_data.application_fee_amount` ou `payment_intent_data.transfer_data.amount`. ## Frais Les transactions ayant fait l’objet d’une conversion automatique des devises se voient appliquer les frais de transaction standard de Stripe : - Frais liés aux cartes ou aux moyens de paiement - Frais pour carte ou moyen de paiement international (le cas échéant) - Frais de conversion de devises Consultez la [page des tarifs](https://stripe.com/pricing) pour en savoir plus sur ces frais.