العملة التكيفية

يعرض Adaptive Currency أسعار المنتجات بالعملة المحلية للعميل بدلًا من عرضها بعملتك الأساسية فقط. عند تفعيله، تستخدم صفحة الدفع العملة المحلية المكتشفة افتراضيًا للبلدان المدعومة، مع إمكانية التبديل مرة أخرى إلى عملتك الأساسية.

آلية العمل

عملتك الأساسية هي العملة التي سعّرت بها المنتج أو الإضافة — ويمكن أن تكون أي عملة يستطيع Dodo Payments تحصيل المدفوعات بها، وليس USD فقط. يحوّل Adaptive Currency هذا السعر الأساسي وفق أسعار الصرف المباشرة. لتعيين سعر ثابت خاص بك لكل عملة أو بلد بدلًا من ذلك، راجع Localized Pricing.

المزايا الرئيسية

صفحة دفع محلية — تظهر الأسعار بالعملة المحلية للعميل افتراضيًا
المزيد من طرق الدفع — إتاحة طرق الدفع المتوفرة للعملة المحلية فقط
استرداد الأموال بالعملة نفسها — استرداد أموال العميل بالعملة التي دفع بها
تسعير متقدم — تفعيل Purchasing Power Parity وCharm Pricing لتحسين الأسعار تلقائيًا حسب السوق

تفعيل Adaptive Currency

Open Settings

سجّل الدخول إلى Merchant Dashboard وانتقل إلى Settings → Business.

Enable Adaptive Currency

فعّل Adaptive Currency. يمكنك تعطيله في أي وقت.

تُطبّق التغييرات على المعاملات المستقبلية فقط.

Save and Test

احفظ إعداداتك، ثم تحقّق من أن صفحة دفع تجريبية تعرض الأسعار بعملتك المحلية عند توفرها.

تجربة العميل

عند تفعيل Adaptive Currency:

الاكتشاف — يكتشف النظام بلد العميل استنادًا إلى عنوان الفوترة
اختيار العملة — إذا كان البلد مدعومًا، تظهر الأسعار بالعملة المحلية افتراضيًا. ويمكن للعملاء التبديل مرة أخرى إلى عملتك الأساسية
طرق الدفع — تظهر طرق الدفع المحلية عند الاقتضاء
الدفع — تكتمل عملية الدفع بالعملة المحددة

التحويل والرسوم

يفرض Adaptive Currency الرسوم على العميل بعملته المحلية باستخدام أسعار الصرف المباشرة. وتُحدَّد الرسوم وفق قيمة الطلب:

‏4% للطلبات الأقل من $500
‏3% للطلبات من $500 إلى $1,500
‏2% للطلبات التي تزيد عن $1,500

افتراضيًا، تُضاف هذه الرسوم إلى السعر المعروض ويتحملها العميل. باستخدام إعداد Fees Inclusive، يمكنك تحمّل الرسوم بنفسك: يرى العميل السعر نفسه بالعملة المحلية، وتُخصم الرسوم من تسويتك.

تفعيل Fees Inclusive

Open Settings

انتقل إلى Settings → Business وفعّل Adaptive Currency إذا لم تكن قد فعلت ذلك مسبقًا.

Enable Fees Inclusive

بعد تفعيل Adaptive Currency، فعّل مفتاح Fees Inclusive في القسم نفسه.

الوضع	ما يراه العميل	ما تتم تسويته للتاجر
Exclusive (افتراضي)	السعر المحلي + رسم بنسبة 2–4% يُضاف إليه	السعر الأساسي كاملًا
Inclusive	السعر المحلي (من دون تغيير)	السعر الأساسي مطروحًا منه رسم 2–4%

التجاوز لكل طلب

يمكنك تجاوز الإعداد الافتراضي للتاجر لكل طلب من خلال تمرير adaptive_currency_fees_inclusive (boolean) في دفعة لمرة واحدة، أو اشتراك عند الطلب (on_demand.adaptive_currency_fees_inclusive)، أو رسم اشتراك، أو تغيير خطة. في جلسات الدفع، يُقبل هذا الخيار للاشتراكات عند الطلب فقط، بصيغة subscription_data.on_demand.adaptive_currency_fees_inclusive، وليس في المستوى الأعلى من الطلب:

// 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 دائمًا على أنها شاملة، بغض النظر عن إعداد النشاط التجاري أو التجاوز لكل طلب.

