> ## 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.
# v1.105.0 (٢٢ يونيو ٢٠٢٦)
> أحضر معالج الدفع الخاص بك (BYOP)، الإصدار الرسمي لـ Rust SDK، طرق الدفع الكورية (Kakao Pay, Naver Pay, PAYCO) و Przelewy24، معرف العلامة التجارية على كل حمولة webhook، التعامل مع العملات على نحو دقيق للأرقام العشرية، حدود استحقاق أعلى، بالإضافة إلى تحسينات في الدفع، والتحليلات، ولوحة التحكم.
## الميزات الجديدة
### 1. **أحضر معالج الدفع الخاص بك (BYOP)**
يمكنك الآن توصيل معالج الدفع الخاص بك — **Stripe** أو **Adyen** — وتوجيه المدفوعات من خلاله لكل بلد من البلدان، بينما يواصل Dodo Payments إدارة كل شيء فوق المعاملات: المنتجات، الاشتراكات، مفاتيح الترخيص والاستحقاقات، الفواتير، بوابة العملاء، والتحليلات. في البلدان التي لا تحدد توجيهًا صريحًا لها، يعود النظام إلى Dodo كتاجر سجل للخدمة الكاملة.
قم بإعداده من **الإعدادات → BYOP** في لوحة التحكم: اختر معالج الدفع، وصل حسابك، حدد قواعد التوجيه لكل بلد، وأضف تفاصيل جهة الإصدار الخاصة بك.
**ما الذي يتغير في مسار BYOP**
* **أنت تاجر السجل.** لا يقوم Dodo بحساب أو فرض ضرائب على معاملات BYOP — تحل تفاصيل جهة الإصدار الخاصة بك (اسم العمل، رقم الضريبة، والعنوان) محل كتلة Dodo على الفواتير وإيصالات الاسترداد.
* **يتم التعامل مع النزاعات والاستردادات في معالجك.** تكون نزاعات BYOP قابلة للقراءة فقط في لوحة تحكم Dodo، حيث تحدث عملية القبول/التحدي داخل Stripe أو Adyen.
* تمر المدفوعات عبر Hyperswitch وتدعم حاليًا **البطاقات الائتمانية وبطاقات الخصم فقط**.
**للمطورين**
تتضمن استجابات الدفع والنزاعات الآن مُميّز `payment_provider` (`stripe` أو `adyen` أو `dodo`)، ما يتيح لك تحديد كيفية توجيه كل معاملة، كما تُرجع استجابة معاينة جلسة الدفع `is_byop`. الحقول إضافية — وتستمر حركة Merchant-of-Record في الإبلاغ عن `payment_provider: dodo`.
تعلّم المزيد: [أحضر معالج الدفع الخاص بك](/features/byop) | [BYOP مع Stripe](/features/byop/stripe) | [BYOP مع Adyen](/features/byop/adyen)
### 2. **الإصدار الرسمي لـ Rust SDK**
الآن الإصدار الرسمي لـ **Dodo Payments Rust SDK** متاح كتطبيق `dodopayments` على crates.io. خط الإطلاق يتماشى مع سلسلة إصدار API الخاص بـ Dodo Payments، مع `v1.105.0` كأول إصدار عام لخط API و `v1.106.0` نشرت بالفعل مع آخر تجديد OpenAPI.
تثبيته عبر Cargo:
```bash theme={null}
cargo add dodopayments
```
يتطلب SDK **Rust 1.75+** ومبني لتطبيقات Rust غير المتزامنة باستخدام Tokio و reqwest. ويتضمن:
* نماذج طلب واستجابة بالأنواع عبر واجهة برمجة التطبيقات Dodo Payments.
* `Client::from_env()` لقراءة `DODO_PAYMENTS_API_KEY` من البيئة.
* مساعدي التصفح ذو الأنواع، بما في ذلك `get_next_page()` و `into_stream()` لنقاط النهاية القائمة.
* بيئات وتحديدات زمنية قابلة للتحكم، بما في ذلك دعم وضع الاختبار.
* فك ترميز الاستجابات الثنائية للردود بأسلوب PDF مثل الفواتير، وفواتير الدفع، وفواتير الاسترداد.
* واجهة بناء سلسلة موارد لينة لمواقع اتصال Rust سهلة الاستخدام.
تعلم المزيد: [Rust SDK](/developer-resources/sdks/rust) | [Crates.io](https://crates.io/crates/dodopayments) | [GitHub](https://github.com/dodopayments/dodopayments-rust)
### 3. **طرق الدفع الجديدة: المحافظ الكورية وPrzelewy24**
أربعة طرق دفع محلية جديدة متاحة الآن، مما يوسع التغطية في كوريا الجنوبية وبولندا.
**كوريا الجنوبية (KRW)** — ثلاث محافظ كورية متاحة عند عمليات الدفع بعملة KRW:
| الطريقة | نوع API | الاشتراكات |
| ------------- | ----------- | ------------------ |
| **Kakao Pay** | `kakao_pay` | نعم |
| **Naver Pay** | `naver_pay` | نعم |
| **PAYCO** | `payco` | لا (مرة واحدة فقط) |
تتطلب المحافظ الكورية بلد فوترة `KR` و `KRW` — إذا كانت منتجاتك مسعرة بعملة أخرى، ففعّل العملة التكيفية ليتم فوترة العميل بعملة KRW.
**بولندا (PLN)** — **Przelewy24 (P24)**، طريقة الدفع الرائدة عبر الإنترنت في بولندا، تستقر الآن بعملة `PLN` (وليس اليورو) وتدعم المدفوعات لمرة واحدة. مرر `przelewy24` في `allowed_payment_method_types`.
تعلم المزيد: [طرق الدفع في كوريا الجنوبية](/features/payment-methods/south-korea) | [طرق الدفع الأوروبية](/features/payment-methods/europe) | [نظرة عامة على طرق الدفع](/features/payment-methods)
### 4. **`brand_id` على كل حمولة ويبهوك**
تتضمن الآن كل حمولة حدث ويبهوك `brand_id`، بحيث يمكنك الإشارة إلى المدفوعات، الاشتراكات، الاستردادات، النزاعات، مفاتيح الترخيص، إدخالات دفتر القروض، منح الاستحقاقات، محاولات التحصيل المرفوضة، والعربات المتروكة إلى علامة تجارية معينة. حيث لا تمتلك الهيئة علامة تجارية تخصها، يعود `brand_id` إلى العلامة التجارية الأساسية للأعمال.
لا يلزم تغييرات في التكامل — الحقل يضاف تلقائيًا على نقاط النهاية الموجودة لهبهوك.
تعلم المزيد: [علامات تجارية متعددة](/features/multi-brands) | [أحداث ويبهوك](/developer-resources/webhooks/intents/webhook-events-guide)
### 5. **التعامل مع العملات على نحو دقيق للأرقام العشرية**
تمت إعادة تطوير التعامل مع العملات بحيث يتم حساب وعرض المبالغ بدقة الصحيحة لكل عملة، بدلاً من افتراض وجود رقمين عشريين في كل مكان. يتم الآن التعامل بشكل دقيق مع **16 عملة بدون أرقام عشرية** — بما في ذلك **JPY** و **KRW** و **VND** و **CLP** و **XAF** و **XOF** — عبر المدفوعات، الفواتير، الدفعات، الرسائل الإلكترونية والتحليلات، وتكون التحويلات (العملة التكيفية) واعية بالدقة من البداية إلى النهاية.
يتم إزالة فئة من الأخطاء المتعلقة بالتقريب والعرض للحديث عن العملات بدون أرقام عشرية ويمهد الأرضية لدقات إضافية في المستقبل.
## تحسينات
### 6. **حدود استحقاق المنتج والائتمان أعلى**
* **استحقاقات المنتجات** لكل منتج ارتفعت من **20 إلى 50**.
* **استحقاقات الائتمان** (الائتمانات المرتبطة بمنتج) ارتفعت من **3 إلى 5**.
تعلم المزيد: [الاستحقاقات](/features/entitlements/introduction) | [الفواتير المعتمدة على الائتمان](/features/credit-based-billing)
### 7. **الائتمانات الموقعّة للعملاء حاليًا في معاينة خطة التغيير**
تُرجع معاينة تغيير الخطة الآن `customer_credits` كقيمة **موقعة**: **سلبية** عند خصم الائتمانات لتعويض رسوم (في الترقيات عادةً) و**إيجابية** عند إضافة الائتمانات (من استرداد مخصص للترقية أو إعادة تعبئة المحفظة)، مما يوضح ما إذا كانت الائتمانات تستخدم أو تمنح.
تعلم المزيد: [ترقية وتخفيض الاشتراك](/developer-resources/subscription-upgrade-downgrade)
### 8. **`card_last_four` و `card_network` على قائمة المدفوعات**
تشمل استجابة **قائمة المدفوعات** الآن `card_last_four` و `card_network` على كل دفعة، بحيث يمكنك عرض تفاصيل البطاقة في القوائم دون الحاجة إلى استخراج كل دفعة على حدة.
تعلم المزيد: [قائمة المدفوعات](/api-reference/payments/get-payments)
### 9. **رسائل بريد إلكتروني لـ ACR والتجنب عبر العلامات التجارية**
تستخدم رسائل استرداد عربة التسوق المتروكة (ACR) واسترداد الاشتراك الآن اسم العلامة التجارية وشعارها الخاصين بدلاً من القيمة الافتراضية للأعمال، بحيث تطابق تجربة الاسترداد العلامة التجارية التي قام العميل بالشراء منها.
تعلم المزيد: [تجنب الاشتراك](/features/recovery/subscription-dunning) | [استرداد عربة التسوق المتروكة](/features/recovery/abandoned-cart-recovery)
### 10. **تحسين التحقق من رقم الضريبة**
تم تمديد التحقق من رقم الضريبة عند الدفع ليشمل **اكتشاف التدوين والبحث في السجل** (عبر تكامل Tax ID Pro)، مما يقلل من الرفض الخاطئ لأرقام التعريف الصالحة. يتضمن الآن نموذج التحقق من العمل **محدد البلد** لمنع أخطاء التحقق من رقم الضريبة، وتكون عمليات التحميل الملفات أكثر موثوقية مع **مؤشر تقدم** وتنبيه خطأ موحد.
### 11. **تحسينات التحليلات**
تشمل تحليلات لوحة التحكم الآن تصحيحات الأشتراك الشهرية المتكررة (MRR)، وإحصائيات الاشتراكات النشطة، وحسابات الاستبقاء/الإلغاء.
* **تحليلات منقسمة عبر الصفحات** — توجه جديد يظهر الأداء الإيراد والخصم لكل صفحة دفع.
* تبديل **الإيرادات الصافية والإجمالية** و **تجزئة MRR** على عرض الإيرادات.
* تعرض تلميحات الأدوات على الرسوم البيانية الآن قيم العملات والنسب المئوية، بما في ذلك النقاط ذات القيمة الصفرية.
### 12. **تحسين لوحة التحكم والمتجر**
* تم إضافة **مرشح العلامة التجارية** إلى قائمة المنتجات، مع دمج الفلاتر في زر واحد وتحميل العلامات التجارية حسب الطلب.
* تم إعادة صياغة **نموذج تجميع المنتجات والإضافات والائتمانات** مع تدفقات الإنشاء/التعديل/التكرار.
* تم إعادة تصميم صفحة **إعدادات الدفع** مع إمكانية استرداد دفعة فاشلة.
* تظهر **شارات مزود الدفع** (Stripe / Adyen / Dodo) على جداول المعاملات والنزاعات.
* تمت صقل نص banner المتجر في الواجهة.
### إصلاحات وتحسينات أخرى
* الآن العملات الكورية وعدة عملات أخرى (VND، PYG، XOF، XAF) تنطلق افتراضيًا إلى العملة المحلية عند الدفع.
* إصلاحات الأخطاء البسيطة وتحسينات الاستقرار عبر المنصة.