Valuta Adattiva

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?

Adaptive Currency mostra i prezzi dei prodotti nella valuta locale del cliente invece che solo nella tua valuta di base. Quando è abilitato, il checkout utilizza per impostazione predefinita la valuta locale rilevata per i Paesi supportati, con la possibilità di tornare alla tua valuta di base. La tua valuta di base è quella in cui hai definito il prezzo del prodotto o dell’add-on: può essere qualsiasi valuta che Dodo Payments è in grado di addebitare, non solo USD. Adaptive Currency converte quel prezzo di base utilizzando i tassi di cambio aggiornati. Per impostare invece un prezzo fisso personalizzato 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

Open Settings

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

Toggle Adaptive Pricing

Abilita l’interruttore Adaptive Pricing. Puoi disabilitarlo in qualsiasi momento.

Le modifiche si applicano solo alle transazioni future.

Confirm and Save

Salva le tue impostazioni.

Verifica che un test di checkout mostri i prezzi nella tua valuta locale quando supportato.

Esperienza del Cliente

Rilevamento: il sistema rileva il Paese del cliente in base all’indirizzo di fatturazione.
Selezione della valuta: se il Paese è supportato, i prezzi vengono mostrati per impostazione predefinita nella valuta locale. I clienti possono tornare alla tua valuta di base.
Metodi di pagamento: vengono mostrati i metodi di pagamento locali, ove applicabili.
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 $500 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.

Enable Adaptive Pricing

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

Toggle Fees Inclusive

Una volta attivato Adaptive Pricing, abilita il sotto-interruttore Fees Inclusive nella stessa sezione.

Modalità	Il cliente vede	Il commerciante incassa
Esclusiva (default)	Prezzo locale + commissione del 2–4% sopra	Prezzo base completo
Inclusiva	Prezzo locale (invariato)	Prezzo base meno la commissione del 2–4%

Puoi anche sovrascrivere il valore predefinito del merchant per ogni richiesta passando adaptive_currency_fees_inclusive (booleano) per un pagamento una tantum, un abbonamento on-demand (on_demand.adaptive_currency_fees_inclusive), un addebito dell’abbonamento o una modifica del piano. Non è accettato nelle sessioni di checkout:

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'
});

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 Valuta	Nome Valuta	Paesi	Importo Minimo
AED	Dirham degli Emirati Arabi Uniti	Emirati Arabi Uniti	2,00 AED
ALL	Lek Albanese	Albania	50,00 ALL
AMD	Dram Armeno	Armenia	500,00 AMD
AUD	Dollaro Australiano	Australia, Nauru	0,50 AUD
AWG	Fiorino Arubano	Aruba	2,00 AWG
AZN	Manat Azero	Azerbaigian	2,00 AZN
BAM	Marco Convertibile Bosnia-Erzegovina	Bosnia ed Erzegovina	2,00 BAM
BDT	Taka Bengalese	Bangladesh	100,00 BDT
BMD	Dollaro delle Bermuda	Bermuda	1,00 BMD
BND	Dollaro del Brunei	Brunei	1,00 BND
BOB	Boliviano Boliviano	Bolivia	5,00 BOB
BRL	Real Brasiliano	Brasile	0,50 BRL
BSD	Dollaro delle Bahamas	Bahamas	1,00 BSD
BWP	Pula del Botswana	Botswana	15,00 BWP
BZD	Dollaro di Belize	Belize	2,00 BZD
CAD	Dollaro Canadese	Canada	0,50 CAD
CHF	Franco Svizzero	Svizzera, Liechtenstein	0,50 CHF
CLP	Peso Cileno	Cile	1000,00 CLP
CNY	Yuan Cinese	Cina	4,00 CNY
CRC	Colón Costaricano	Costa Rica	500,00 CRC
CZK	Corona Ceca	Repubblica Ceca	15,00 CZK
DKK	Corona Danese	Danimarca, Groenlandia	2,50 DKK
DOP	Peso Dominicano	Repubblica Dominicana	100,00 DOP
EGP	Sterlina Egiziana	Egitto	50,00 EGP
ETB	Birr Etiope	Etiopia	100,00 ETB
EUR	Euro	Austria, Belgio, Cipro, Estonia, Finlandia, Francia, Germania, Grecia, Irlanda, Italia, Lettonia, Lituania, Lussemburgo, Malta, Paesi Bassi, Portogallo, Slovacchia, Slovenia, Spagna, Andorra, Monaco, Croazia, San Marino, Montenegro	0,50 EUR
FJD	Dollaro Fijiano	Figi	2,00 FJD
GBP	Sterlina Britannica	Regno Unito	0,30 GBP
GEL	Lari Georgiano	Georgia	3,00 GEL
GMD	Dalasi Gambiano	Gambia	100,00 GMD
GTQ	Quetzal Guatemalteco	Guatemala	10,00 GTQ
GYD	Dollaro della Guyana	Guyana	200,00 GYD
HKD	Dollaro di Hong Kong	Hong Kong	4,00 HKD
HNL	Lempira Honduregna	Honduras	25,00 HNL
HUF	Fiorino Ungherese	Ungheria	175,00 HUF
IDR	Rupia Indonesiana	Indonesia	8500,00 IDR
ILS	Nuovo Shekel Israeliano	Israele	3,00 ILS
INR	Rupia Indiana	India	5,00 INR
JPY	Yen Giapponese	Giappone	50 JPY
KRW	Won Sudcoreano	Corea del Sud	50 KRW
KZT	Tenge Kazako	Kazakistan	500,00 KZT
LKR	Rupia di Sri Lanka	Sri Lanka	300,00 LKR
LRD	Dollaro Liberiano	Liberia	200,00 LRD
LSL	Loti Lesotho	Lesotho	20,00 LSL
MAD	Dirham Marocchino	Marocco	10,00 MAD
MKD	Denaro Macedone	Macedonia del Nord	50,00 MKD
MOP	Pataca di Macao	Macao	10,00 MOP
MUR	Rupia Mauriziana	Mauritius	50,00 MUR
MVR	Rufiyaa Maldiviana	Maldive	15,00 MVR
MWK	Kwacha Malawiano	Malawi	2000,00 MWK
MXN	Peso Messicano	Messico	10,00 MXN
MYR	Ringgit Malese	Malaysia	4,00 MYR
NGN	Naira Nigeriana	Nigeria	2000,00 NGN
NOK	Corona Norvegese	Norvegia	3,00 NOK
NPR	Rupia Nepalese	Nepal	150,00 NPR
NZD	Dollaro Neozelandese	Nuova Zelanda	1,00 NZD
PEN	Sol Peruviano	Perù	3,00 PEN
PGK	Kina Papuana Nuova Guineana	Papua Nuova Guinea	4,00 PGK
PHP	Peso Filippino	Filippine	50,00 PHP
PLN	Zloty Polacco	Polonia	2,00 PLN
PYG	Guaraní Paraguaiano	Paraguay	4000 PYG
QAR	Rial Qatarense	Qatar	3,00 QAR
RON	Leu Rumeno	Romania	2,00 RON
RSD	Dinaro Serbo	Serbia	60,00 RSD
SAR	Riyal Saudita	Arabia Saudita	2,00 SAR
SBD	Dollaro delle Isole Salomone	Isole Salomone	10,00 SBD
SCR	Rupia delle Seychelles	Seychelles	15,00 SCR
SEK	Corona Svedese	Svezia	3,00 SEK
SGD	Dollaro di Singapore	Singapore	0,50 SGD
SZL	Lilangeni Swazi	Eswatini	20,00 SZL
THB	Baht Tailandese	Tailandia	25,00 THB
TOP	Paʻanga Tongana	Tonga	2,00 TOP
TRY	Lira Turca	Turchia	20,00 TRY
TWD	Nuovo Dollaro di Taiwan	Taiwan	20,00 TWD
TZS	Scellino Tanzaniano	Tanzania	3000,00 TZS
UYU	Peso Uruguayano	Uruguay	50,00 UYU
VND	Dong Vietnamita	Vietnam	12000 VND
WST	Tala Samoano	Samoa	2,00 WST
XAF	Franco CFA dell’Africa Centrale	Camerun, Repubblica Centrafricana, Ciad, Repubblica del Congo, Guinea Equatoriale, Gabon	300 XAF
XOF	Franco CFA dell’Africa Occidentale	Benin, Burkina Faso, Costa d’Avorio, Guinea-Bissau, Mali, Niger, Senegal, Togo	300 XOF
ZAR	Rand Sudafricano	Sud Africa	20,00 ZAR
ZMW	Kwacha Zambiano	Zambia	30,00 ZMW

