Monnaie Adaptative

Adaptive Currency affiche les prix des produits dans la devise locale du client au lieu de les afficher uniquement dans votre devise de base. Lorsque cette fonctionnalité est activée, le paiement utilise par défaut la devise locale détectée pour les pays pris en charge, avec la possibilité de revenir à votre devise de base.

Fonctionnement

Votre devise de base correspond à la devise dans laquelle vous avez défini le prix du produit ou de l’option supplémentaire — il peut s’agir de toute devise que Dodo Payments peut débiter, et pas uniquement de USD. Adaptive Currency convertit ce prix de base selon les taux de change en temps réel. Pour définir votre propre prix fixe par devise ou par pays, consultez Localized Pricing.

Principaux avantages

Paiement localisé — Les prix s’affichent par défaut dans la devise locale du client
Davantage de moyens de paiement — Débloque les moyens de paiement disponibles uniquement pour la devise locale
Remboursements dans la même devise — Remboursez le client dans la devise utilisée pour son paiement
Tarification avancée — Active Purchasing Power Parity et Charm Pricing pour optimiser automatiquement les prix selon le marché

Activer Adaptive Currency

Open Settings

Connectez-vous à votre Merchant Dashboard, puis accédez à Settings → Business.

Enable Adaptive Currency

Activez Adaptive Currency. Vous pouvez la désactiver à tout moment.

Les modifications s’appliquent uniquement aux transactions futures.

Save and Test

Enregistrez vos paramètres, puis vérifiez qu’un paiement de test affiche les prix dans votre devise locale lorsqu’elle est prise en charge.

Interrupteur Adaptive Currency dans Settings

Expérience client

Lorsque Adaptive Currency est activée :

Détection — Le système détecte le pays du client à partir de son adresse de facturation
Sélection de la devise — Si le pays est pris en charge, les prix s’affichent par défaut dans la devise locale. Les clients peuvent revenir à votre devise de base
Moyens de paiement — Les moyens de paiement locaux s’affichent lorsque cela s’applique
Paiement — Le paiement est effectué dans la devise sélectionnée

Conversion et frais

Adaptive Currency débite le client dans sa devise locale en utilisant les taux de change en temps réel. Les frais varient selon le montant de la commande :

4 % pour les commandes inférieures à $500
3 % pour les commandes de $500 à $1,500
2 % pour les commandes supérieures à $1,500

Par défaut, ces frais s’ajoutent au prix affiché et sont supportés par le client. Avec le paramètre Fees Inclusive, vous pouvez prendre les frais à votre charge : le client voit le même prix dans sa devise locale et les frais sont déduits de votre règlement.

Activer Fees Inclusive

Open Settings

Accédez à Settings → Business et activez Adaptive Currency si ce n’est pas déjà fait.

Enable Fees Inclusive

Une fois Adaptive Currency activée, activez l’interrupteur Fees Inclusive dans la même section.

Mode	Ce que voit le client	Règlement du marchand
Exclusif (par défaut)	Prix local + frais de 2 à 4 % supplémentaires	Prix de base complet
Inclusif	Prix local (inchangé)	Prix de base moins les frais de 2 à 4 %

Remplacer la valeur par requête

Vous pouvez remplacer la valeur par défaut du marchand pour chaque requête en transmettant adaptive_currency_fees_inclusive (booléen) lors d’un paiement ponctuel, d’un abonnement à la demande (on_demand.adaptive_currency_fees_inclusive), d’un débit d’abonnement ou d’un changement de plan. Dans les sessions de paiement, ce paramètre est accepté uniquement pour les abonnements à la demande, en tant que subscription_data.on_demand.adaptive_currency_fees_inclusive, et non au niveau supérieur de la requête :

// Note: POST /payments is deprecated. Checkout sessions don't accept
// `adaptive_currency_fees_inclusive` for one-time payments, so this override
// still runs through the one-time payment route.
const payment = await client.payments.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  customer: { customer_id: 'cus_123' },
  billing: { country: 'US' },
  adaptive_currency_fees_inclusive: true, // override the business setting for this payment
  return_url: 'https://yoursite.com/return'
});

