अनुकूलन मुद्रा

Adaptive Currency, product की कीमतें केवल आपकी base currency में दिखाने के बजाय ग्राहक की स्थानीय मुद्रा में दिखाता है। सक्षम होने पर, समर्थित देशों के लिए checkout डिफ़ॉल्ट रूप से detected local currency में खुलता है और ग्राहक के पास आपकी base currency पर वापस जाने का विकल्प होता है।

यह कैसे काम करता है

आपकी base currency वह मुद्रा होती है जिसमें आपने product या add-on की कीमत तय की है — यह कोई भी ऐसी मुद्रा हो सकती है जिसे Dodo Payments charge कर सकता है, केवल USD नहीं। Adaptive Currency उस base price को live exchange rates पर convert करता है। यदि आप इसके बजाय हर currency या country के लिए अपनी fixed price तय करना चाहते हैं, तो Localized Pricing देखें।

मुख्य लाभ

Localized checkout — कीमतें डिफ़ॉल्ट रूप से ग्राहक की स्थानीय मुद्रा में दिखाई देती हैं
अधिक payment methods — केवल स्थानीय मुद्रा के लिए उपलब्ध payment methods अनलॉक होते हैं
Same-currency refunds — ग्राहक को उसी मुद्रा में refund करें जिसमें उसने भुगतान किया था
Advanced pricing — हर market के लिए automatic price optimization हेतु Purchasing Power Parity और Charm Pricing सक्षम करता है

Adaptive Currency सक्षम करें

Open Settings

अपने Merchant Dashboard में लॉग इन करें और Settings → Business पर जाएं।

Enable Adaptive Currency

Adaptive Currency को on करें। आप इसे किसी भी समय disable कर सकते हैं।

बदलाव केवल future transactions पर लागू होते हैं।

Save and Test

अपनी settings save करें, फिर verify करें कि supported होने पर test checkout में कीमतें आपकी स्थानीय मुद्रा में दिखाई दे रही हैं।

ग्राहक अनुभव

Adaptive Currency सक्षम होने पर:

Detection — सिस्टम billing address के आधार पर ग्राहक के country का पता लगाता है
Currency selection — यदि country supported है, तो कीमतें डिफ़ॉल्ट रूप से स्थानीय मुद्रा में दिखाई देती हैं। ग्राहक आपकी base currency पर वापस जा सकता है
Payment methods — जहां लागू हो, localized payment methods दिखाई देते हैं
Checkout — payment चुनी गई मुद्रा में पूरा होता है

Conversion और Fees

Adaptive Currency live exchange rates का उपयोग करके ग्राहक से उसकी स्थानीय मुद्रा में charge करता है। Fees order value के अनुसार tiered होती हैं:

$500 से कम के orders पर 4%
$500 से $1,500 तक के orders पर 3%
$1,500 से अधिक के orders पर 2%

डिफ़ॉल्ट रूप से, ये fees आपकी displayed price के ऊपर जोड़ी जाती हैं और ग्राहक द्वारा वहन की जाती हैं। Fees Inclusive setting के साथ, आप fee स्वयं वहन कर सकते हैं: ग्राहक को वही local-currency price दिखाई देती है और fee आपके settlement से काट ली जाती है।

Fees Inclusive सक्षम करें

Open Settings

Settings → Business पर जाएं और यदि Adaptive Currency पहले से सक्षम नहीं है, तो इसे enable करें।

Enable Fees Inclusive

Adaptive Currency on होने के बाद, उसी section में Fees Inclusive toggle enable करें।

Mode	Customer Sees	Merchant Settles
Exclusive (default)	Local price + ऊपर से 2–4% fee	Full base price
Inclusive	Local price (unchanged)	Base price में से 2–4% fee घटाकर

Per Request Override करें

आप one-time payment, on-demand subscription (on_demand.adaptive_currency_fees_inclusive), subscription charge या plan change पर adaptive_currency_fees_inclusive (boolean) pass करके per request merchant default को override कर सकते हैं। Checkout sessions पर इसे केवल on-demand subscriptions के लिए subscription_data.on_demand.adaptive_currency_fees_inclusive के रूप में स्वीकार किया जाता है, request के top level पर नहीं:

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

