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

​

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

​

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

• تجربة دفع محلية: تظهر الأسعار بالعملة المحلية افتراضيًا.
• طرق دفع أكثر: يفتح طرق الدفع المتاحة للعملة المحلية.
• استرجاع بنفس العملة: إعادة المبلغ للعميل بالعملة التي دفع بها.

​

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

​

تجربة العميل

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

​

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

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

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

​

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

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

​

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

​

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

1. تبيع منتجًا بـ 100 دولار باستخدام تحويل العملة التكيفي.
2. يرى عميل كندي 137 دولار كندي بسعر صرف 1.37 دولار كندي لكل دولار أمريكي، ويكمل الشراء.
3. نعالج الدفع بتحويل 137 دولار كندي إلى 100 دولار لتسويتك.
4. فيما بعد، يتغير سعر الصرف إلى 1.40 دولار كندي لكل دولار أمريكي وتصدر استرجاع كامل.
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'
});