Les transactions INR → INR sont toujours traitées comme inclusives, indépendamment du paramètre de l’entreprise ou du remplacement défini par requête.

Lorsqu’une règle Localized Pricing s’applique, la transaction est toujours traitée comme inclusive, indépendamment de votre paramètre Fees Inclusive ou de tout remplacement défini par requête. Le client paie exactement le montant localisé que vous avez défini et les frais de conversion sont déduits de votre règlement.

Montants minimums

Chaque paiement doit atteindre le montant minimum dans la devise utilisée par le client, et les abonnements ont des minimums plus élevés que les paiements ponctuels. Les mêmes minimums s’appliquent à tous les modes de paiement. La vérification utilise le total, taxes comprises.

Devise de facturation	Paiements ponctuels	Abonnements
USD	$0.50	$1.00
EUR et GBP	0.50 EUR, 0.30 GBP	0.50 EUR, 0.30 GBP
Toutes les autres devises	Le minimum indiqué dans Devises prises en charge, et au moins l’équivalent de $0.50	Le minimum indiqué dans Devises prises en charge, et au moins l’équivalent de $1.00

Les paiements dans des devises autres que USD, EUR et GBP sont réglés en USD. Pour ces devises, le checkout vérifie d’abord le prix converti en USD, avant l’ajout des frais Adaptive Currency, puis vérifie le montant dans la devise du client. Le montant doit réussir les deux vérifications ; le minimum effectif peut donc être supérieur au minimum indiqué pour la devise. Par exemple, le minimum indiqué pour l’AED est de 2.00 AED, mais un abonnement en AED doit avoir une valeur d’au moins $1.00, soit environ 3.70 AED. Un abonnement de 2.00 AED échoue à la vérification en USD. Si un paiement est inférieur au minimum, l’API renvoie TOTAL_PAYMENT_AMOUNT_BELOW_MINIMUM_AMOUNT. Le message indique le minimum qui n’a pas été atteint. Pour un paiement dans une autre devise, il peut s’agir du minimum en USD, comme Minimum amount of 1.00 USD is required to process payment.

Devises prises en charge

Le tableau indique le montant minimum pour chaque devise. Le minimum s’applique aux paiements ponctuels et aux abonnements. Consultez Montants minimums pour connaître la vérification USD supplémentaire.

