> ## 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.94.0 (8 أبريل 2026)

> استعادة عربة التسوق المتروكة، اشتراك Dunng، بيانات الخصم، webhooks الاسترداد، مدفوعات Pix للبرازيل، وWeChat Pay للعملاء الصينيين

## ميزات جديدة

### 1. **استعادة العربات المهجورة**

الكشف التلقائي عن عمليات الدفع غير المكتملة أو الفاشلة وإرسال تسلسل البريد الإلكتروني المستهدف لإرجاع العملاء. تراقب ACR المدفوعات التي لم تنجح بعد 60 دقيقة وتقوم بتصنيفها على أنها **الدفع فشل** أو **الدفع غير مكتمل**، ثم ترسل حتى 3 رسائل بريد إلكتروني قابلة للتكوين في كل تسلسل.

<Frame>
  <img src="https://mintcdn.com/dodopayments/B3-0kuKcZDP1TiJD/images/recovery/recovery-analytics.png?fit=max&auto=format&n=B3-0kuKcZDP1TiJD&q=85&s=d3bf0c7474818bc4584b75654423e14c" alt="لوحة تحليلات الاسترداد تعرض عدد العربات المهجورة ونسب الاسترداد والإيرادات المستردة" style={{ maxHeight: '500px', width: 'auto' }} width="2548" height="2190" data-path="images/recovery/recovery-analytics.png" />
</Frame>

القدرات الرئيسية:

* **تسلسل بريد إلكتروني مزدوج** — فشل الدفع والدفع غير المكتمل، كل منها يحتوي على ما يصل إلى 3 رسائل
* **خصومات الاسترداد** — خيار لتوليد أكواد خصم للاستخدام مرة واحدة تلقائيًا لتحفيز الاسترداد
* **صفحة استرداد العملاء** — روابط استرداد فريدة تأخذ العملاء إلى صفحة مخصصة لإتمام عملية الشراء
* **تحليلات الاسترداد** — تتبع عدد العربات المهجورة، نسب الاسترداد، الإيرادات المستردة، والتقسيمات على البريد الإلكتروني/المنتج

<Tip>
  ابدأ بتوقيت البريد الإلكتروني الافتراضي (1 ساعة، 24 ساعة، 72 ساعة) وقم بالتكرار بناءً على بيانات تحليلات الاسترداد الخاصة بك.
</Tip>

تعرف على المزيد: [استعادة العربات المهجورة](/features/recovery/abandoned-cart-recovery)

### 2. **معالجة اشتراكات متعثرة**

إرسال تسلسل البريد الإلكتروني تلقائيًا لاستعادة الاشتراكات المتعثرة أو الملغاة. يتم تحفيز المعالجة عندما يدخل الاشتراك في حالة **التعليق** (فشل الدفع) أو يتم **إلغاء** الاشتراك من قبل العميل من بوابة العملاء.

القدرات الرئيسية:

* **تسلسل بريد إلكتروني مزدوج** — التعليق والإلغاء، كل منها يحتوي على ما يصل إلى 4 رسائل
* **الشحن التلقائي** — عندما يقوم العميل بتحديث طريقة الدفع الخاصة به، يتم تحصيل المبالغ المستحقة تلقائيًا
* **ضبط التوقيت** — فترات افتراضية عند 1، 3، 5، و7 أيام، قابلة للتخصيص بالكامل لكل بريد إلكتروني

تعرف على المزيد: [معالجة اشتراكات متعثرة](/features/recovery/subscription-dunning)

### 3. **ميتاداتا الخصومات**

يمكنك الآن إرفاق **ميتاداتا** (أزواج مفتاح-قيمة) بالخصومات عند إنشائها أو تحديثها عبر API. استخدم الميتاداتا لتتبع الخصومات حسب الحملة أو المصدر أو المرجع الداخلي للتتبع والتوفيق.

```typescript theme={null}
const discount = await client.discounts.create({
  type: 'percentage',
  amount: 1500, // 15%
  code: 'SUMMER2025',
  metadata: {
    campaign: 'summer_promo',
    source: 'email_blast'
  }
});
```

