> ## 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.81.0 (February 6, 2026)

> تحليلات الطرف الثالث، تخصيص موضوع صفحة الدفع، منع تغيير الخطة عند فشل الدفع، وواجهة برمجة تطبيقات دفتر الأستاذ الرصيد

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

### 1. **دعم تحليلات الطرف الثالث**

تتبع سلوك العملاء عبر واجهة المتجر، ومرحلة الدفع، وبوابة العملاء باستخدام Google Analytics 4 وGoogle Tag Manager وMeta Pixel. أضف معرفات التتبع في **الإعدادات → التحليلات** لبدء جمع أحداث التجارة الإلكترونية.

**المنصات المدعومة**

| Platform | ID Format |
| - | - |
| Google Analytics 4 | `G-XXXXXXXXXX` |
| Google Tag Manager | `GTM-XXXXXXX` |
| Meta Pixel | Numeric (10-20 digits) |

**الأحداث المتعقبة**

يتم إرسال أحداث مثل `purchase`، `add_payment_info`، `view_item`، و`view_item_list` تلقائيًا إلى منصات التحليلات أثناء تصفح العملاء وإتمام عمليات الشراء.

> [!TIP]
>
> مدعومة على واجهة المتجر، ومرحلة الدفع المستضافة، ومرحلة الدفع المتراكبة/المضمنة، وبوابة العملاء.

تعرف على المزيد: [Third-Party Analytics](https://docs.dodopayments.com/features/analytics.md)

### 2. **تخصيص موضوع صفحة الدفع**

خصص مظهر صفحة الدفع عبر المعامل `customization.theme_config` عند إنشاء جلسات الدفع. قم بتكوين الألوان والخطوط ونصف القطر للحدود ونص الزر للوضعين الفاتح والداكن.

**خيارات التكوين**

| Property | Description |
| - | - |
| `light` / `dark` | مخططات الألوان لكل وضع |
| `font_primary_url` | عنوان URL مخصص للخط |
| `font_size` | `xs`، `sm`، `md`، `lg`، `xl`، `2xl` |
| `radius` | نصف قطر الحد (مثل `8px`) |
| `pay_button_text` | نص الزر المخصص |

```typescript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  customization: {
    theme_config: {
      radius: '8px',
      pay_button_text: 'Complete Purchase',
      light: { button_primary: '#0066ff', text_primary: '#1a1a1a' },
      dark: { button_primary: '#3385ff', text_primary: '#ffffff' }
    }
  },
  return_url: 'https://yoursite.com/return'
});
```

اعرف المزيد: [تخصيص سمة صفحة الدفع](https://docs.dodopayments.com/features/checkout.md#theme-customization)

### 3. **منع تغيير الخطة عند فشل الدفع**

المعامل الجديد `on_payment_failure` لتغيير خطة الاشتراك يتحكم بسلوك النظام عند فشل الدفع.

| الوضع | السلوك |
| - | - |
| `prevent_change` | الاحتفاظ بالاشتراك في الخطة الحالية حتى ينجح الدفع |
| `apply_change` | تطبيق تغيير الخطة فورًا بغض النظر عن نتيجة الدفع (افتراضي) |

```typescript theme={null}
await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  on_payment_failure: 'prevent_change'
});
```

> [!TIP]
>
> استخدم `prevent_change` للترقيات الحرجة حيث تريد التأكد من الدفع قبل منح الوصول إلى الميزات المتميزة.

تعرف على المزيد: [Handling Payment Failures](https://docs.dodopayments.com/developer-resources/subscription-upgrade-downgrade.md#handling-payment-failures)

## تحديثات واجهة برمجة التطبيقات

### واجهة برمجة تطبيقات دفتر الأستاذ الرصيد

نقطة النهاية الجديدة `GET /balances/ledger` لاسترداد سجلات دفتر حسابك مع التصفية والترقيم.

| Parameter | Description |
| - | - |
| `created_at_gte` / `created_at_lte` | التصفية حسب النطاق الزمني |
| `event_type` | التصفية حسب `payment`، `refund`، `dispute`، `payout`، إلخ. |
| `currency` | التصفية حسب رمز العملة |
| `reference_object_id` | التصفية حسب معرف الدفع/الاسترداد/النزاع المحدد |

تعرف على المزيد: [Balance Ledger API](https://docs.dodopayments.com/api-reference/balance-ledger/list-ledger-entries.md)

### استجابة الدفع: `refund_status`

تمت إضافة حقل `refund_status` إلى استجابة `GET /payments/{payment_id}` للتحقق سريعًا مما إذا كانت الدفعة قد تم ردّها دون الاستعلام عن نقطة نهاية عمليات ردّ الأموال بشكل منفصل.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.