INR → INR transactions को business setting या per-request override की परवाह किए बिना हमेशा inclusive माना जाता है।

जब कोई Localized Pricing rule match करता है, तो transaction को आपके Fees Inclusive setting या किसी भी per-request override की परवाह किए बिना हमेशा inclusive माना जाता है। ग्राहक आपके द्वारा set की गई exact localized amount का भुगतान करता है और conversion fee आपके settlement से काट ली जाती है।

न्यूनतम राशियाँ

हर भुगतान को उस मुद्रा की न्यूनतम राशि पूरी करनी होगी जिसमें ग्राहक भुगतान करता है, और subscriptions की न्यूनतम राशि one-time payments से अधिक होती है। यही न्यूनतम राशियाँ हर payment method पर लागू होती हैं। जाँच tax सहित कुल राशि पर की जाती है।

Billing Currency	One-Time Payments	Subscriptions
USD	$0.50	$1.00
EUR and GBP	0.50 EUR, 0.30 GBP	0.50 EUR, 0.30 GBP
Every other currency	Supported Currencies में दी गई न्यूनतम राशि, और कम से कम $0.50 के बराबर	Supported Currencies में दी गई न्यूनतम राशि, और कम से कम $1.00 के बराबर

USD, EUR और GBP के अलावा अन्य मुद्राओं में किए गए भुगतान USD में settle होते हैं। इन मुद्राओं के लिए checkout पहले Adaptive Currency fee जुड़ने से पहले USD में converted price की जाँच करता है, और फिर ग्राहक की मुद्रा में राशि की जाँच करता है। राशि को दोनों जाँचों में सफल होना आवश्यक है, इसलिए प्रभावी न्यूनतम राशि उस मुद्रा के लिए सूचीबद्ध न्यूनतम राशि से अधिक हो सकती है। उदाहरण के लिए, AED की सूचीबद्ध न्यूनतम राशि 2.00 AED है, लेकिन AED में subscription का मूल्य कम से कम $1.00 होना चाहिए, जो लगभग 3.70 AED है। 2.00 AED का subscription USD जाँच में विफल हो जाता है। यदि कोई भुगतान न्यूनतम राशि से कम है, तो API TOTAL_PAYMENT_AMOUNT_BELOW_MINIMUM_AMOUNT लौटाता है। संदेश विफल हुई न्यूनतम राशि का नाम बताता है। किसी अन्य मुद्रा में किए गए भुगतान के लिए यह USD की न्यूनतम राशि हो सकती है, जैसे Minimum amount of 1.00 USD is required to process payment।

Supported Currencies

तालिका में प्रत्येक मुद्रा की न्यूनतम राशि दी गई है। न्यूनतम राशि one-time payments और subscriptions दोनों पर लागू होती है। अतिरिक्त USD जाँच के लिए Minimum Amounts देखें।

Currency Code	Currency Name	Countries	Minimum Amount
AED	UAE Dirham	United Arab Emirates	2.00 AED
ALL	Albanian Lek	Albania	50.00 ALL
AMD	Armenian Dram	Armenia	500.00 AMD
AUD	Australian Dollar	Australia, Nauru	0.50 AUD
AWG	Aruban Florin	Aruba	2.00 AWG
AZN	Azerbaijani Manat	Azerbaijan	2.00 AZN
BAM	Bosnia-Herzegovina Convertible Mark	Bosnia and Herzegovina	2.00 BAM
BDT	Bangladeshi Taka	Bangladesh	100.00 BDT
BMD	Bermudian Dollar	Bermuda	1.00 BMD
BND	Brunei Dollar	Brunei	1.00 BND
BOB	Bolivian Boliviano	Bolivia	5.00 BOB
BRL	Brazilian Real	Brazil	0.50 BRL
BSD	Bahamian Dollar	Bahamas	1.00 BSD
BWP	Botswanan Pula	Botswana	15.00 BWP
BZD	Belize Dollar	Belize	2.00 BZD
CAD	Canadian Dollar	Canada	0.50 CAD
CHF	Swiss Franc	Switzerland, Liechtenstein	0.50 CHF
CLP	Chilean Peso	Chile	500 CLP
CNY	Chinese Yuan	China	4.00 CNY
CRC	Costa Rican Colón	Costa Rica	500.00 CRC
CZK	Czech Koruna	Czech Republic	15.00 CZK
DKK	Danish Krone	Denmark, Greenland	2.50 DKK
DOP	Dominican Peso	Dominican Republic	100.00 DOP
EGP	Egyptian Pound	Egypt	50.00 EGP
ETB	Ethiopian Birr	Ethiopia	100.00 ETB
EUR	Euro	Austria, Belgium, Cyprus, Estonia, Finland, France, Germany, Greece, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Portugal, Slovakia, Slovenia, Spain, Andorra, Monaco, Croatia, San Marino, Montenegro	0.50 EUR
FJD	Fijian Dollar	Fiji	2.00 FJD
GBP	British Pound	United Kingdom	0.30 GBP
GEL	Georgian Lari	Georgia	3.00 GEL
GMD	Gambian Dalasi	Gambia	100.00 GMD
GTQ	Guatemalan Quetzal	Guatemala	10.00 GTQ
GYD	Guyanese Dollar	Guyana	200.00 GYD
HKD	Hong Kong Dollar	Hong Kong	4.00 HKD
HNL	Honduran Lempira	Honduras	25.00 HNL
HUF	Hungarian Forint	Hungary	175.00 HUF
IDR	Indonesian Rupiah	Indonesia	8500.00 IDR
ILS	Israeli New Shekel	Israel	3.00 ILS
INR	Indian Rupee	India	5.00 INR
JPY	Japanese Yen	Japan	50 JPY
KRW	South Korean Won	South Korea	50 KRW
KZT	Kazakhstani Tenge	Kazakhstan	500.00 KZT
LKR	Sri Lankan Rupee	Sri Lanka	300.00 LKR
LRD	Liberian Dollar	Liberia	200.00 LRD
LSL	Lesotho Loti	Lesotho	20.00 LSL
MAD	Moroccan Dirham	Morocco	10.00 MAD
MKD	Macedonian Denar	North Macedonia	50.00 MKD
MOP	Macanese Pataca	Macau	10.00 MOP
MUR	Mauritian Rupee	Mauritius	50.00 MUR
MVR	Maldivian Rufiyaa	Maldives	15.00 MVR
MWK	Malawian Kwacha	Malawi	2000.00 MWK
MXN	Mexican Peso	Mexico	10.00 MXN
MYR	Malaysian Ringgit	Malaysia	4.00 MYR
NGN	Nigerian Naira	Nigeria	2000.00 NGN
NOK	Norwegian Krone	Norway	3.00 NOK
NPR	Nepalese Rupee	Nepal	150.00 NPR
NZD	New Zealand Dollar	New Zealand	1.00 NZD
PEN	Peruvian Sol	Peru	3.00 PEN
PGK	Papua New Guinean Kina	Papua New Guinea	4.00 PGK
PHP	Philippine Peso	Philippines	50.00 PHP
PLN	Polish Zloty	Poland	2.00 PLN
PYG	Paraguayan Guaraní	Paraguay	4000 PYG
QAR	Qatari Rial	Qatar	3.00 QAR
RON	Romanian Leu	Romania	2.00 RON
RSD	Serbian Dinar	Serbia	60.00 RSD
SAR	Saudi Riyal	Saudi Arabia	2.00 SAR
SBD	Solomon Islands Dollar	Solomon Islands	10.00 SBD
SCR	Seychellois Rupee	Seychelles	15.00 SCR
SEK	Swedish Krona	Sweden	3.00 SEK
SGD	Singapore Dollar	Singapore	0.50 SGD
SZL	Swazi Lilangeni	Eswatini	20.00 SZL
THB	Thai Baht	Thailand	25.00 THB
TOP	Tongan Paʻanga	Tonga	2.00 TOP
TRY	Turkish Lira	Turkey	20.00 TRY
TWD	New Taiwan Dollar	Taiwan	20.00 TWD
TZS	Tanzanian Shilling	Tanzania	3000.00 TZS
UYU	Uruguayan Peso	Uruguay	50.00 UYU
VND	Vietnamese Dong	Vietnam	12000 VND
WST	Samoan Tala	Samoa	2.00 WST
XAF	Central African CFA Franc	Cameroon, Central African Republic, Chad, Republic of the Congo, Equatorial Guinea, Gabon	300 XAF
XOF	West African CFA Franc	Benin, Burkina Faso, Côte d’Ivoire, Guinea-Bissau, Mali, Niger, Senegal, Togo	300 XOF
ZAR	South African Rand	South Africa	20.00 ZAR
ZMW	Zambian Kwacha	Zambia	30.00 ZMW

Refunds और Adjustments

Dodo Payments ग्राहक द्वारा मूल रूप से भुगतान की गई मुद्रा में, नवीनतम exchange rate का उपयोग करके refunds जारी करता है। आपकी base currency में राशि आपके dashboard, invoices और refund में स्थिर रहती है। FX में बदलाव के आधार पर ग्राहक को मूल local-currency राशि से अधिक या कम राशि प्राप्त हो सकती है।

Adaptive Currency fees (FX fees) का refund नहीं किया जाता।

Refund का उदाहरण

आप Adaptive Currency enabled होने पर कोई product 100 USD में बेचते हैं
एक Canadian customer को 1 USD के लिए 1.37 CAD के exchange rate पर 137 CAD दिखाई देता है और वह purchase पूरा करता है
Dodo Payments payment को process करता है और आपके settlement के लिए 137 CAD को 100 USD में convert करता है
बाद में exchange rate बदलकर 1 USD के लिए 1.40 CAD हो जाता है और आप full refund जारी करते हैं
Dodo Payments 100 USD काटता है और customer को 140 CAD refund करता है

Invoices और Taxation

Invoices में केवल settlement currency की राशि दिखाई जाती है
Taxes और platform fees की गणना settlement currency की राशि पर की जाती है
उदाहरण: 36 AED में converted $10 की sale Dashboard और invoices में अब भी $10 के रूप में दिखाई जाती है

सभी राशियों को Dodo Payments की internal rounding logic के अनुसार round किया जाता है।

प्रत्येक Checkout के लिए Billing Currency सेट करें

checkout session के लिए billing currency को स्पष्ट रूप से सेट करने हेतु billing_currency पास करें:

जब Adaptive Currency disabled होता है, तो billing_currency को अनदेखा किया जाता है।

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

Purchasing Power Parity

देश के अनुसार prices को automatically कम करें। Adaptive Currency आवश्यक है।

Charm Pricing

converted prices को 49.99 जैसे साफ़ endings में round करें। Adaptive Currency आवश्यक है।

Localized Pricing

automatic conversion के बजाय प्रत्येक देश या currency के लिए exact price सेट करें।

Tax-Inclusive Pricing

नियंत्रित करें कि आपकी prices में tax शामिल है या नहीं।

Checkout Session

billing currency configuration के साथ checkout sessions बनाएँ।

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

यह कैसे काम करता है

मुख्य लाभ

Adaptive Currency सक्षम करें

ग्राहक अनुभव

Conversion और Fees

Fees Inclusive सक्षम करें

Per Request Override करें

न्यूनतम राशियाँ

Supported Currencies

Refunds और Adjustments

Refund का उदाहरण

Invoices और Taxation

प्रत्येक Checkout के लिए Billing Currency सेट करें

संबंधित पेज

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

​यह कैसे काम करता है

​मुख्य लाभ

​Adaptive Currency सक्षम करें

​ग्राहक अनुभव

​Conversion और Fees

​Fees Inclusive सक्षम करें

​Per Request Override करें

​न्यूनतम राशियाँ

​Supported Currencies

​Refunds और Adjustments

​Refund का उदाहरण

​Invoices और Taxation

​प्रत्येक Checkout के लिए Billing Currency सेट करें

​संबंधित पेज

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

यह कैसे काम करता है

मुख्य लाभ

Adaptive Currency सक्षम करें

ग्राहक अनुभव

Conversion और Fees

Fees Inclusive सक्षम करें

Per Request Override करें

न्यूनतम राशियाँ

Supported Currencies

Refunds और Adjustments

Refund का उदाहरण

Invoices और Taxation

प्रत्येक Checkout के लिए Billing Currency सेट करें

संबंधित पेज