Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous

Gérer plusieurs devises

Gérez plusieurs devises pour les paiements, les transferts, les virements et les frais de plateforme.

Copier la page

Stripe prend en charge le traitement des paiements dans plus de 135 devises. Cela vous permet de présenter vos tarifs dans la devise locale du client et d’éviter les frais de conversion monétaire pour vos clients. La présentation locale peut également améliorer les taux de conversion et d’autorisation de paiement.

Des conversions monétaires peuvent intervenir dans les paiements, les transferts, les virements, les collectes de frais de plateforme et d’autres types de transactions. Une conversion est effectuée lorsque la devise de départ d’un flux de fonds est différente de la devise de destination. Par exemple, pour les paiements, une conversion est effectuée lorsque la devise de présentation diffère de la devise de règlement. Dans le cas des transferts, une conversion intervient lorsque le solde de la plateforme qui envoie le transfert est libellé dans une devise différente de celle du solde du compte connecté qui le reçoit.

Utiliser l’API FX Quotes dans Connect

Utilisez l’APIFX Quotes pour localiser vos tarifs dans les devises de vos clients et réduire l’incertitude liée aux fluctuations des taux de change. Vous pouvez spécifier une cotation de change lors de la création d’un PaymentIntent avec la devise de présentation de votre client. Vous pouvez également spécifier une cotation de change lors de la création d’un transfert pour confirmer le montant de règlement sur le compte connecté. Pour plus d’informations, reportez-vous à la section sur les Cotations de change.

Exemples de scénarios de change

Sur les différents types de paiement Connect, les effets de change se produisent de différentes manières.

Paiements directs

Les paiements directs sont toujours convertis de la devise de présentation dans la devise par défaut du compte connecté. La commission de la plateforme est convertie dans la devise par défaut de la plateforme.

Par exemple, supposons que vous acceptiez un paiement en USD pour un compte connecté. Le compte connecté reçoit des fonds en EUR. Les fonds envoyés au compte connecté sont convertis en EUR et vos frais de plateforme sont reconvertis de l’EUR en USD.

Vous pouvez utiliser des cotations de change à durée prolongée de l’API FX Quotes afin de réduire l’incertitude de change sur les paiements directs. Lorsque vous créez un paiement direct, transmettez l’ID de cotation de change au Payment Intent. Définissez la devise du client final sur from_currency. Définissez la devise de règlement par défaut de votre compte connecté sur to_currency.

Créer une cotation de change

Command Line
curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d to_currency=gbp \
  -d "from_currencies[]"=usd \
  -d "from_currencies[]"=eur \
  -d lock_duration=hour \
  -d "usage[type]"=payment

Bien que les paiements directs soient dans la devise par défaut du compte connecté, votre plateforme perçoit ses frais plateforme pour les paiements directs dans la devise par défaut de la plateforme. L’utilisation de cotations de change à durée prolongée sur les paiements directs dans l’API FX Quotes n’a aucune incidence sur le taux de change auquel les frais de plateforme sont convertis.

Disponibilité du compte bancaire ou de la carte de débitAction de conversion
Disponible pour la devise de règlementPas de conversion
Non disponible pour la devise de règlementStripe convertit la commission de la plateforme en fonction de la devise par défaut du compte de la plateforme

Si votre plateforme n’applique pas de frais de plateforme et conserve une partie du paiement, ces fonds sont versés de la même manière que les autres paiements sur le compte de votre plateforme.

Paiements indirects sans on_behalf_of

Pour le traitement de paiements indirects sans on_behalf_of, Stripe les convertit d’abord de la devise de présentation dans la devise par défaut de la plateforme. Les fonds envoyés au compte connecté sont ensuite convertis dans la devise par défaut du compte connecté.

  • Si vous utilisez application_fee_amount, nous percevons les frais de plateforme après la conversion dans la devise par défaut du compte connecté. Les frais restent dans cette devise lorsqu’ils sont ajoutés à la plateforme.
  • Si vous utilisez transfer_data[amount], nous percevons les frais après la première conversion de devise, et ils restent dans la devise par défaut de la plateforme.

Remarque

Ce flux de paiement est soumis aux politiques en matière de paiements internationaux et aux politiques régionales de Stripe.

Par exemple, supposons que vous acceptiez un paiement indirect pour un compte connecté en EUR. Le compte connecté règle en GBP et votre plateforme règle en USD. Le paiement est converti de l’EUR en USD, et les fonds envoyés au compte connecté sont convertis en GBP.

  • Si vous utilisez application_fee_amount, le montant des frais de plateforme est converti de l’EUR en GBP et nous le déduisons du montant qui est réglé sur le compte connecté.
  • Si vous utilisez transfer_data[amount], les frais sont conservés en USD après avoir été convertis à partir de la devise de présentation initiale.

