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

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

​

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

​

الفوائد الرئيسية

• تجربة دفع محلية: تظهر الأسعار بعملة محلية بشكل افتراضي.
• المزيد من طرق الدفع: يفتح طرق الدفع المتاحة للعملة المحلية.
• استرداد الأموال بنفس العملة: استرداد العميل بالعملة التي دفع بها.

​

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

​

تجربة العميل

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

​

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

• ما تدفعه: 0% (الافتراضي) أو 2-4% (عند تمكين شمول الرسوم)
• ما يدفعه عملاؤك: 2-4% بناءً على قيمة الطلب (الافتراضي) أو 0% (عند تمكين شمول الرسوم)

• 4% للطلبات التي تقل عن 500 دولار
• 3% من 500 إلى 1,500 دولار
• 2% لأكثر من 1,500 دولار

​

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

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
  adaptive_currency_fees_inclusive: true, // override the business setting for this session
  return_url: 'https://yoursite.com/return'
});

​

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

​

الاستردادات والتعديلات

1. تبيع منتجًا مقابل 100 دولار مع تمكين العملة التكيفية.
2. يرى عميل كندي 137 دولار كندي بسعر صرف 1.37 دولار كندي لكل 1 دولار أمريكي ويكمل الشراء.
3. نعالج الدفع، محولين 137 دولار كندي إلى 100 دولار للتسوية الخاصة بك.
4. لاحقًا، يتغير سعر الصرف إلى 1.40 دولار كندي لكل 1 دولار أمريكي وتصدر استردادًا كاملاً.
5. نخصم 100 دولار ونرد للعميل 140 دولار كندي.

​

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

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

​

أمثلة على التكامل

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