Valuta Adattiva

Adaptive Currency mostra i prezzi dei prodotti nella valuta locale del cliente invece che solo nella valuta di base. Quando è abilitata, il checkout utilizza per impostazione predefinita la valuta locale rilevata per i Paesi supportati, con la possibilità di tornare alla valuta di base.

Come funziona

La valuta di base è quella in cui hai definito il prezzo del prodotto o dell’add-on: può essere qualsiasi valuta addebitabile da Dodo Payments, non solo USD. Adaptive Currency converte il prezzo di base utilizzando i tassi di cambio correnti. Per impostare invece un prezzo fisso personalizzato per valuta o Paese, consulta Localized Pricing.

Vantaggi principali

Checkout localizzato — I prezzi vengono mostrati per impostazione predefinita nella valuta locale del cliente
Più metodi di pagamento — Sblocca i metodi di pagamento disponibili solo per la valuta locale
Rimborsi nella stessa valuta — Rimborsa il cliente nella valuta utilizzata per il pagamento
Prezzi avanzati — Abilita Purchasing Power Parity e Charm Pricing per ottimizzare automaticamente i prezzi in base al mercato

Abilitare Adaptive Currency

Open Settings

Accedi al Merchant Dashboard e vai su Settings → Business.

Enable Adaptive Currency

Attiva Adaptive Currency. Puoi disabilitarla in qualsiasi momento.

Le modifiche si applicano solo alle transazioni future.

Save and Test

Salva le impostazioni, quindi verifica che un checkout di prova mostri i prezzi nella valuta locale, quando supportata.

Interruttore Adaptive Currency nelle impostazioni

Esperienza del cliente

Quando Adaptive Currency è abilitata:

Rilevamento — Il sistema rileva il Paese del cliente in base al suo 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 valuta di base
Metodi di pagamento — I metodi di pagamento localizzati vengono mostrati quando applicabile
Checkout — Il pagamento viene completato nella valuta selezionata

Conversione e commissioni

Adaptive Currency addebita al cliente l’importo nella valuta locale utilizzando i tassi di cambio correnti. Le commissioni variano in base al valore dell’ordine:

4% per ordini inferiori a $500
3% per ordini da $500 a $1.500
2% per ordini superiori a $1.500

Per impostazione predefinita, queste commissioni vengono aggiunte al prezzo visualizzato e sono a carico del cliente. Con l’impostazione Fees Inclusive, puoi assorbire personalmente la commissione: il cliente vede lo stesso prezzo nella valuta locale e la commissione viene detratta dal tuo settlement.

Abilitare Fees Inclusive

Open Settings

Vai su Settings → Business e abilita Adaptive Currency, se non l’hai già fatto.

Enable Fees Inclusive

Dopo aver abilitato Adaptive Currency, attiva l’interruttore Fees Inclusive nella stessa sezione.

Modalità	Cosa vede il cliente	Settlement del merchant
Exclusive (predefinita)	Prezzo locale + commissione del 2–4% aggiunta	Prezzo di base completo
Inclusive	Prezzo locale (invariato)	Prezzo di base meno la commissione del 2–4%

Override per richiesta

Puoi sostituire il valore predefinito del merchant per ogni richiesta passando adaptive_currency_fees_inclusive (boolean) per un pagamento una tantum, un abbonamento on-demand (on_demand.adaptive_currency_fees_inclusive), un addebito di un abbonamento o una modifica del piano. Nelle checkout sessions, è accettato solo per gli abbonamenti on-demand, come subscription_data.on_demand.adaptive_currency_fees_inclusive, e non al livello superiore della richiesta:

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

Le transazioni da INR a INR vengono sempre trattate come inclusive, indipendentemente dall’impostazione aziendale o dall’override per richiesta.

Quando una regola di Localized Pricing corrisponde, la transazione viene sempre trattata come inclusive, indipendentemente dall’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 settlement.

Importi minimi

Ogni pagamento deve rispettare l’importo minimo della valuta in cui paga il cliente; gli abbonamenti hanno importi minimi più elevati rispetto ai pagamenti una tantum. Gli stessi importi minimi si applicano a ogni metodo di pagamento. Il controllo utilizza il totale, incluse le imposte.

Valuta di addebito	Pagamenti una tantum	Abbonamenti
USD	$0.50	$1.00
EUR e GBP	0.50 EUR, 0.30 GBP	0.50 EUR, 0.30 GBP
Tutte le altre valute	L’importo minimo in Valute supportate e almeno l’equivalente di $0.50	L’importo minimo in Valute supportate e almeno l’equivalente di $1.00

I pagamenti in valute diverse da USD, EUR e GBP vengono regolati in USD. Per queste valute, il checkout controlla prima il prezzo convertito in USD, prima dell’aggiunta della commissione Adaptive Currency, quindi controlla l’importo nella valuta del cliente. L’importo deve superare entrambi i controlli, perciò l’importo minimo effettivo può essere superiore all’importo minimo indicato per la valuta. Ad esempio, l’importo minimo indicato per AED è 2.00 AED, ma un abbonamento in AED deve valere almeno $1.00, ovvero circa 3.70 AED. Un abbonamento di 2.00 AED non supera il controllo in USD. Se un pagamento è inferiore all’importo minimo, l’API restituisce TOTAL_PAYMENT_AMOUNT_BELOW_MINIMUM_AMOUNT. Il messaggio indica l’importo minimo che non è stato rispettato. Per un pagamento in un’altra valuta, può trattarsi dell’importo minimo in USD, ad esempio Minimum amount of 1.00 USD is required to process payment.