عند تطابق قاعدة Localized Pricing، تُعامل المعاملة دائمًا على أنها شاملة، بغض النظر عن إعداد Fees Inclusive أو أي تجاوز لكل طلب. يدفع العميل المبلغ المحلي الذي حددته بالضبط، وتُخصم رسوم التحويل من تسويتك.

الحد الأدنى للمبالغ

يجب أن تستوفي كل دفعة الحد الأدنى للعملة التي يدفع بها العميل، وتكون الحدود الدنيا للاشتراكات أعلى من الدفعات لمرة واحدة. تنطبق الحدود الدنيا نفسها على كل طريقة دفع. يعتمد التحقق على الإجمالي، بما في ذلك الضريبة.

عملة الفوترة	الدفعات لمرة واحدة	الاشتراكات
USD	$0.50	$1.00
EUR وGBP	0.50 EUR، 0.30 GBP	0.50 EUR، 0.30 GBP
جميع العملات الأخرى	الحد الأدنى الوارد في العملات المدعومة، وبما لا يقل عن ما يعادل $0.50	الحد الأدنى الوارد في العملات المدعومة، وبما لا يقل عن ما يعادل $1.00

تُسوّى الدفعات بالعملات غير USD وEUR وGBP بالدولار الأمريكي. بالنسبة إلى هذه العملات، يتحقق checkout أولًا من السعر المحوّل إلى USD، قبل إضافة رسوم Adaptive Currency، ثم يتحقق من المبلغ بعملة العميل. يجب أن يجتاز المبلغ عمليتي التحقق، لذلك قد يكون الحد الأدنى الفعلي أعلى من الحد الأدنى المدرج للعملة. على سبيل المثال، الحد الأدنى المدرج لعملة AED هو 2.00 AED، لكن يجب أن تعادل قيمة الاشتراك بعملة AED ما لا يقل عن $1.00، أي ما يقارب 3.70 AED. يفشل اشتراك بقيمة 2.00 AED في اجتياز التحقق بالدولار الأمريكي. إذا كانت الدفعة أقل من الحد الأدنى، تُرجع API القيمة TOTAL_PAYMENT_AMOUNT_BELOW_MINIMUM_AMOUNT. وتذكر الرسالة الحد الأدنى الذي لم تستوفه الدفعة. بالنسبة إلى دفعة بعملة أخرى، قد يكون ذلك هو الحد الأدنى بالدولار الأمريكي، مثل Minimum amount of 1.00 USD is required to process payment.

العملات المدعومة

يسرد الجدول الحد الأدنى للمبلغ لكل عملة. ينطبق الحد الأدنى على الدفعات لمرة واحدة والاشتراكات. راجع الحد الأدنى للمبالغ للاطلاع على التحقق الإضافي بالدولار الأمريكي.