Code de devise	Nom de la devise	Pays	Montant minimum
AED	Dirham des Émirats arabes unis	Émirats arabes unis	2.00 AED
ALL	Lek albanais	Albanie	50.00 ALL
AMD	Dram arménien	Arménie	500.00 AMD
AUD	Dollar australien	Australie, Nauru	0.50 AUD
AWG	Florin arubais	Aruba	2.00 AWG
AZN	Manat azerbaïdjanais	Azerbaïdjan	2.00 AZN
BAM	Mark convertible de Bosnie-Herzégovine	Bosnie-Herzégovine	2.00 BAM
BDT	Taka bangladais	Bangladesh	100.00 BDT
BMD	Dollar bermudien	Bermudes	1.00 BMD
BND	Dollar de Brunei	Brunei	1.00 BND
BOB	Boliviano bolivien	Bolivie	5.00 BOB
BRL	Réal brésilien	Brésil	0.50 BRL
BSD	Dollar bahaméen	Bahamas	1.00 BSD
BWP	Pula botswanais	Botswana	15.00 BWP
BZD	Dollar bélizien	Belize	2.00 BZD
CAD	Dollar canadien	Canada	0.50 CAD
CHF	Franc suisse	Suisse, Liechtenstein	0.50 CHF
CLP	Peso chilien	Chili	500 CLP
CNY	Yuan chinois	Chine	4.00 CNY
CRC	Colón costaricien	Costa Rica	500.00 CRC
CZK	Couronne tchèque	République tchèque	15.00 CZK
DKK	Couronne danoise	Danemark, Groenland	2.50 DKK
DOP	Peso dominicain	République dominicaine	100.00 DOP
EGP	Livre égyptienne	Égypte	50.00 EGP
ETB	Birr éthiopien	Éthiopie	100.00 ETB
EUR	Euro	Autriche, Belgique, Chypre, Estonie, Finlande, France, Allemagne, Grèce, Irlande, Italie, Lettonie, Lituanie, Luxembourg, Malte, Pays-Bas, Portugal, Slovaquie, Slovénie, Espagne, Andorre, Monaco, Croatie, Saint-Marin, Monténégro	0.50 EUR
FJD	Dollar fidjien	Fidji	2.00 FJD
GBP	Livre sterling	Royaume-Uni	0.30 GBP
GEL	Lari géorgien	Géorgie	3.00 GEL
GMD	Dalasi gambien	Gambie	100.00 GMD
GTQ	Quetzal guatémaltèque	Guatemala	10.00 GTQ
GYD	Dollar guyanais	Guyana	200.00 GYD
HKD	Dollar de Hong Kong	Hong Kong	4.00 HKD
HNL	Lempira hondurien	Honduras	25.00 HNL
HUF	Forint hongrois	Hongrie	175.00 HUF
IDR	Roupie indonésienne	Indonésie	8500.00 IDR
ILS	Nouveau shekel israélien	Israël	3.00 ILS
INR	Roupie indienne	Inde	5.00 INR
JPY	Yen japonais	Japon	50 JPY
KRW	Won sud-coréen	Corée du Sud	50 KRW
KZT	Tenge kazakh	Kazakhstan	500.00 KZT
LKR	Roupie sri-lankaise	Sri Lanka	300.00 LKR
LRD	Dollar libérien	Liberia	200.00 LRD
LSL	Loti du Lesotho	Lesotho	20.00 LSL
MAD	Dirham marocain	Maroc	10.00 MAD
MKD	Denar macédonien	Macédoine du Nord	50.00 MKD
MOP	Pataca de Macao	Macao	10.00 MOP
MUR	Roupie mauricienne	Maurice	50.00 MUR
MVR	Rufiyaa maldivienne	Maldives	15.00 MVR
MWK	Kwacha malawite	Malawi	2000.00 MWK
MXN	Peso mexicain	Mexique	10.00 MXN
MYR	Ringgit malaisien	Malaisie	4.00 MYR
NGN	Naira nigérian	Nigeria	2000.00 NGN
NOK	Couronne norvégienne	Norvège	3.00 NOK
NPR	Roupie népalaise	Népal	150.00 NPR
NZD	Dollar néo-zélandais	Nouvelle-Zélande	1.00 NZD
PEN	Sol péruvien	Pérou	3.00 PEN
PGK	Kina de Papouasie-Nouvelle-Guinée	Papouasie-Nouvelle-Guinée	4.00 PGK
PHP	Peso philippin	Philippines	50.00 PHP
PLN	Zloty polonais	Pologne	2.00 PLN
PYG	Guaraní paraguayen	Paraguay	4000 PYG
QAR	Riyal qatari	Qatar	3.00 QAR
RON	Leu roumain	Roumanie	2.00 RON
RSD	Dinar serbe	Serbie	60.00 RSD
SAR	Riyal saoudien	Arabie saoudite	2.00 SAR
SBD	Dollar des Îles Salomon	Îles Salomon	10.00 SBD
SCR	Roupie des Seychelles	Seychelles	15.00 SCR
SEK	Couronne suédoise	Suède	3.00 SEK
SGD	Dollar de Singapour	Singapour	0.50 SGD
SZL	Lilangeni swazi	Eswatini	20.00 SZL
THB	Baht thaïlandais	Thaïlande	25.00 THB
TOP	Paʻanga tongien	Tonga	2.00 TOP
TRY	Livre turque	Turquie	20.00 TRY
TWD	Nouveau dollar taïwanais	Taïwan	20.00 TWD
TZS	Shilling tanzanien	Tanzanie	3000.00 TZS
UYU	Peso uruguayen	Uruguay	50.00 UYU
VND	Dong vietnamien	Vietnam	12000 VND
WST	Tala samoan	Samoa	2.00 WST
XAF	Franc CFA d’Afrique centrale	Cameroun, République centrafricaine, Tchad, République du Congo, Guinée équatoriale, Gabon	300 XAF
XOF	Franc CFA d’Afrique de l’Ouest	Bénin, Burkina Faso, Côte d’Ivoire, Guinée-Bissau, Mali, Niger, Sénégal, Togo	300 XOF
ZAR	Rand sud-africain	Afrique du Sud	20.00 ZAR
ZMW	Kwacha zambien	Zambie	30.00 ZMW