Vous pouvez utiliser les cotations de change à durée prolongée de l’API FX Quotes afin de réduire l’incertitude de change sur les paiements indirects sans on_behalf_of. Lorsque vous créez un paiement, transmettez l’ID de cotation de devises au Payment Intent. Dans l’exemple ci-dessus, cela vous donne la certitude du taux de change utilisé pour la conversion de l’EUR (la devise du client final) en USD (la devise de la plateforme). Dans les cotations de change, définissez la devise du client final sur from_currency. Définissez la devise de règlement par défaut de votre plateforme sur to_currency. Vous ne pouvez pas utiliser de cotations de change pour toute conversion intervenant lors du transfert de la plateforme vers le compte connecté, ni pour toute conversion des frais de plateforme.

Création d’une cotation de change

Command Line
curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d to_currency=gbp \
  -d "from_currencies[]"=usd \
  -d "from_currencies[]"=eur \
  -d lock_duration=hour \
  -d "usage[type]"=payment \
  -d "usage[payment][destination]"=
{{CONNECTED_ACCOUNT_ID}}

Nous ne convertissons pas les frais de plateforme perçues à l’aide du paramètre application_fee_amount pour les paiements indirects. Les plateformes reçoivent toujours leurs frais de plateforme dans la devise de règlement du compte connecté. Utilisez le paramètre transfer_data[amount] pour transférer une partie inférieure du montant de la transaction et percevoir les frais dans la devise de règlement par défaut de la plateforme.

Paiements indirects avec on_behalf_of

Pour le traitement de paiements indirects avec on_behalf_of, Stripe les convertit d’abord de la devise de présentation dans la devise par défaut du compte connecté. Les frais de plateforme restent dans la devise du compte connecté, que vous utilisiez application_fee_amount ou transfer_data[amount].

Par exemple, le compte connecté accepte un paiement en USD, mais le règle en EUR. Le paiement est converti en EUR et nous l’envoyons au compte connecté en EUR. Nous percevons les frais en euros, que vous utilisiez application_fee_amount ou transfer_data[amount].

Vous pouvez utiliser les cotations de change à durée prolongée de l’API FX Quotes afin de réduire l’incertitude de change sur les paiements indirects avec on_behalf_of. Lorsque vous créez un paiement, transmettez l’ID de cotation de change au Payment Intent. Dans l’exemple ci-dessus, cela vous donne la certitude du taux de change utilisé pour la conversion de l’USD (la devise du client final) en EUR (la devise du compte connecté). Dans les cotations de change, définissez la devise du client final sur from_currency. Définissez la devise de règlement par défaut de votre compte connecté sur to_currency.

Création d’une cotation de change

Command Line
curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d to_currency=gbp \
  -d "from_currencies[]"=usd \
  -d "from_currencies[]"=eur \
  -d lock_duration=hour \
  -d "usage[type]"=payment \
  -d "usage[payment][on_behalf_of]"=
{{CONNECTED_ACCOUNT_ID}}
 \
  -d "usage[payment][destination]"=
{{CONNECTED_ACCOUNT_ID}}

Nous ne convertissons pas les frais de plateforme perçues à l’aide du paramètre application_fee_amount pour les paiements indirects. Les plateformes reçoivent toujours leurs frais de plateforme dans la devise de règlement du compte connecté. Utilisez le paramètre transfer_data[amount] pour transférer une partie inférieure du montant de la transaction et percevoir les frais dans la devise de règlement par défaut de la plateforme.

Si vous créez des paiements sur la plateforme en utilisant les paramètres destination ou on_behalf_of, vous accumulerez probablement des soldes dans plusieurs devises. Si vous ne disposez pas de comptes bancaires pour ces autres devises, Stripe propose un moyen de verser les soldes dans les devises autres que celles par défaut sur le compte bancaire par défaut de votre plateforme.

Stripe convertit les devises, qui sont représentées sous forme de virements manuels avec currency défini comme devise du solde source :

Command Line
curl https://api.stripe.com/v1/payouts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=xaf

Tant que le solde contient des fonds suffisants pour la devise spécifiée, Stripe convertit automatiquement les fonds dans la devise par défaut de votre compte bancaire. Nous ne prenons pas en charge de cotations de change de devis pour les virements.

Remarque

Ce flux de paiement est soumis aux politiques en matière de paiements internationaux et aux politiques régionales de Stripe.

Paiements et transferts distincts sans on_behalf_of

Nous convertissons les paiements distincts dans la devise par défaut de la plateforme à partir de la devise de présentation, et la plateforme transfère ensuite les fonds vers le compte connecté. Les paramètres application_fee_amount et transfer_data[amount] ne sont pas utilisés pour collecter les frais, car la plateforme peut choisir le montant approprié à envoyer au moment du transfert.

Prenons l’exemple d’un paiement en USD. La devise par défaut du compte de la plateforme est la GBP. Une conversion de l’USD en GBP s’effectue lors de l’étape de paiement. Lorsque la plateforme transfère ces fonds vers un compte connecté dont la devise par défaut est l’EUR, une autre conversion de devise a lieu, cette fois de la GBP en EUR.

Vous pouvez utiliser les cotations de change à durée prolongée de l’API FX Quotes afin de réduire l’incertitude de change lorsque vous utilisez des paiements et transferts distincts sans on_behalf_of. Ceci vaut à la fois pour la partie paiement et pour la partie transfert autonome.

Devis de change pour le paiement

