Tarifs manuels des devises

Add multiple currencies to a price

You can manually add multiple currencies to a Price using the Dashboard or the API.

Dashboard

1. Navigate to a product in the Dashboard.
2. Click +Add another price to create a new price.
3. Fill in the price and select a currency. This first currency is the price’s default currency. Make sure all of your prices have the same default currency.
4. Click +Add a price by currency to search and select from supported currencies, adding them to your price.
5. Use the multi-currency price you created by passing its ID into line items when you create a Checkout Session.

API Prices

Add multiple currencies to a Price by specifying currency_options when using the Prices API.

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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"

In this example, the Price is created in USD, with additional currency options in EUR and JPY.

Local payment methods

Checkout et Payment Links présentent aux clients des moyens de paiement populaires compatibles avec leur devise locale.

For example, for customers located in the Netherlands, Checkout and Payment Links convert prices to EUR and also present popular Dutch payment methods like iDEAL.

Vous pouvez configurer les moyens de paiement que vous souhaitez accepter dans les paramètres des moyens de paiement.

Grilles tarifaires

Les tarifs manuels fonctionnent également avec les grilles tarifaires. 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.

Supported integrations

Checkout automatically presents the local currency to customers if all of the following are true:

• The Checkout Session’s prices, shipping rates, and discounts have the relevant currency in their currency_options.
• If a price on the Checkout Session has an upsell, the upsell’s price has the relevant currency in its currency_options.
• For a Checkout Session using Stripe Tax, the tax_behavior on the Checkout Session is specified for the relevant currency for all of the Checkout Session’s prices, shipping rates, and discounts.
• You didn’t specify a currency during Checkout Session creation.

If Checkout can’t localize the currency because the relevant currency option or tax_behavior is missing, the Session presents to the customer in the default currency. The default currency must be the same across all prices, shipping rates, and discounts.

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.

Fees

Stripe’s standard transaction fees apply to automatically converted transactions:

• 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

See the pricing page for more details about these fees.

Spécifier une devise

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 https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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.

Tests

Pour tester la présentation en devise locale de Checkout, de Payment Links et de la grille tarifaire, 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 valide, pour indiquer sa localisation.

For example, to test currency presentment for a customer in France, pass in an email such as 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 pour simuler un paiement à partir d’un pays particulier.

curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -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 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 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 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 afin de tester les devises présentées aux clients de différents pays.