رمز العملة	اسم العملة	البلدان	الحد الأدنى للمبلغ
AED	الدرهم الإماراتي	الإمارات العربية المتحدة	2.00 AED
ALL	الليك الألباني	ألبانيا	50.00 ALL
AMD	الدرام الأرمني	أرمينيا	500.00 AMD
AUD	الدولار الأسترالي	أستراليا، ناورو	0.50 AUD
AWG	الفلورين الأروبي	أروبا	2.00 AWG
AZN	المانات الأذربيجاني	أذربيجان	2.00 AZN
BAM	المارك البوسني القابل للتحويل	البوسنة والهرسك	2.00 BAM
BDT	التاكا البنغلاديشي	بنغلاديش	100.00 BDT
BMD	الدولار البرمودي	برمودا	1.00 BMD
BND	الدولار البروناي	بروناي	1.00 BND
BOB	البوليفيانو البوليفي	بوليفيا	5.00 BOB
BRL	الريال البرازيلي	البرازيل	0.50 BRL
BSD	الدولار الباهامي	جزر البهاما	1.00 BSD
BWP	البولا البوتسواني	بوتسوانا	15.00 BWP
BZD	الدولار البليزي	بليز	2.00 BZD
CAD	الدولار الكندي	كندا	0.50 CAD
CHF	الفرنك السويسري	سويسرا، ليختنشتاين	0.50 CHF
CLP	البيزو التشيلي	تشيلي	500 CLP
CNY	اليوان الصيني	الصين	4.00 CNY
CRC	الكولون الكوستاريكي	كوستاريكا	500.00 CRC
CZK	الكرونة التشيكية	جمهورية التشيك	15.00 CZK
DKK	الكرونة الدنماركية	الدنمارك، غرينلاند	2.50 DKK
DOP	البيزو الدومينيكاني	جمهورية الدومينيكان	100.00 DOP
EGP	الجنيه المصري	مصر	50.00 EGP
ETB	البِر الإثيوبي	إثيوبيا	100.00 ETB
EUR	اليورو	النمسا، بلجيكا، قبرص، إستونيا، فنلندا، فرنسا، ألمانيا، اليونان، أيرلندا، إيطاليا، لاتفيا، ليتوانيا، لوكسمبورغ، مالطا، هولندا، البرتغال، سلوفاكيا، سلوفينيا، إسبانيا، أندورا، موناكو، كرواتيا، سان مارينو، الجبل الأسود	0.50 EUR
FJD	الدولار الفيجي	فيجي	2.00 FJD
GBP	الجنيه الإسترليني	المملكة المتحدة	0.30 GBP
GEL	اللاري الجورجي	جورجيا	3.00 GEL
GMD	الدالاسي الغامبي	غامبيا	100.00 GMD
GTQ	الكيتزال الغواتيمالي	غواتيمالا	10.00 GTQ
GYD	الدولار الغوياني	غيانا	200.00 GYD
HKD	دولار هونغ كونغ	هونغ كونغ	4.00 HKD
HNL	اللمبيرا الهندوراسي	هندوراس	25.00 HNL
HUF	الفورنت المجري	المجر	175.00 HUF
IDR	الروبية الإندونيسية	إندونيسيا	8500.00 IDR
ILS	الشيكل الإسرائيلي الجديد	إسرائيل	3.00 ILS
INR	الروبية الهندية	الهند	5.00 INR
JPY	الين الياباني	اليابان	50 JPY
KRW	الوون الكوري الجنوبي	كوريا الجنوبية	50 KRW
KZT	التنغي الكازاخستاني	كازاخستان	500.00 KZT
LKR	الروبية السريلانكية	سريلانكا	300.00 LKR
LRD	الدولار الليبيري	ليبيريا	200.00 LRD
LSL	اللوتي الليسوتي	ليسوتو	20.00 LSL
MAD	الدرهم المغربي	المغرب	10.00 MAD
MKD	الدينار المقدوني	مقدونيا الشمالية	50.00 MKD
MOP	الباتاكا الماكاوية	ماكاو	10.00 MOP
MUR	الروبية الموريشيوسية	موريشيوس	50.00 MUR
MVR	الروفيا المالديفية	جزر المالديف	15.00 MVR
MWK	الكواشا الملاوية	ملاوي	2000.00 MWK
MXN	البيزو المكسيكي	المكسيك	10.00 MXN
MYR	الرينغيت الماليزي	ماليزيا	4.00 MYR
NGN	النايرا النيجيرية	نيجيريا	2000.00 NGN
NOK	الكرونة النرويجية	النرويج	3.00 NOK
NPR	الروبية النيبالية	نيبال	150.00 NPR
NZD	الدولار النيوزيلندي	نيوزيلندا	1.00 NZD
PEN	السول البيروفي	بيرو	3.00 PEN
PGK	الكينا البابوية الجديدة	بابوا غينيا الجديدة	4.00 PGK
PHP	البيزو الفلبيني	الفلبين	50.00 PHP
PLN	الزلوتي البولندي	بولندا	2.00 PLN
PYG	الغواراني الباراغواياني	باراغواي	4000 PYG
QAR	الريال القطري	قطر	3.00 QAR
RON	الليو الروماني	رومانيا	2.00 RON
RSD	الدينار الصربي	صربيا	60.00 RSD
SAR	الريال السعودي	المملكة العربية السعودية	2.00 SAR
SBD	دولار جزر سليمان	جزر سليمان	10.00 SBD
SCR	الروبية السيشلية	سيشل	15.00 SCR
SEK	الكرونة السويدية	السويد	3.00 SEK
SGD	الدولار السنغافوري	سنغافورة	0.50 SGD
SZL	الليلانجيني السوازيلندي	إسواتيني	20.00 SZL
THB	البات التايلاندي	تايلاند	25.00 THB
TOP	بانغا تونغا	تونغا	2.00 TOP
TRY	الليرة التركية	تركيا	20.00 TRY
TWD	الدولار التايواني الجديد	تايوان	20.00 TWD
TZS	الشلن التنزاني	تنزانيا	3000.00 TZS
UYU	البيزو الأوروغواياني	أوروغواي	50.00 UYU
VND	الدونغ الفيتنامي	فيتنام	12000 VND
WST	التالا الساموي	ساموا	2.00 WST
XAF	فرنك CFA لوسط أفريقيا	الكاميرون، جمهورية أفريقيا الوسطى، تشاد، جمهورية الكونغو، غينيا الاستوائية، الغابون	300 XAF
XOF	فرنك CFA لغرب أفريقيا	بنين، بوركينا فاسو، ساحل العاج، غينيا بيساو، مالي، النيجر، السنغال، توغو	300 XOF
ZAR	الراند الجنوب أفريقي	جنوب أفريقيا	20.00 ZAR
ZMW	الكواشا الزامبية	زامبيا	30.00 ZMW