Rimborsi e Regolazioni

Dodo Payments emette i rimborsi nella valuta utilizzata originariamente dal cliente per il pagamento, applicando il tasso di cambio più recente. L’importo nella tua valuta di base rimane invariato nella dashboard, nelle fatture e nel rimborso. Ciò significa che il cliente potrebbe ricevere un importo superiore o inferiore rispetto all’importo originale nella valuta locale, a seconda delle variazioni del cambio.

Le commissioni di Adaptive Currency, che sono generalmente quelle di FX, non vengono rimborsate.

Esempio di rimborso

Vendi un prodotto per 100 USD con Adaptive Currency abilitato.
Un cliente canadese vede 137 CAD a un tasso di cambio di 1.37 CAD per 1 USD e completa l’acquisto.
Elaboriamo il pagamento, convertendo 137 CAD in 100 USD per il tuo incasso.
Successivamente, il tasso di cambio cambia a 1.40 CAD per 1 USD e emetti un rimborso completo.
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 $10 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.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Cos’è la Valuta Adattiva?

Vantaggi Principali

Abilita Adaptive Currency

Esperienza del Cliente

Conversione e Commissioni

Scegli chi sopporta la commissione

Valute Supportate

Rimborsi e Regolazioni

Fatture e Tassazione

Esempi di Integrazione

Checkout Session

​Cos’è la Valuta Adattiva?

​Vantaggi Principali

​Abilita Adaptive Currency

​Esperienza del Cliente

​Conversione e Commissioni

​Scegli chi sopporta la commissione

​Valute Supportate

​Rimborsi e Regolazioni

​Fatture e Tassazione

​Esempi di Integrazione

Checkout Session

Cos’è la Valuta Adattiva?

Vantaggi Principali

Abilita Adaptive Currency

Esperienza del Cliente

Conversione e Commissioni

Scegli chi sopporta la commissione

Valute Supportate

Rimborsi e Regolazioni

Fatture e Tassazione

Esempi di Integrazione