Command Line
curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d to_currency=gbp \
  -d "from_currencies[]"=usd \
  -d "from_currencies[]"=cad \
  -d lock_duration=hour \
  -d "usage[type]"=payment

Cotation de change pour le transfert

Command Line
curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d to_currency=eur \
  -d "from_currencies[]"=gbp \
  -d lock_duration=five_minutes \
  -d "usage[type]"=transfer \
  -d "usage[transfer][destination]"=
{{CONNECTED_ACCOUNT_ID}}

Lorsque vous créez un paiement, transmettez l’ID de cotation de devises au Payment Intent. Dans l’exemple ci-dessus, cela vous donne la certitude du taux de change utilisé pour la conversion de l’USD (devise du client final) en GBP (devise de la plateforme Connect). Dans les cotations de change, définissez la devise du client final sur from_currency. Définissez la devise de règlement par défaut de votre plateforme sur to_currency.

Lors de la création d’un transfert, transmettez l’ID de cotation de devises au transfert. Dans l’exemple ci-dessus, cela vous donne la certitude du taux de change utilisé pour la conversion du GBP (la devise de la plateforme Connect) en EUR (la devise du compte connecté). Dans les cotations de change, définissez la devise de la plateforme Connect sur from_currency. Définissez la devise par défaut de votre compte connecté sur to_currency.

Remarque

Ce flux de paiement est soumis aux politiques en matière de paiements internationaux et aux politiques régionales de Stripe.

Paiements et transferts distincts avec on_behalf_of

Nous convertissons les paiements distincts dans la devise par défaut du compte connecté à partir de la devise de présentation, et la plateforme transfère ensuite les fonds vers le compte connecté. Nous n’utilisons pas les paramètres application_fee_amount ettransfer_data[amount] pour collecter les frais, car la plateforme peut choisir le montant approprié à envoyer au moment du transfert.

Prenons l’exemple d’un paiement en USD. La devise par défaut du compte de la plateforme est la GBP. Une conversion de l’USD en GBP s’effectue lors de l’étape de paiement. Lorsque la plateforme transfère ces fonds vers un compte connecté dont la devise par défaut est l’EUR, une autre conversion de devise a lieu, cette fois de la GBP en EUR.

Vous pouvez utiliser les cotations de change prolongées de l’API FX Quotes afin de réduire l’incertitude liée au change sur les paiements et transferts distincts avec on_behalf_of. Ceci vaut à la fois pour la partie paiement et pour la partie transfert autonome

Cotation de change pour l’étape de paiement

Command Line
curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d to_currency=gbp \
  -d "from_currencies[]"=usd \
  -d lock_duration=hour \
  -d "usage[type]"=payment \
  -d "usage[payment][on_behalf_of]"=
{{CONNECTED_ACCOUNT_ID}}

Cotation de change pour l’étape de transfert

Command Line
curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d to_currency=eur \
  -d "from_currencies[]"=gbp \
  -d lock_duration=five_minutes \
  -d "usage[type]"=transfer \
  -d "usage[transfer][destination]"=
{{CONNECTED_ACCOUNT_ID}}

Lorsque vous créez un paiement, transmettez l’ID de cotation de devises au Payment Intent. Dans l’exemple ci-dessus, cela vous donne la certitude du taux de change utilisé pour la conversion de l’USD (devise du client final) en GBP (devise de la plateforme Connect). Dans les cotations de change, définissez la devise du client final sur from_currency. Définissez la devise de règlement par défaut de votre plateforme sur to_currency.

Lors de la création d’un transfert, transmettez l’ID de cotation de devises au transfert. Dans l’exemple ci-dessus, cela vous donne la certitude du taux de change utilisé pour la conversion du GBP (devise de la plateforme Connect) en EUR (devise du compte connecté). Dans les cotations de change, définissez la devise de la plateforme Connect sur from_currency. Définissez la devise par défaut de votre compte connecté sur to_currency.

Remarque

Ce flux de paiement est soumis aux politiques en matière de paiements internationaux et aux politiques régionales de Stripe.

Taux de change sur les remboursements

Lorsque vous remboursez un paiement qui a été initialement converti dans une autre devise, nous utilisons le taux de change en vigueur au moment du remboursement. Ceci vaut que vous ayez utilisé ou non des cotations de change pour définir votre taux de change sur le paiement initial. Stripe ne facture pas de frais de change pour toute conversion sur le remboursement. Stripe ne rembourse pas les frais de change facturés lors de la transaction initiale.

Taux de change sur les virements

La devise de règlement est la devise dans laquelle vous pouvez recevoir vos payouts. Consultez la section Devises de règlement prises en charge.

Selon la disponibilité du compte bancaire ou de la carte de débit, le virement d’un solde donne lieu aux opérations suivantes :

Disponibilité du compte bancaire ou de la carte de débitAction de conversion
Disponible pour la devisePas de conversion
Plusieurs comptes bancaires ou cartes de débit disponibles pour la devisePas de conversion : Stripe utilise le compte bancaire ou la carte de débit définis par défaut dans le paramètre default_for_currency
Non disponible pour la deviseStripe convertit le solde du virement en fonction de la devise par défaut du compte Stripe
Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc