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

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 से काट ली जाती है।

Supported Currencies

Currency Code	Currency Name	Countries	Minimum Amount
AED	UAE Dirham	संयुक्त अरब अमीरात	2.00 AED
ALL	Albanian Lek	अल्बानिया	50.00 ALL
AMD	Armenian Dram	आर्मेनिया	500.00 AMD
AUD	Australian Dollar	ऑस्ट्रेलिया, नाउरू	0.50 AUD
AWG	Aruban Florin	अरूबा	2.00 AWG
AZN	Azerbaijani Manat	अज़रबैजान	2.00 AZN
BAM	Bosnia-Herzegovina Convertible Mark	बोस्निया और हर्ज़ेगोविना	2.00 BAM
BDT	Bangladeshi Taka	बांग्लादेश	100.00 BDT
BMD	Bermudian Dollar	बरमूडा	1.00 BMD
BND	Brunei Dollar	ब्रुनेई	1.00 BND
BOB	Bolivian Boliviano	बोलिविया	5.00 BOB
BRL	Brazilian Real	ब्राज़ील	0.50 BRL
BSD	Bahamian Dollar	बहामास	1.00 BSD
BWP	Botswanan Pula	बोत्सवाना	15.00 BWP
BZD	Belize Dollar	बेलीज़	2.00 BZD
CAD	Canadian Dollar	कनाडा	0.50 CAD
CHF	Swiss Franc	स्विट्ज़रलैंड, लिकटेंस्टाइन	0.50 CHF
CLP	Chilean Peso	चिली	1000.00 CLP
CNY	Chinese Yuan	चीन	4.00 CNY
CRC	Costa Rican Colón	कोस्टा रिका	500.00 CRC
CZK	Czech Koruna	चेक गणराज्य	15.00 CZK
DKK	Danish Krone	डेनमार्क, ग्रीनलैंड	2.50 DKK
DOP	Dominican Peso	डोमिनिकन गणराज्य	100.00 DOP
EGP	Egyptian Pound	मिस्र	50.00 EGP
ETB	Ethiopian Birr	इथियोपिया	100.00 ETB
EUR	Euro	ऑस्ट्रिया, बेल्जियम, साइप्रस, एस्टोनिया, फ़िनलैंड, फ़्रांस, जर्मनी, ग्रीस, आयरलैंड, इटली, लातविया, लिथुआनिया, लक्ज़मबर्ग, माल्टा, नीदरलैंड, पुर्तगाल, स्लोवाकिया, स्लोवेनिया, स्पेन, अंडोरा, मोनाको, क्रोएशिया, सैन मरीनो, मोंटेनेग्रो	0.50 EUR
FJD	Fijian Dollar	फ़िजी	2.00 FJD
GBP	British Pound	यूनाइटेड किंगडम	0.30 GBP
GEL	Georgian Lari	जॉर्जिया	3.00 GEL
GMD	Gambian Dalasi	गाम्बिया	100.00 GMD
GTQ	Guatemalan Quetzal	ग्वाटेमाला	10.00 GTQ
GYD	Guyanese Dollar	गुयाना	200.00 GYD
HKD	Hong Kong Dollar	हांगकांग	4.00 HKD
HNL	Honduran Lempira	होंडुरास	25.00 HNL
HUF	Hungarian Forint	हंगरी	175.00 HUF
IDR	Indonesian Rupiah	इंडोनेशिया	8500.00 IDR
ILS	Israeli New Shekel	इज़राइल	3.00 ILS
INR	Indian Rupee	भारत	5.00 INR
JPY	Japanese Yen	जापान	50 JPY
KRW	South Korean Won	दक्षिण कोरिया	50 KRW
KZT	Kazakhstani Tenge	कज़ाख़स्तान	500.00 KZT
LKR	Sri Lankan Rupee	श्रीलंका	300.00 LKR
LRD	Liberian Dollar	लाइबेरिया	200.00 LRD
LSL	Lesotho Loti	लेसोथो	20.00 LSL
MAD	Moroccan Dirham	मोरक्को	10.00 MAD
MKD	Macedonian Denar	उत्तर मैसेडोनिया	50.00 MKD
MOP	Macanese Pataca	मकाऊ	10.00 MOP
MUR	Mauritian Rupee	मॉरीशस	50.00 MUR
MVR	Maldivian Rufiyaa	मालदीव	15.00 MVR
MWK	Malawian Kwacha	मलावी	2000.00 MWK
MXN	Mexican Peso	मेक्सिको	10.00 MXN
MYR	Malaysian Ringgit	मलेशिया	4.00 MYR
NGN	Nigerian Naira	नाइजीरिया	2000.00 NGN
NOK	Norwegian Krone	नॉर्वे	3.00 NOK
NPR	Nepalese Rupee	नेपाल	150.00 NPR
NZD	New Zealand Dollar	न्यूज़ीलैंड	1.00 NZD
PEN	Peruvian Sol	पेरू	3.00 PEN
PGK	Papua New Guinean Kina	पापुआ न्यू गिनी	4.00 PGK
PHP	Philippine Peso	फ़िलीपींस	50.00 PHP
PLN	Polish Zloty	पोलैंड	2.00 PLN
PYG	Paraguayan Guaraní	पराग्वे	4000 PYG
QAR	Qatari Rial	क़तर	3.00 QAR
RON	Romanian Leu	रोमानिया	2.00 RON
RSD	Serbian Dinar	सर्बिया	60.00 RSD
SAR	Saudi Riyal	सऊदी अरब	2.00 SAR
SBD	Solomon Islands Dollar	सोलोमन द्वीपसमूह	10.00 SBD
SCR	Seychellois Rupee	सेशेल्स	15.00 SCR
SEK	Swedish Krona	स्वीडन	3.00 SEK
SGD	Singapore Dollar	सिंगापुर	0.50 SGD
SZL	Swazi Lilangeni	एस्वातिनी	20.00 SZL
THB	Thai Baht	थाईलैंड	25.00 THB
TOP	Tongan Paʻanga	टोंगा	2.00 TOP
TRY	Turkish Lira	तुर्की	20.00 TRY
TWD	New Taiwan Dollar	ताइवान	20.00 TWD
TZS	Tanzanian Shilling	तंज़ानिया	3000.00 TZS
UYU	Uruguayan Peso	उरुग्वे	50.00 UYU
VND	Vietnamese Dong	वियतनाम	12000 VND
WST	Samoan Tala	समोआ	2.00 WST
XAF	Central African CFA Franc	कैमरून, मध्य अफ़्रीकी गणराज्य, चाड, कांगो गणराज्य, इक्वेटोरियल गिनी, गैबॉन	300 XAF
XOF	West African CFA Franc	बेनिन, बुर्किना फ़ासो, Côte d’Ivoire, गिनी-बिसाऊ, माली, नाइजर, सेनेगल, टोगो	300 XOF
ZAR	South African Rand	दक्षिण अफ़्रीका	20.00 ZAR
ZMW	Zambian Kwacha	ज़ाम्बिया	30.00 ZMW

Refunds और Adjustments

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

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

Refund का उदाहरण

आप Adaptive Currency सक्षम करके कोई 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 काटकर ग्राहक को 140 CAD refund करता है

Invoices और Taxation

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

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

हर Checkout के लिए Billing Currency सेट करें

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

जब Adaptive Currency disabled हो, तो billing_currency को ignore किया जाता है।

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

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

Charm Pricing

Converted prices को 49.99 जैसे clean endings पर round करें। Adaptive Currency आवश्यक है।

Localized Pricing

Automatic conversion के बजाय हर country या currency के लिए exact price set करें।

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 सेट करें

संबंधित Pages

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 सेट करें

​संबंधित Pages

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 सेट करें

संबंधित Pages