> ## 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.

# بوابة العملاء

> تمكين العملاء من الخدمة الذاتية وإدارة اشتراكاتهم، تاريخ الفواتير، مفاتيح الترخيص، وملفهم الشخصي بشكل آمن.

<Info>
  بوابة العملاء هي منطقة آمنة مُستضافة حيث يمكن لعملائك إدارة الاشتراكات، وعرض الفواتير، والوصول إلى تفاصيل مفاتيح الترخيص—دون الحاجة للتواصل مع الدعم.
</Info>

<CardGroup cols={2}>
  <Card title="Create Portal Session (API)" icon="code" href="/api-reference/customers/create-customer-portal-session">
    أنشئ برمجيًا جلسات بوابة آمنة ومحددة زمنياً.
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    إدارة الخطط المتكررة، والترقيات، والتخفيضات، والإضافات.
  </Card>
</CardGroup>

<br />

<Frame>
  <img src="https://mintcdn.com/dodopayments/kCngKZVrb0rZMS1f/images/customer-portal/new-portal.png?fit=max&auto=format&n=kCngKZVrb0rZMS1f&q=85&s=9431b2e24142e47cb39dc84c1a0303fe" alt="بوابة العملاء المُجددة التي تظهر الاشتراكات النشطة وطرق الدفع وسجل الفواتير" style={{ maxHeight: '500px', width: 'auto' }} width="2876" height="1568" data-path="images/customer-portal/new-portal.png" />
</Frame>

## ما هي بوابة العملاء؟

توفر البوابة تجربة خدمة ذاتية موثوقة ومميزة للعملاء لـ:

* **الوصول إلى سجل الفواتير**: عرض الفواتير وتنزيل الإيصالات.
* **إدارة الاشتراكات**: عرض تفاصيل الاشتراك، إلغاء الاشتراكات فوراً أو في تاريخ الفوترة التالي.
* **تحديث طرق الدفع**: تغيير طرق الدفع للاشتراكات النشطة أو إعادة تفعيل الاشتراكات المعلقة.
* **استخراج مفاتيح الترخيص**: الوصول إلى جميع المفاتيح المتعلقة بالمشتريات.
* **التنقل بسهولة**: استخدام زر الرجوع للانتقال بين أقسام البوابة دون فقدان السياق.

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

* **خفض حجم الدعم**: يحل العملاء طلبات الفوترة الشائعة بأنفسهم
* **الوصول السريع للقيمة**: وصول فوري للفواتير والمفاتيح
* **تقليل خطر الإلغاء**: رؤية واضحة لتجديدات وتفاصيل الخطط
* **آمن بتصميمه**: الوصول المرمز برموز وروابط منتهية الصلاحية
* **تجربة محلية**: البوابة متوفرة بـ 21 لغة، مع الكشف التلقائي وفقًا لتفضيلات متصفح العميل

## طرق الوصول

يمكن للعملاء الوصول إلى البوابة باستخدام رابط ثابت أو رابط ديناميكي لمرة واحدة.

### رابط ثابت (الوصول عبر البريد الإلكتروني)

يمكن للعملاء طلب الوصول إلى البوابة عن طريق إدخال بريدهم الإلكتروني في رابط ثابت لا ينتهي صلاحيته.

يختلف تنسيق رابط البوابة الثابت حسب البيئة:

**وضع الاختبار** (للاختبار والتطوير):

```bash theme={null}
https://test.customer.dodopayments.com/login/{business_id}
```

**وضع الإنتاج** (للإنتاج مع معاملات حقيقية):

```bash theme={null}
https://customer.dodopayments.com/login/{business_id}
```

استبدل `{business_id}` بمعرّف عملك الفعلي، ثم شارك الرابط المناسب مع العملاء حتى يتمكنوا من إدخال بريدهم الإلكتروني والحصول على وصول آمن إلى البوابة.

