Vai al contenuto principale
Adaptive Currency ti consente di mostrare prezzi localizzati e accettare pagamenti nelle valute locali dei clienti. Questo riduce l’attrito al checkout e crea fiducia.

Cos’è la Valuta Adattiva?

La Valuta Adattiva visualizza i prezzi dei prodotti nella valuta locale del cliente anziché in una valuta globale fissa (ad esempio, USD). Quando è abilitata, il checkout predefinito è la valuta locale rilevata per i paesi supportati, con l’opzione di passare a USD. Adaptive Currency converte il tuo prezzo base ai tassi di cambio live. Per impostare il tuo prezzo fisso per valuta o paese, consulta Prezzi Localizzati.

Vantaggi Principali

  • Esperienza di pagamento localizzata: I prezzi appaiono nella valuta locale di default.
  • Più metodi di pagamento: Sblocca i metodi di pagamento disponibili per la valuta locale.
  • Rimborsi nella stessa valuta: Rimborsa il cliente nella valuta con cui ha pagato.

Abilita Adaptive Currency

1

Open Settings

Accedi al tuo dashboard del commerciante e vai su Impostazioni → Azienda.
2

Toggle Adaptive Pricing

Abilita l’interruttore Adaptive Pricing. Puoi disabilitarlo in qualsiasi momento.
Le modifiche si applicano solo alle transazioni future.
3

Confirm and Save

Salva le tue impostazioni.
Verifica che un test di checkout mostri i prezzi nella tua valuta locale quando supportato.
Adaptive Currency

Esperienza del Cliente

  1. Rilevamento: Il sistema rileva il paese del cliente in base all’indirizzo di fatturazione.
  2. Selezione della valuta: Se il paese è supportato, i prezzi vengono mostrati nella valuta locale di default. I clienti possono passare a USD.
  3. Metodi di pagamento: I metodi di pagamento localizzati appaiono dove applicabile.
  4. Checkout: Il pagamento viene completato nella valuta selezionata.

Conversione e Commissioni

Adaptive Currency addebita al cliente nella loro valuta locale utilizzando gli ultimi tassi di cambio.
  • Tu paghi: 0% (default) o 2–4% (quando le commissioni inclusive sono abilitate)
  • I tuoi clienti pagano: 2–4% basato sul valore dell’ordine (default) o 0% (quando le commissioni inclusive sono abilitate)
Commissioni a scaglioni applicate al checkout:
  • 4% per ordini inferiori a $500
  • 3% da 500a500 a 1.500
  • 2% oltre $1.500

Scegli chi sopporta la commissione

Per default, le commissioni di valuta adattiva vengono aggiunte sopra il prezzo visualizzato e sopportate dal cliente. Con l’impostazione Fees Inclusive, puoi assorbire la commissione tu stesso: il cliente vede lo stesso prezzo in valuta locale che vedrebbe sempre, e la commissione viene detratta dal tuo incasso.
1

Enable Adaptive Pricing

Vai su Impostazioni → Azienda e abilita l’interruttore Adaptive Pricing se non l’hai già fatto.
2

Toggle Fees Inclusive

Una volta attivato Adaptive Pricing, abilita il sotto-interruttore Fees Inclusive nella stessa sezione.
ModalitàIl cliente vedeIl commerciante incassa
Esclusiva (default)Prezzo locale + commissione del 2–4% sopraPrezzo base completo
InclusivaPrezzo locale (invariato)Prezzo base meno la commissione del 2–4%
Puoi anche sovrascrivere il default del commerciante per richiesta passando adaptive_currency_fees_inclusive (booleano) in una sessione di checkout, pagamento o abbonamento on-demand:
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
  adaptive_currency_fees_inclusive: true, // override the business setting for this session
  return_url: 'https://yoursite.com/return'
});
Le transazioni INR → INR sono sempre trattate come inclusive indipendentemente dall’impostazione aziendale o dall’override per richiesta.
Quando una regola di Prezzi Localizzati corrisponde, la transazione è sempre trattata come inclusiva, indipendentemente dalla tua impostazione Fees Inclusive o da qualsiasi override per richiesta. Il cliente paga esattamente l’importo localizzato che hai impostato, e la commissione di conversione viene detratta dal tuo incasso.