المبالغ المستردة والتعديلات

تُصدر Dodo Payments المبالغ المستردة بالعملة التي دفع بها العميل في الأصل، باستخدام أحدث سعر صرف. يظل المبلغ بعملتك الأساسية ثابتًا في لوحة التحكم والفواتير وعملية استرداد المبلغ. وقد يتلقى العميل مبلغًا أكبر أو أقل من المبلغ الأصلي بعملته المحلية، وذلك بحسب التغيرات في أسعار الصرف الأجنبي.

لا تُرد رسوم Adaptive Currency (رسوم FX).

مثال على استرداد مبلغ

تبيع منتجًا بقيمة 100 USD مع تفعيل Adaptive Currency
يرى عميل كندي مبلغ 137 CAD بسعر صرف يبلغ 1.37 CAD لكل 1 USD، ويُكمل عملية الشراء
تعالج Dodo Payments الدفعة، فتحوّل 137 CAD إلى 100 USD لتسويتها لك
يتغير سعر الصرف لاحقًا إلى 1.40 CAD لكل 1 USD، وتصدر استردادًا كاملًا للمبلغ
تخصم Dodo Payments مبلغ 100 USD وترد للعميل 140 CAD

الفواتير والضرائب

تعرض الفواتير المبلغ بعملة التسوية فقط
تُحتسب الضرائب ورسوم المنصة على المبلغ بعملة التسوية
مثال: يظل بيع بقيمة $10، بعد تحويله إلى 36 AED، ظاهرًا بقيمة $10 في لوحة التحكم والفواتير

تُقرّب جميع المبالغ وفقًا لمنطق التقريب الداخلي لدى Dodo Payments.

تعيين عملة الفوترة لكل عملية checkout

مرّر billing_currency لتعيين عملة الفوترة صراحةً لجلسة checkout:

عند تعطيل Adaptive Currency، يتم تجاهل 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

خفّض الأسعار حسب البلد تلقائيًا. يتطلب Adaptive Currency.

Charm Pricing

قرّب الأسعار المحوّلة إلى نهايات واضحة مثل 49.99. يتطلب Adaptive Currency.

Localized Pricing

عيّن سعرًا دقيقًا لكل بلد أو عملة بدلًا من التحويل التلقائي.

Tax-Inclusive Pricing

تحكّم في ما إذا كانت أسعارك تتضمن الضريبة.

Checkout Session

أنشئ جلسات checkout مع إعدادات عملة الفوترة.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

آلية العمل

المزايا الرئيسية

تفعيل Adaptive Currency

تجربة العميل

التحويل والرسوم

تفعيل Fees Inclusive

التجاوز لكل طلب

الحد الأدنى للمبالغ

العملات المدعومة

المبالغ المستردة والتعديلات

مثال على استرداد مبلغ

الفواتير والضرائب

تعيين عملة الفوترة لكل عملية checkout

صفحات ذات صلة

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

​آلية العمل

​المزايا الرئيسية

​تفعيل Adaptive Currency

​تجربة العميل

​التحويل والرسوم

​تفعيل Fees Inclusive

​التجاوز لكل طلب

​الحد الأدنى للمبالغ

​العملات المدعومة

​المبالغ المستردة والتعديلات

​مثال على استرداد مبلغ

​الفواتير والضرائب

​تعيين عملة الفوترة لكل عملية checkout

​صفحات ذات صلة

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

آلية العمل

المزايا الرئيسية

تفعيل Adaptive Currency

تجربة العميل

التحويل والرسوم

تفعيل Fees Inclusive

التجاوز لكل طلب

الحد الأدنى للمبالغ

العملات المدعومة

المبالغ المستردة والتعديلات

مثال على استرداد مبلغ

الفواتير والضرائب

تعيين عملة الفوترة لكل عملية checkout

صفحات ذات صلة