<Frame>
  <img src="https://mintcdn.com/dodopayments/kIuKVjhdOQFWlzSx/images/customer-portal/email-login.png?fit=max&auto=format&n=kIuKVjhdOQFWlzSx&q=85&s=bd8ee54177bc23e12e3657c87f487bae" alt="شاشة تسجيل الدخول عبر البريد الإلكتروني" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1550" data-path="images/customer-portal/email-login.png" />
</Frame>

<Steps>
  <Step title="Merchant flow">
    1. انتقل إلى المبيعات → العملاء.
    2. انقر على <i>مشاركة الدعوة</i>.
    3. انسخ <i>الرابط الثابت</i> وشاركه مع عميلك.
  </Step>

  <Step title="Customer flow">
    1. افتح الرابط الثابت.
    2. أدخل البريد الإلكتروني المستخدم أثناء الشراء.
    3. استلم رابط تسجيل دخول آمن للوصول إلى البوابة.

    <Check>
      يتم التعرف على العملاء الحاليين تلقائيًا.
    </Check>
  </Step>
</Steps>

### رابط ديناميكي (رابط سحري)

رابط سحري شخصي لمرة واحدة يرسل العملاء مباشرة إلى البوابة. ينتهي الرابط بعد 24 ساعة.

<Warning>
  تنتهي صلاحية الروابط الديناميكية بعد 24 ساعة. إذا انتهت، فأنشئ وأرسل رابطًا جديدًا.
</Warning>

<Frame>
  <img src="https://mintcdn.com/dodopayments/kIuKVjhdOQFWlzSx/images/customer-portal/magic-link.png?fit=max&auto=format&n=kIuKVjhdOQFWlzSx&q=85&s=8e63714f40468bd6e42c811e194f2698" alt="الوصول المباشر عبر الرابط السحري" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1554" data-path="images/customer-portal/magic-link.png" />
</Frame>

<Steps>
  <Step title="Merchant flow">
    1. انتقل إلى المبيعات → العملاء.
    2. انقر على <i>مشاركة الدعوة</i>.
    3. انسخ <i>الرابط الديناميكي</i> وشاركه مع عميلك.
  </Step>

  <Step title="Customer flow">
    1. افتح الرابط الديناميكي.
    2. ادخل مباشرة إلى بوابة العملاء دون إدخال بريد إلكتروني.
  </Step>
</Steps>

## ميزات البوابة

يوفر بوابة العملاء المُجددة واجهة نظيفة وموحدة مع شريط جانبي يسار وأقسام منظمة لجميع احتياجات إدارة الحساب.

<CardGroup cols={2}>
  <Card title="Active Subscriptions" icon="repeat">
    عرض جميع الاشتراكات النشطة مع اسم الخطة، والسعر، وتاريخ التجديد، وسريان المدة. انقر على "إدارة الاشتراك" لعرض التفاصيل، وتحرير معلومات الفوترة، أو الإلغاء.
  </Card>

  <Card title="Payment Methods" icon="credit-card">
    عرض جميع طرق الدفع المحفوظة (البطاقات، UPI، إلخ) في لمحة. حرّر طرق الدفع مباشرة من تفاصيل الاشتراك.
  </Card>

  <Card title="Billing History" icon="file-invoice">
    عرض جميع المعاملات في جدول مفصل يحتوي على التاريخ، الحالة، نوع التسعير، الصلاحيات، والفواتير القابلة للتنزيل.
  </Card>

  <Card title="Billing Information" icon="user">
    عرض وتحرير الاسم، البريد الإلكتروني، رقم الهاتف، وعنوان الفوترة من صفحة تفاصيل الاشتراك.
  </Card>
</CardGroup>

### نظرة عامة على البوابة

تعرض الصفحة الرئيسية للبوابة جميع الاشتراكات النشطة، وطرق الدفع المحفوظة، وتاريخ الفوترة في عرض قابل للتمرير الواحد.