Valute Supportate

Codice ValutaNome ValutaPaesiImporto Minimo
AEDDirham degli Emirati Arabi UnitiEmirati Arabi Uniti2,00 AED
ALLLek AlbaneseAlbania50,00 ALL
AMDDram ArmenoArmenia500,00 AMD
AUDDollaro AustralianoAustralia, Nauru0,50 AUD
AWGFiorino ArubanoAruba2,00 AWG
AZNManat AzeroAzerbaigian2,00 AZN
BAMMarco Convertibile Bosnia-ErzegovinaBosnia ed Erzegovina2,00 BAM
BDTTaka BengaleseBangladesh100,00 BDT
BMDDollaro delle BermudaBermuda1,00 BMD
BNDDollaro del BruneiBrunei1,00 BND
BOBBoliviano BolivianoBolivia5,00 BOB
BRLReal BrasilianoBrasile0,50 BRL
BSDDollaro delle BahamasBahamas1,00 BSD
BWPPula del BotswanaBotswana15,00 BWP
BZDDollaro di BelizeBelize2,00 BZD
CADDollaro CanadeseCanada0,50 CAD
CHFFranco SvizzeroSvizzera, Liechtenstein0,50 CHF
CLPPeso CilenoCile1000,00 CLP
CNYYuan CineseCina4,00 CNY
CRCColón CostaricanoCosta Rica500,00 CRC
CZKCorona CecaRepubblica Ceca15,00 CZK
DKKCorona DaneseDanimarca, Groenlandia2,50 DKK
DOPPeso DominicanoRepubblica Dominicana100,00 DOP
EGPSterlina EgizianaEgitto50,00 EGP
ETBBirr EtiopeEtiopia100,00 ETB
EUREuroAustria, Belgio, Cipro, Estonia, Finlandia, Francia, Germania, Grecia, Irlanda, Italia, Lettonia, Lituania, Lussemburgo, Malta, Paesi Bassi, Portogallo, Slovacchia, Slovenia, Spagna, Andorra, Monaco, Croazia, San Marino, Montenegro0,50 EUR
FJDDollaro FijianoFigi2,00 FJD
GBPSterlina BritannicaRegno Unito0,30 GBP
GELLari GeorgianoGeorgia3,00 GEL
GMDDalasi GambianoGambia100,00 GMD
GTQQuetzal GuatemaltecoGuatemala10,00 GTQ
GYDDollaro della GuyanaGuyana200,00 GYD
HKDDollaro di Hong KongHong Kong4,00 HKD
HNLLempira HonduregnaHonduras25,00 HNL
HUFFiorino UnghereseUngheria175,00 HUF
IDRRupia IndonesianaIndonesia8500,00 IDR
ILSNuovo Shekel IsraelianoIsraele3,00 ILS
INRRupia IndianaIndia5,00 INR
JPYYen GiapponeseGiappone50 JPY
KRWWon SudcoreanoCorea del Sud50 KRW
KZTTenge KazakoKazakistan500,00 KZT
LKRRupia di Sri LankaSri Lanka300,00 LKR
LRDDollaro LiberianoLiberia200,00 LRD
LSLLoti LesothoLesotho20,00 LSL
MADDirham MarocchinoMarocco10,00 MAD
MKDDenaro MacedoneMacedonia del Nord50,00 MKD
MOPPataca di MacaoMacao10,00 MOP
MURRupia MaurizianaMauritius50,00 MUR
MVRRufiyaa MaldivianaMaldive15,00 MVR
MWKKwacha MalawianoMalawi2000,00 MWK
MXNPeso MessicanoMessico10,00 MXN
MYRRinggit MaleseMalaysia4,00 MYR
NGNNaira NigerianaNigeria2000,00 NGN
NOKCorona NorvegeseNorvegia3,00 NOK
NPRRupia NepaleseNepal150,00 NPR
NZDDollaro NeozelandeseNuova Zelanda1,00 NZD
PENSol PeruvianoPerù3,00 PEN
PGKKina Papuana Nuova GuineanaPapua Nuova Guinea4,00 PGK
PHPPeso FilippinoFilippine50,00 PHP
PLNZloty PolaccoPolonia2,00 PLN
PYGGuaraní ParaguaianoParaguay4000 PYG
QARRial QatarenseQatar3,00 QAR
RONLeu RumenoRomania2,00 RON
RSDDinaro SerboSerbia60,00 RSD
SARRiyal SauditaArabia Saudita2,00 SAR
SBDDollaro delle Isole SalomoneIsole Salomone10,00 SBD
SCRRupia delle SeychellesSeychelles15,00 SCR
SEKCorona SvedeseSvezia3,00 SEK
SGDDollaro di SingaporeSingapore0,50 SGD
SZLLilangeni SwaziEswatini20,00 SZL
THBBaht TailandeseTailandia25,00 THB
TOPPaʻanga TonganaTonga2,00 TOP
TRYLira TurcaTurchia20,00 TRY
TWDNuovo Dollaro di TaiwanTaiwan20,00 TWD
TZSScellino TanzanianoTanzania3000,00 TZS
UYUPeso UruguayanoUruguay50,00 UYU
VNDDong VietnamitaVietnam12000 VND
WSTTala SamoanoSamoa2,00 WST
XAFFranco CFA dell’Africa CentraleCamerun, Repubblica Centrafricana, Ciad, Repubblica del Congo, Guinea Equatoriale, Gabon300 XAF
XOFFranco CFA dell’Africa OccidentaleBenin, Burkina Faso, Costa d’Avorio, Guinea-Bissau, Mali, Niger, Senegal, Togo300 XOF
ZARRand SudafricanoSud Africa20,00 ZAR
ZMWKwacha ZambianoZambia30,00 ZMW