تعرف على المزيد: [أكواد الخصم](/features/discount-codes) | [دليل الميتاداتا](/api-reference/metadata)

### 4. **استرداد Webhooks**

أحداث webhook جديدة لتتبع دورة حياة الاسترداد:

| الحدث                          | الوصف                                    |
| ------------------------------ | ---------------------------------------- |
| `abandoned_checkout.detected`  | تم الكشف عن عملية دفع مهجورة             |
| `abandoned_checkout.recovered` | أكمل العميل الدفع عبر رابط الاسترداد     |
| `dunning.started`              | تم بدء محاولة معالجة اشتراك              |
| `dunning.recovered`            | قام العميل بتحديث طريقة الدفع ونجح الدفع |

تعرف على المزيد: [استرداد Webhooks](/developer-resources/webhooks/intents/recovery)

### 5. **مدفوعات Pix للبرازيل**

اقبل **Pix** — نظام الدفع الفوري في البرازيل الذي أنشأه البنك المركزي البرازيلي — في عملية شراء Dodo Payments. يعد Pix الآن وسيلة الدفع الأكثر استخدامًا في البرازيل، متجاوزًا كل من بطاقات الائتمان وboleto، ويؤكد في ثوانٍ على مدار اليوم.

**التغطية**

| التفاصيل         | القيمة                           |
| ---------------- | -------------------------------- |
| عملة الفوترة     | BRL                              |
| البلدان المدعومة | البرازيل                         |
| الاشتراكات       | غير مدعومة (الدفعات الواحدة فقط) |
| المبلغ الأدنى    | \$0.50                           |
| التسوية          | فورية                            |

**التكوين**

مرر `pix` في `allowed_payment_method_types` وقم بتعيين عملة الفوترة إلى `BRL`:

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['pix', 'credit', 'debit'],
  billing_currency: 'BRL',
  return_url: 'https://example.com/success'
});
```

يظهر للعميل رمز QR الخاص بـ Pix ومفتاح النسخ واللصق عند الخروج. يفتحون تطبيقهم المصرفي، ويمسحون أو يلصقون، ويتم تأكيد الدفع فورًا.

<Tip>
  تنتهي صلاحية رموز QR لـ Pix بعد نافذة محددة — صمم تدفق الخروج الخاص بك للسماح للعملاء بإعادة توليد الرمز إذا لزم الأمر. دائمًا قم بتضمين البدائل البطاقة للعملاء الذين يفضلون الدفع بالبطاقة.
</Tip>

تعرف على المزيد: [مدفوعات Pix](/features/payment-methods/pix)

### 6. **WeChat Pay للعملاء الصينيين**

اقبل **WeChat Pay** — المستخدم من قبل أكثر من مليار شخص في جميع أنحاء الصين — مباشرة في عملية شراء Dodo Payments. يقوم العملاء بمسح رمز QR باستخدام تطبيق WeChat الخاص بهم ويؤكدون الدفع في ثوانٍ، وكل ذلك دون مغادرة نظام WeChat البيئي.

**التغطية**

| التفاصيل      | القيمة                           |
| ------------- | -------------------------------- |
| عملات الفوترة | USD، CNY                         |
| الاشتراكات    | غير مدعومة (الدفعات الواحدة فقط) |
| المبلغ الأدنى | \$0.50 / ¥1.00                   |
| التسوية       | USD                              |

**التكوين**

مرر `we_chat_pay` في `allowed_payment_method_types` عند إنشاء جلسة سداد:

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['we_chat_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});
```

يدعم WeChat Pay كل من **USD** (للتجار العابرين للحدود المستهدفين للعملاء الصينيين) و **CNY** (للمعاملات المحلية الصينية). تتم التسوية للتجار بالدولار الأمريكي بغض النظر عن عملة الفوترة.

<Tip>
  اعرض الخروج على سطح مكتب أو جهاز لوحي حتى يتمكن العملاء من مسح رمز QR بهاتفهم — هذا هو التدفق الأكثر شهرة لمستخدمي WeChat Pay.
</Tip>

تعرف على المزيد: [WeChat Pay](/features/payment-methods/wechat)