<Frame>
  <img src="https://mintcdn.com/dodopayments/kCngKZVrb0rZMS1f/images/customer-portal/new-portal.png?fit=max&auto=format&n=kCngKZVrb0rZMS1f&q=85&s=9431b2e24142e47cb39dc84c1a0303fe" alt="الصفحة الرئيسية لبوابة العملاء التي تعرض الاشتراكات النشطة وطرق الدفع" style={{ maxHeight: '500px', width: 'auto' }} width="2876" height="1568" data-path="images/customer-portal/new-portal.png" />
</Frame>

### طرق الدفع وتاريخ الفوترة

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

<Frame>
  <img src="https://mintcdn.com/dodopayments/kCngKZVrb0rZMS1f/images/customer-portal/payment-methods-invoices.png?fit=max&auto=format&n=kCngKZVrb0rZMS1f&q=85&s=1aed6644dbb338cda755798eda99a6f2" alt="طرق الدفع وسجل الفواتير مع تنزيلات الفواتير" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1560" data-path="images/customer-portal/payment-methods-invoices.png" />
</Frame>

## دعم اللغة

بوابة العملاء متوفرة بـ **21 لغة**، لذا يمكن لعملائك إدارة اشتراكاتهم وطرق الدفع وسجل الفواتير باللغة التي يفضلونها.

### كيف تعمل اختيار اللغة

* **الكشف التلقائي**: عند الزيارة الأولى، يكتشف البوابة لغة العميل المفضلة من إعدادات المتصفح ويحمّل الترجمة المطابقة إذا كانت متوفرة. اللغة الإنجليزية تُستخدم كخيار افتراضي.
* **التعديل اليدوي**: يمكن للعملاء تغيير اللغة النشطة في أي وقت من خلال محدد اللغة في رأس البوابة (متاح على كلّ من سطح المكتب والهاتف المحمول).
* **حفظ التفضيلات**: يتم حفظ اللغة المختارة في الكوكي `NEXT_LOCALE` (صالحة لمدة عام واحد) حتى يتذكر البوابة الخيار عبر الجلسات.

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

| اللغة                   | الرمز | اللغة       | الرمز |
| ----------------------- | ----- | ----------- | ----- |
| الإنجليزية (الافتراضية) | `en`  | الإندونيسية | `id`  |
| العربية                 | `ar`  | الإيطالية   | `it`  |
| الكتالونية              | `ca`  | اليابانية   | `ja`  |
| الصينية                 | `zh`  | الكورية     | `ko`  |
| الهولندية               | `nl`  | الماليزية   | `ms`  |
| الفرنسية                | `fr`  | البولندية   | `pl`  |
| الألمانية               | `de`  | البرتغالية  | `pt`  |
| العبرية                 | `he`  | الرومانية   | `ro`  |
| الروسية                 | `ru`  | الإسبانية   | `es`  |
| السويدية                | `sv`  | التايلندية  | `th`  |
| التركية                 | `tr`  |             |       |

## تغييرات الخطة (ترقية/تخفيض)

عندما يتم تنظيم المنتجات في **مجموعات منتج**، يمكن للعميل الترقية أو التخفيض بين الخطط مباشرة من بوابة العملاء.

<Tip>
  **هل تريد تمكين الترقية/التخفيض للاشتراكات الحالية؟** أضف منتجات اشتراكك إلى مجموعة منتج. بمجرد تجميعها، يمكن للعملاء التبديل بين الخطط في نفس المجموعة عبر بوابة العملاء.
</Tip>

### الإجراءات المتاحة

| الإجراء   | الوصف                                 | متى يكون متاحًا                    |
| --------- | ------------------------------------- | ---------------------------------- |
| **ترقية** | الانتقال إلى خطة أعلى في نفس المجموعة | تمكين التحديثات الاشتراكية للأعمال |
| **تخفيض** | الانتقال إلى خطة أدنى في نفس المجموعة | تمكين التحديثات الاشتراكية للأعمال |

### كيفية عمل تغييرات الخطة

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

<Info>
  التغييرات في الخطط متاحة فقط بين المنتجات في نفس المجموعة. يجب أن تكون المنتجات من أنواع الفواتير الاشتراكية أو القائمة على الاستخدام.
</Info>

### عناصر التحكم في الأعمال

يمكن للشركات ضبط سلوك تغييرات الخطة في إعدادات الاشتراكات:

* **السماح بتحديثات الاشتراك**: تمكين أو تعطيل القدرة للعملاء على الترقية أو التخفيض في اشتراكاتهم

<Card title="Product Collections" icon="layer-group" href="/features/product-collections">
  تعرف على كيفية إعداد مجموعات المنتجات وتكوين مسارات الترقية/التخفيض.
</Card>

## تفاصيل الاشتراك

عندما ينقر العملاء على "إدارة الاشتراك" في أي اشتراك نشط، يتم نقلهم إلى صفحة تفاصيل الاشتراك. تُظهر هذه الصفحة:

* **تفاصيل الخطة**: اسم الاشتراك والسعر وتاريخ التجديد وفترة الصلاحية
* **طريقة الدفع**: البطاقة أو طريقة الدفع المرتبطة بالاشتراك، مع زر "تحرير"
* **معلومات الفوترة**: الاسم والبريد الإلكتروني ورقم الهاتف وعنوان الفوترة مع زر "تحرير"
* **تاريخ الفوترة**: جدول تفصيلي بجميع المدفوعات لهذا الاشتراك
* **إلغاء الاشتراك**: زر بارز لإلغاء الاشتراك

<Frame>
  <img src="https://mintcdn.com/dodopayments/kCngKZVrb0rZMS1f/images/customer-portal/subscription-details.png?fit=max&auto=format&n=kCngKZVrb0rZMS1f&q=85&s=4ae46f6878c9343b2e963c516952c9d3" alt="صفحة تفاصيل الاشتراك التي تعرض معلومات الخطة وطريقة الدفع ومعلومات الفوترة وخيار الإلغاء" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1560" data-path="images/customer-portal/subscription-details.png" />
</Frame>

## إلغاء الاشتراك

يمكن للعملاء إلغاء اشتراكهم مباشرة من صفحة تفاصيل الاشتراك. يؤدي النقر على "إلغاء الاشتراك" إلى فتح حوار تأكيد مع خيارين:

* **الإلغاء في تاريخ الفاتورة التالي**: يبقى الاشتراك نشطًا حتى نهاية فترة الفاتورة الحالية، ثم يتم إلغاؤه تلقائيًا.
* **الإلغاء الآن**: يتم إلغاء الاشتراك على الفور.

<Frame>
  <img src="https://mintcdn.com/dodopayments/kCngKZVrb0rZMS1f/images/customer-portal/cance-sub.png?fit=max&auto=format&n=kCngKZVrb0rZMS1f&q=85&s=66eb6e380c991826c431fd0c563cbfa6" alt="حوار إلغاء الاشتراك مع خيارات الإلغاء في تاريخ الفاتورة التالي أو الإلغاء الفوري" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1550" data-path="images/customer-portal/cance-sub.png" />
</Frame>

### أسباب الإلغاء

قبل تأكيد الإلغاء، يُطلب من العملاء **"لماذا تلغي؟"** ويتم تحفيزهم لاختيار سبب من قائمة مختارة بعناية. يتم تخزين السبب في الاشتراك ويظهَر في بيانات الحمولة لويب هوك وAPI، حتى تتمكن من تحليل دوافع الإلغاء وتكييف إجراءات الاستعادة الخاصة بك.

<Frame>
  <img src="https://mintcdn.com/dodopayments/RlXcM7JO-E_w40Np/images/customer-portal/cancellation-reasons.png?fit=max&auto=format&n=RlXcM7JO-E_w40Np&q=85&s=979394da2a9aa3907cbf9f4e225f9a4b" alt="نموذج الإلغاء مع القائمة المنسدلة 'لماذا تلغي؟' تعرض أسباب مثل: غالي جدًا، وميزات مفقودة، وأخرى" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1564" data-path="images/customer-portal/cancellation-reasons.png" />