Rimborsi e Regolazioni

Dodo Payments emette rimborsi nella valuta con cui il cliente ha pagato originariamente, utilizzando il tasso di cambio più recente. L’importo globale in USD rimane fisso sulla tua dashboard, nelle fatture e nel rimborso. Ciò significa che il cliente può ricevere più o meno dell’importo iniziale in valuta locale a seconda delle variazioni di FX.
Le commissioni di Adaptive Currency, che sono generalmente quelle di FX, non vengono rimborsate.
Esempio di rimborso
  1. Vendi un prodotto per 100 USD con Adaptive Currency abilitato.
  2. Un cliente canadese vede 137 CAD a un tasso di cambio di 1.37 CAD per 1 USD e completa l’acquisto.
  3. Elaboriamo il pagamento, convertendo 137 CAD in 100 USD per il tuo incasso.
  4. Successivamente, il tasso di cambio cambia a 1.40 CAD per 1 USD e emetti un rimborso completo.
  5. Detraghiamo 100 USD e rimborsiamo il cliente 140 CAD.

Fatture e Tassazione

  • Le fatture mostrano solo l’importo nella valuta di regolamento.
  • Le tasse e le commissioni della piattaforma sono calcolate sull’importo nella valuta di regolamento.
  • Esempio: una vendita di 10convertitain36AEDsiriflettecomunquecome10 convertita in 36 AED si riflette comunque come 10 nella Dashboard e nelle fatture.
Tutti gli importi vengono arrotondati secondo la logica di arrotondamento interna di Dodo Payments.

Esempi di Integrazione

Sessioni di Checkout con valuta di fatturazione Passa billing_currency per impostare esplicitamente la valuta di fatturazione per la sessione.
Quando Adaptive Pricing è disabilitato, billing_currency viene ignorato.
const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_one_time_or_subscription',
      quantity: 1
    }
  ],
  billing_currency: 'AED',
  return_url: 'https://example.com/return'
});

Checkout Session

Configura la Valuta di Fatturazione utilizzando la nostra API di Sessione Checkout.
Ultima modifica il 26 giugno 2026