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

# إدارة العملاء

> إدارة علاقات العملاء، تتبع تاريخ الشراء، وتوفير خيارات الخدمة الذاتية من خلال لوحة معلومات Dodo Payments وAPI.

## نظرة عامة

توفر ميزة العملاء في Dodo Payments مركزًا موحدًا لإدارة جميع علاقات العملاء. تتبع كل تفاعل مع العميل، عرض تاريخ الشراء، إدارة الاشتراكات، الوصول إلى سجلات معاملات المحفظة، وتفعيل خيارات الخدمة الذاتية — كل ذلك من لوحة تحكم واحدة.

<CardGroup cols={2}>
  <Card title="Customer Dashboard" icon="table-columns">
    عرض وإدارة جميع العملاء في مكان واحد مع إمكانيات البحث والتصفية.
  </Card>

  <Card title="Customer Wallets" icon="wallet">
    إدارة الأرصدة النقدية المدفوعة مسبقًا، تمويل المحافظ، وتتبع سجل المعاملات.
  </Card>

  <Card title="Customer Portal" icon="id-card">
    تمكين العملاء من إدارة الاشتراكات والفواتير ومفاتيح الترخيص بأنفسهم.
  </Card>

  <Card title="API Management" icon="code">
    إنشاء وتحديث واسترجاع بيانات العملاء برمجيًا عبر واجهة برمجة التطبيقات.
  </Card>
</CardGroup>

## الوصول إلى صفحة العملاء

<Steps>
  <Step title="Navigate to Customers">
    من لوحة التحكم، انقر على **المبيعات > العملاء** في قائمة التنقل.
  </Step>

  <Step title="View Customer List">
    ستعرض صفحة العملاء قائمة بجميع العملاء الحاليين والسابقين الذين تعاملوا مع عملك.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/dodopayments/IKECEhkZu9f1KFmK/images/customer/customers-list.png?fit=max&auto=format&n=IKECEhkZu9f1KFmK&q=85&s=d110d27ad8c3fa8e623241b62d47601c" alt="صفحة قائمة العملاء التي تعرض جميع العملاء مع تفاصيلهم" style={{ maxHeight: '500px', width: 'auto' }} width="1662" height="782" data-path="images/customer/customers-list.png" />
</Frame>

## معلومات العميل

في **صفحة العملاء**، يمكنك رؤية نظرة شاملة على قاعدة عملائك بالكامل. تعرض الجدول جميع العملاء مع المعلومات التالية:

### أعمدة قائمة العملاء

* **اسم العميل**: الاسم الكامل للعميل مع مؤشر الصورة الرمزية.
* **معرّف العميل**: معرف فريد (مثل `cus_5fpsWAa...`) لكل عميل.
* **البريد الإلكتروني**: عنوان البريد الإلكتروني للعميل للتواصل والوصول إلى البوابة.
* **رقم الهاتف**: رقم هاتف العميل (إن تم توفيره).
* **تاريخ الإنشاء (UTC)**: التاريخ والوقت الذي تم فيه إنشاء حساب العميل.
* **دعوة**: زر إجراء سريع لمشاركة دعوات بوابة العميل.

### ميزات الصفحة

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

<Tip>
  استخدم ميزة "تحرير الأعمدة" لتخصيص العرض الخاص بك وإظهار المعلومات الأكثر صلة بتدفق عملك.
</Tip>

## صفحة تفاصيل العميل

انقر على أي عميل لعرض صفحة معلوماته التفصيلية، والتي تتضمن:

<Frame>
  <img src="https://mintcdn.com/dodopayments/IKECEhkZu9f1KFmK/images/customer/customer-details.png?fit=max&auto=format&n=IKECEhkZu9f1KFmK&q=85&s=4f1d97a2d31f5e64fb4a075dde6239ff" alt="صفحة تفاصيل العميل التي تعرض معلومات العميل وتاريخ المعاملات" style={{ maxHeight: '500px', width: 'auto' }} width="1657" height="931" data-path="images/customer/customer-details.png" />
</Frame>

### قسم حول

يعرض قسم حول المعلومات الأساسية للعميل:

* **الاسم**: الاسم الكامل للعميل
* **البريد الإلكتروني**: عنوان البريد الإلكتروني للعميل
* **معرف العميل**: معرف فريد لأغراض API والتتبع
* **تاريخ الإنشاء**: الطابع الزمني عند إنشاء حساب العميل

### علامات نشاط العميل

تتضمن صفحة تفاصيل العميل ثلاث علامات لعرض جوانب مختلفة من نشاط العميل:

<Tabs>
  <Tab title="Transactions History">
    عرض جميع معاملات الدفع لهذا العميل بما في ذلك:

    * **معرّف الدفع**: معرف فريد للمعاملة
    * **الحالة**: حالة الدفع (ناجحة، فاشلة، معلقة، معادة)
    * **المبلغ**: مبلغ المعاملة
    * **التاريخ (UTC)**: موعد حدوث المعاملة
    * **نوع التسعير**: سواء كانت عملية شراء لمرة واحدة أو اشتراك
    * **طريقة الدفع**: طريقة الدفع المستخدمة (بطاقة، UPI، إلخ)
    * **البريد الإلكتروني للعميل**: البريد المرتبط بالمعاملة
    * **استرداد**: إجراء سريع لبدء استرداد الأموال
    * **الإجراءات**: خيارات إضافية لإدارة المعاملة
  </Tab>

  <Tab title="Active Subscriptions">
    عرض جميع الاشتراكات النشطة لهذا العميل:

    * تفاصيل خطة الاشتراك
    * دورة الفوترة وتاريخ التجديد التالي
    * حالة الاشتراك
    * خيارات لإدارة أو إلغاء الاشتراكات
  </Tab>

  <Tab title="Wallet Ledger">
    عرض دفتر معاملات محفظة العميل الذي يُظهر:

    * جميع الإضافات والخصومات في الأموال

    * رصيد المحفظة الحالي بكل عملة (USD، INR)

    * أسباب المعاملات والطوابع الزمنية

    * سجل معاملات مفصّل للمطابقة
      عرض دفتر رصيد محفظة العميل الذي يُظهر:

    * جميع معاملات الائتمان والخصم

    * رصيد المحفظة الحالي بكل عملة

    * أسباب المعاملات والطوابع الزمنية

    * سجل معاملات مفصّل للمطابقة
  </Tab>
</Tabs>

<Note>
  يوفر تبويب دفتر المحفظة شفافية كاملة في معاملات محفظة العميل، مما يجعل من السهل تتبع الإضافات، الخصومات، والأرصدة النقدية الحالية.
</Note>

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

بوابة العميل هي منطقة خدمة ذاتية مؤمنة ومستضافة حيث يمكن لعملائك إدارة اشتراكاتهم، عرض تاريخ الفوترة، الوصول إلى مفاتيح التراخيص، وتحديث ملفهم الشخصي — دون الحاجة للتواصل مع الدعم.

### قدرات البوابة

يمكن للعملاء الوصول إلى البوابة لـ:

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

<Card title="Learn More About Customer Portal" icon="id-card" href="/features/customer-portal">
  استكشف الوثائق التفصيلية حول ميزات البوابة، طرق الوصول، وأمثلة التكامل.
</Card>

## محافظ العملاء

محافظ العملاء هي حسابات أرصدة نقدية مدفوعة مسبقًا لعملائك. يحصل كل عميل تلقائيًا على محفظة يمكنها احتواء أموال حقيقية بعدة عملات (USD وINR)، والتي يمكن تطبيقها على فواتير الاشتراكات، استخدامها لأرصدة الاسترداد، أو تمويلها بمكافآت ترويجية.

### الميزات الرئيسية

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

<Card title="Learn More About Customer Wallets" icon="wallet" href="/features/customer-wallet">
  استكشف الوثائق التفصيلية، أمثلة الشيفرة، وأفضل الممارسات لإدارة أرصدة محافظ العملاء.
</Card>

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

توفر Dodo Payments واجهة REST API شاملة لإدارة العملاء برمجيًا. يمكنك إنشاء العملاء، استرجاعهم، تحديثهم، وإدارتهم بالكامل من خلال الواجهة البرمجية.

### نقاط نهاية API المتاحة

<CardGroup cols={2}>
  <Card title="Create Customer" icon="user-plus" href="/api-reference/customers/create-customer">
    إنشاء عميل جديد في حساب Dodo Payments الخاص بك باستخدام تفاصيله.
  </Card>

  <Card title="List Customers" icon="list" href="/api-reference/customers/get-customers">
    استرجاع قائمة منبثقة من جميع العملاء المرتبطين بحسابك.
  </Card>

  <Card title="Get Customer Details" icon="user" href="/api-reference/customers/get-customers-1">
    الحصول على معلومات مفصلة حول عميل معين بواسطة معرفه.
  </Card>

  <Card title="Update Customer" icon="pen" href="/api-reference/customers/patch-customer">
    تحديث معلومات العميل مثل الاسم أو البريد الإلكتروني أو البيانات الوصفية.
  </Card>

  <Card title="Delete Payment Method" icon="trash" href="/api-reference/customers/delete-payment-method">
    أزل وسيلة دفع محفوظة من حساب العميل.
  </Card>

  <Card title="Create Portal Session" icon="arrow-up-right-from-square" href="/api-reference/customers/create-customer-portal-session">
    قم بإنشاء رابط جلسة آمن لـ Customer Portal لعميل محدد.
  </Card>
</CardGroup>

<Note>
  تتطلب جميع نقاط نهاية API المصادقة باستخدام مفتاح API الخاص بك. استخدم دائمًا مفتاحك السري على الجانب الخادم ولا تعرضه أبدًا في رمز العميل.
</Note>