</Frame>

| القيمة             | التسمية المواجهة للعميل |
| ------------------ | ----------------------- |
| `too_expensive`    | غالي جدًا               |
| `missing_features` | ميزات مفقودة            |
| `switched_service` | التحوّل إلى خدمة أخرى   |
| `unused`           | عدم الاستخدام بشكل كافٍ |
| `customer_service` | خدمة العملاء السيئة     |
| `low_quality`      | جودة منخفضة             |
| `too_complex`      | معقد جدًا               |
| `other`            | أخرى                    |

القيمة المحددة تُكتب في حقل `cancellation_feedback` الخاص بالاشتراك. يمكن أيضًا التقاط `cancellation_comment` النص الحر الاختياري.

```typescript theme={null}
// Read the captured feedback after a customer cancels
const subscription = await client.subscriptions.retrieve('sub_123');
console.log(subscription.cancellation_feedback); // e.g., "too_expensive"
console.log(subscription.cancellation_comment);  // e.g., "Switching to a competitor"
```

الحقول تُضمّن أيضًا في حمولة ويب هوك `subscription.cancelled`، ويمكنك تعبئتها بشكل برمجي على `PATCH /subscriptions/{id}` عند جدولة أو تنفيذ الإلغاء عبر API.

<Tip>
  اجمع `cancellation_feedback` مع [تحصيل الاشتراكات](/features/recovery/subscription-dunning) لتكييف رسائل الاستعادة - مثلاً، أرسل كود خصم إلى `too_expensive` الملغين واستطلاع "ما الذي ينقص؟" إلى `missing_features` الملغين.
</Tip>

## تحديث طرق الدفع

يمكن للعملاء تحديث طرق الدفع الخاصة بهم مباشرةً من صفحة تفاصيل الاشتراك بالنقر فوق "تحرير" بجوار طريقة الدفع. هذه الميزة مهمة بشكل خاص لإعادة تنشيط الاشتراكات التي تم تعليقها بسبب فشل في الدفع.

### إعادة تنشيط الاشتراكات المعلقة

عندما يكون الاشتراك في حالة `on_hold` بسبب فشل في الدفع، يجب على العملاء تحديث طريقة الدفع الخاصة بهم لإعادة تنشيطه. عملية التحديث تقوم تلقائيًا بـ:

1. **إنشاء فاتورة** للمستحقات المتبقية
2. **إنشاء فاتورة** للمبلغ
3. **معالجة الدفع** باستخدام طريقة الدفع الجديدة
4. **إعادة تنشيط الاشتراك** إلى حالة `active` عند نجاح الدفع

<Warning>
  الاشتراكات في حالة `on_hold` لن تتجدد تلقائياً. يجب على العملاء تحديث طريقة الدفع لتسوية المستحقات وإعادة تنشيط الاشتراك.
</Warning>

<Info>
  بعد تحديث طريقة الدفع بنجاح للاشتراك `on_hold`، سيرى العملاء صفحة تأكيد ويتلقون إشعارات عبر البريد الإلكتروني حول نجاح الدفع وإعادة تنشيط الاشتراك.
</Info>

### تدفق تحديث طريقة الدفع

<Steps>
  <Step title="Access subscription details">
    انقر فوق "إدارة الاشتراك" على أي اشتراك نشط من الصفحة الرئيسية للبوابة.
  </Step>

  <Step title="Click Edit on payment method">
    انقر فوق زر "تحرير" بجوار طريقة الدفع لفتح واجهة تحديث طريقة الدفع.
  </Step>

  <Step title="Select or add payment method">
    اختر طريقة دفع محفوظة موجودة أو أضف طريقة جديدة بإدخال تفاصيل البطاقة بشكل آمن.
  </Step>

  <Step title="Confirm changes">
    أكد التحديث. بالنسبة للاشتراكات `on_hold`، سيتم تلقائيًا إنشاء فاتورة للمستحقات المتبقية.
  </Step>

  <Step title="Complete payment (if on hold)">
    إذا كان الاشتراك في حالة انتظار، سيتم توجيه العملاء لإكمال الدفع للمستحقات المتبقية. عند نجاح الدفع، يتم إعادة تنشيط الاشتراك تلقائيًا.
  </Step>

  <Step title="Confirmation">
    يتلقى العملاء تأكيدًا بأن طريقة الدفع قد تم تحديثها وإذا كان ذلك ممكنًا، أن الاشتراك قد تم إعادة تنشيطه.
  </Step>
