Convertir automatiquement les tarifs en devise locale

Convertissez automatiquement les tarifs exprimés en USD ou CAD dans la devise locale des clients situés dans les pays suivants :

• Autriche
• Australie
• Belgique
• Brésil
• Bulgarie
• Canada
• Chine
• Croatie
• Chypre
• République tchèque
• Danemark
• Estonie
• Finlande
• France
• Allemagne
• Grèce
• Hong Kong
• Hongrie
• Inde
• Irlande
• Italie
• Japon
• Lettonie
• Lituanie
• Luxembourg
• Malte
• Mexique
• Pays-Bas
• Norvège
• Pologne
• Portugal
• Roumanie
• Singapour
• Slovaquie
• Slovénie
• Espagne
• Suède
• Suisse
• Royaume-Uni
• États-Unis

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

Pour les clients situés aux Pays-Bas par exemple, Checkout et Payment Links convertissent les tarifs en euros et présentent 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.

Pour bénéficier de la conversion automatique des devises, la devise de vos tarifs doit être identique à votre devise de règlement par défaut, à savoir USD ou CAD. 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.

La conversion automatique des devises ne s’applique pas aux sessions Checkout :

• contenant des tarifs multidevises définis manuellement.
• en mode subscription.
• utilisant des paramètres Connect comme application_fee_amount, on_behalf_of et transfer_data.
• utilisant le paramètre capture_method défini sur manual.
• Définissant une valeur de devise à la création.

Pour les sessions qui ne sont pas prises en charge par la conversion automatique des devises, Checkout présente les tarifs dans leur devise d’origine.

Stripe utilise le taux de change moyen du marché et applique une marge afin de garantir le taux pour la durée de la session Checkout (jusqu’à 24 heures), jusqu’au règlement. Si le taux de change évolue de plus de 2 % sur cette période, Stripe peut utiliser un taux de change actualisé pour le calcul de votre virement.

En savoir plus sur la façon dont Stripe gère les conversions de devises.

Stripe rembourse vos clients dans la devise utilisée pour le paiement, en appliquant son taux de change le plus récent. Cela signifie que le montant du remboursement peut être supérieur ou inférieur à celui du paiement, en fonction de l’évolution du taux de change.

Exemple de remboursement

Dans cet exemple, nous ignorons les frais Stripe pour plus de simplicité. Supposons la situation suivante :

1. Vous êtes une entreprise établie aux États-Unis qui utilise Checkout pour vendre un produit à 100 USD et vous avez activé la conversion automatique des devises.
2. Un client basé au Canada consulte votre page Checkout, voit s’afficher le tarif de 137 CAD au taux de change de 1,37 CAD pour 1 USD, et finalise l’achat.
3. Stripe traite le paiement et convertit les 137 CAD en 100 USD pour vous payer dans votre devise de règlement.
4. Par la suite, lorsque le taux de change est passé à 1,40 CAD pour 1 USD, vous remboursez intégralement le client.
5. Stripe déduit 97,86 USD de votre compte et les convertit au taux de 1,40 CAD pour 1 USD afin de rembourser 137 CAD au client.

Découvrez comment Stripe peut vous aider à gérer vos remboursements.

Les transactions ayant fait l’objet d’une conversion automatique des devises se voient appliquer des frais de transaction standard :

• 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 notre page des tarifs pour en savoir plus sur ces frais.

En fonction de la devise sélectionnée par l’utilisateur, les objets CheckoutSession et PaymentIntent sous-jacents sont automatiquement actualisés pour tenir compte de la devise sélectionnée et du montant. Une fois que l’utilisateur a payé dans sa devise locale, la devise et le montant total de l’objet CheckoutSession sont convertis dans la devise locale et contiennent le hash currency_conversion indiquant le montant qu’aurait payé le client dans la devise par défaut. En savoir plus sur les fonds versés sur votre compte après déduction des frais.

L’événement de webhook checkout.session.completed contient un hachage currency_conversion qui inclut les attributs amount_total et amount_subtotal dans la devise source_currency. Les montants reflètent la somme qu’aurait payé votre client dans la devise d’origine.

{
  "id": 
'{{EVENT_ID}}',
  "object": "event",
  "type": "checkout.session.completed",
  "data": {
    "object": {
      "id": 
'{{SESSION_ID}}',
      "object": "checkout.session",
      "currency": "cad",
      "amount_total": 2055,

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.

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.

Checkout

Lorsque vous créez une session Checkout, transmettez l’adresse e-mail précisant le pays du client dans le champ customer_email.

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

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.

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.

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.