Valute supportate

La tabella elenca l’importo minimo per ogni valuta. L’importo minimo si applica ai pagamenti una tantum e agli abbonamenti. Consulta Importi minimi per il controllo aggiuntivo in USD.

Codice valuta	Nome della 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 di Bosnia-Erzegovina	Bosnia ed Erzegovina	2.00 BAM
BDT	Taka bengalese	Bangladesh	100.00 BDT
BMD	Dollaro bermudiano	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 botswaniano	Botswana	15.00 BWP
BZD	Dollaro del Belize	Belize	2.00 BZD
CAD	Dollaro canadese	Canada	0.50 CAD
CHF	Franco svizzero	Svizzera, Liechtenstein	0.50 CHF
CLP	Peso cileno	Cile	500 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 delle Figi	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 singalese	Sri Lanka	300.00 LKR
LRD	Dollaro liberiano	Liberia	200.00 LRD
LSL	Loti lesothiano	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	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	Riyal qatariota	Qatar	3.00 QAR
RON	Leu rumeno	Romania	2.00 RON
RSD	Dinar 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 thailandese	Thailandia	25.00 THB
TOP	Paʻanga tongano	Tonga	2.00 TOP
TRY	Lira turca	Turchia	20.00 TRY
TWD	Nuovo dollaro taiwanese	Taiwan	20.00 TWD
TZS	Scellino tanzaniano	Tanzania	3000.00 TZS
UYU	Peso uruguaiano	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	Sudafrica	20.00 ZAR
ZMW	Kwacha zambiano	Zambia	30.00 ZMW

Rimborsi e rettifiche

Dodo Payments emette i rimborsi nella valuta utilizzata originariamente dal cliente, applicando il tasso di cambio più recente. L’importo nella valuta di base rimane fisso nella Dashboard, nelle fatture e nel rimborso. A seconda delle variazioni del tasso di cambio, il cliente potrebbe ricevere un importo maggiore o minore rispetto all’importo originale nella valuta locale.

Le commissioni Adaptive Currency (commissioni FX) non vengono rimborsate.

Esempio di rimborso

Vendi un prodotto per 100 USD con Adaptive Currency abilitato
Un cliente canadese visualizza 137 CAD a un tasso di cambio di 1.37 CAD per 1 USD e completa l’acquisto
Dodo Payments elabora il pagamento, convertendo 137 CAD in 100 USD per il tuo regolamento
In seguito, il tasso di cambio cambia a 1.40 CAD per 1 USD e emetti un rimborso completo
Dodo Payments detrae 100 USD e rimborsa al cliente 140 CAD

Fatture e tassazione

Le fatture mostrano solo l’importo nella valuta di regolamento
Le imposte e le commissioni della piattaforma vengono calcolate sull’importo nella valuta di regolamento
Esempio: una vendita di $10 convertita in 36 AED continua a essere visualizzata come $10 nella Dashboard e nelle fatture

Tutti gli importi vengono arrotondati secondo la logica di arrotondamento interna di Dodo Payments.

Impostare la valuta di addebito per ogni checkout

Passa billing_currency per impostare esplicitamente la valuta di addebito di una sessione di checkout:

Quando Adaptive Currency è disabilitato, billing_currency viene ignorato.

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

Pagine correlate

Purchasing Power Parity

Riduci automaticamente i prezzi in base al Paese. Richiede Adaptive Currency.

Charm Pricing

Arrotonda i prezzi convertiti a valori finali più semplici, come 49.99. Richiede Adaptive Currency.

Localized Pricing

Imposta un prezzo esatto per Paese o valuta invece di utilizzare la conversione automatica.

Tax-Inclusive Pricing

Controlla se i prezzi includono le imposte.

Checkout Session

Crea sessioni di checkout con la configurazione della valuta di addebito.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Come funziona

Vantaggi principali

Abilitare Adaptive Currency

Esperienza del cliente

Conversione e commissioni

Abilitare Fees Inclusive

Override per richiesta

Importi minimi

Valute supportate

Rimborsi e rettifiche

Esempio di rimborso

Fatture e tassazione

Impostare la valuta di addebito per ogni checkout

Pagine correlate

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

​Come funziona

​Vantaggi principali

​Abilitare Adaptive Currency

​Esperienza del cliente

​Conversione e commissioni

​Abilitare Fees Inclusive

​Override per richiesta

​Importi minimi

​Valute supportate

​Rimborsi e rettifiche

​Esempio di rimborso

​Fatture e tassazione

​Impostare la valuta di addebito per ogni checkout

​Pagine correlate

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

Come funziona

Vantaggi principali

Abilitare Adaptive Currency

Esperienza del cliente

Conversione e commissioni

Abilitare Fees Inclusive

Override per richiesta

Importi minimi

Valute supportate

Rimborsi e rettifiche

Esempio di rimborso

Fatture e tassazione

Impostare la valuta di addebito per ogni checkout

Pagine correlate