</Steps>

## أمثلة التكامل

إنشاء جلسة بوابة عملاء محدودة بزمن معين لعميل محدد عبر API، ثم إعادة توجيه المستخدم إلى رابط الجلسة.

<CodeGroup>
  ```typescript Node.js theme={null}
  const session = await client.customers.customerPortal.create('cus_123');

  // Redirect the user to the hosted Customer Portal
  window.location.href = session.link;
  ```
</CodeGroup>

## بوابة العملاء الموحدة

بجانب بوابات العملاء الخاصة بالأعمال، يقدم Dodo Payments **بوابة العملاء الموحدة** على [customer.dodopayments.com](https://customer.dodopayments.com) حيث يمكن للعملاء عرض وإدارة جميع مشترياتهم واشتراكاتهم عبر مختلف الأعمال باستخدام Dodo Payments.

<Frame>
  <img src="https://mintcdn.com/dodopayments/eNGWg9ca-WxQ9nMf/images/changelog/unified-customer-portal.png?fit=max&auto=format&n=eNGWg9ca-WxQ9nMf&q=85&s=bceabb06ca0f00aa2a458f4af95a5cda" alt="بوابة العملاء الموحدة" style={{ maxHeight: '500px', width: 'auto' }} width="1640" height="953" data-path="images/changelog/unified-customer-portal.png" />
</Frame>

### ميزات البوابة الموحدة

* **رؤية عبر الأعمال**: عرض جميع المشتريات والاشتراكات من أي تاجر يستخدم Dodo Payments في مكان واحد
* **إدارة مركزية**: إدارة الاشتراكات عبر مختلف الأعمال من لوحة تحكم واحدة
* **تاريخ فواتير موحد**: الوصول إلى الفواتير وتاريخ الدفع من جميع المشتريات
* **تسجيل دخول موحّد**: تسجيل الدخول مرة واحدة باستخدام البريد الإلكتروني للوصول إلى المشتريات من جميع التجار الذين يستخدمون Dodo Payments

<Tip>
  تُكمّل بوابة العملاء الموحدة البوابات الخاصة بالأعمال. يمكن للعملاء استخدام بوابة التاجر ذات العلامة التجارية أو البوابة الموحدة بناءً على تفضيلهم.
</Tip>

## استكشاف الأخطاء وإصلاحها

* **الرابط منتهي الصلاحية**: إنشاء وإرسال رابط ديناميكي جديد.
* **البريد الإلكتروني غير معروف**: اطلب من العميل استخدام البريد الإلكتروني المرتبط بالمشتريات الخاصة بهم
* **الاشتراك معلق**: إذا كان الاشتراك معلقًا، يجب على العملاء تحديث طريقة الدفع عبر البوابة لتسوية المستحقات وإعادة تنشيط الاشتراك. ستقوم عملية التحديث تلقائيًا بفرض رسوم على المستحقات المتبقية.
* **فشل تحديث طريقة الدفع**: إذا فشلت عملية الدفع أثناء تحديث الاشتراك `on_hold`، فسيظل الاشتراك معلقًا. يمكن للعملاء المحاولة مرة أخرى باستخدام طريقة دفع مختلفة.

<Card title="Design & Theme Customization" icon="palette" href="/features/design">
  خصص مظهر بوابة العملاء الخاصة بك باستخدام ثيمات مبنية مسبقًا، وأنماط الخطوط، والألوان، والمعاينة المباشرة من صفحة التصميم.
</Card>