Remboursements et ajustements

Dodo Payments effectue les remboursements dans la devise utilisée initialement par le client, selon le dernier taux de change. Le montant dans votre devise de base reste fixe dans votre dashboard, sur les factures et dans le remboursement. Selon l’évolution des taux de change, le client peut recevoir un montant supérieur ou inférieur au montant initial dans sa devise locale.

Les frais Adaptive Currency (frais de change) ne sont pas remboursés.

Exemple de remboursement

Vous vendez un produit pour 100 USD avec Adaptive Currency activé
Un client canadien voit 137 CAD, selon un taux de change de 1.37 CAD pour 1 USD, et finalise l’achat
Dodo Payments traite le paiement en convertissant 137 CAD en 100 USD pour votre règlement
Plus tard, le taux de change passe à 1.40 CAD pour 1 USD et vous effectuez un remboursement intégral
Dodo Payments déduit 100 USD et rembourse 140 CAD au client

Factures et fiscalité

Les factures affichent uniquement le montant dans la devise de règlement
Les taxes et les frais de plateforme sont calculés sur le montant dans la devise de règlement
Exemple : une vente de $10 convertie en 36 AED est toujours affichée à $10 dans le Dashboard et sur les factures

Tous les montants sont arrondis conformément à la logique d’arrondi interne de Dodo Payments.

Définir la devise de facturation pour chaque checkout

Transmettez billing_currency pour définir explicitement la devise de facturation d’une session de checkout :

Lorsque Adaptive Currency est désactivé, billing_currency est ignoré.

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_one_time_or_subscription',
      quantity: 1
    }
  ],
  billing_currency: 'AED',
  return_url: 'https://example.com/return'
});

Pages associées

Purchasing Power Parity

Réduisez automatiquement les prix selon le pays. Nécessite Adaptive Currency.

Charm Pricing

Arrondissez les prix convertis pour obtenir des terminaisons nettes comme 49.99. Nécessite Adaptive Currency.

Localized Pricing

Définissez un prix exact par pays ou par devise au lieu d’une conversion automatique.

Tax-Inclusive Pricing

Contrôlez si vos prix incluent les taxes.

Checkout Session

Créez des sessions de checkout avec une configuration de devise de facturation.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Fonctionnement

Principaux avantages

Activer Adaptive Currency

Expérience client

Conversion et frais

Activer Fees Inclusive

Remplacer la valeur par requête

Montants minimums

Devises prises en charge

Remboursements et ajustements

Exemple de remboursement

Factures et fiscalité

Définir la devise de facturation pour chaque checkout

Pages associées

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

​Fonctionnement

​Principaux avantages

​Activer Adaptive Currency

​Expérience client

​Conversion et frais

​Activer Fees Inclusive

​Remplacer la valeur par requête

​Montants minimums

​Devises prises en charge

​Remboursements et ajustements

​Exemple de remboursement

​Factures et fiscalité

​Définir la devise de facturation pour chaque checkout

​Pages associées

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

Fonctionnement

Principaux avantages

Activer Adaptive Currency

Expérience client

Conversion et frais

Activer Fees Inclusive

Remplacer la valeur par requête

Montants minimums

Devises prises en charge

Remboursements et ajustements

Exemple de remboursement

Factures et fiscalité

Définir la devise de facturation pour chaque checkout

Pages associées