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

# أسعار ادفع ما تريد

> دع العملاء يختارون سعرهم فوق الحد الأدنى. يمكن عرض سعر مقترح بشكل اختياري. مُحسّن للشراء لمرة واحدة.

**ادفع ما تريد (PWYW)** يتيح للعملاء تحديد المبلغ الذي يدفعونه - عند الحد الأدنى الذي تحدده التاجر أو أعلى. يزيد من التفاعل، ويشجع على دعم المجتمع، ويوفر تسعيرًا مرنًا للمنتجات الرقمية.

<Frame>
  <iframe className="w-full aspect-video rounded-md" src="https://www.youtube.com/embed/Lh0Q01b33NY" title="Pay What You Want Pricing | Dodo Payments" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</Frame>

## ما هو ادفع ما تريد؟

PWYW هو نموذج تسعير حيث يحدد العملاء سعرهم الخاص ضمن الحدود التي تحددها. إنه مثالي لـ:

* **المنتجات الرقمية ووسائل الإعلام**: القوالب، الكتب الإلكترونية، الدورات، الإضافات
* **الإطلاقات التجريبية**: الوصول المبكر، الإصدارات التجريبية، العروض المحدودة زمنياً
* **الحزم والإضافات**: أضف مستوى PWYW لزيادة المشاركة

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

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

<Warning>
  تُتاح PWYW فقط للمنتجات ذات **الدفع الفردي** (مرة واحدة).
</Warning>

## إنشاء ادفع ما تريد

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

### إنشاء المنتج

#### تفاصيل المنتج

* **اسم المنتج** (مطلوب): الاسم المعروض في عملية الدفع والفواتير
* **وصف المنتج** (مطلوب): بيان قيمة واضح يراه العملاء قبل الدفع
* **صورة المنتج** (مطلوب): PNG/JPG/WebP حتى 3 ميغابايت
* **العلامة التجارية**: ربط المنتج بعلامة تجارية معينة للتصميم والبريد الإلكتروني
* **فئة الضريبة** (مطلوب): اختر الفئة الصحيحة لتحديد قواعد الضريبة

<Tip>
  اختر الفئة الضريبية الأدق لضمان تحصيل الضريبة بشكل صحيح لكل منطقة.
</Tip>

#### التسعير

* **نوع التسعير**: اختر <b>دفع واحد</b>
* **ادفع ما تريد** (التبديل): تمكينه للسماح للمشترين باختيار المبلغ
* **الحد الأدنى للسعر** (مطلوب): أقل مبلغ مسموح به يمكن أن يدفعه العميل
* **السعر المقترح** (اختياري): المبلغ الموصى به المعروض على صفحة المنتج

<Tip>
  استخدم البيانات الوصفية لتخزين المعرفات من نظامك (مثل orderId) حتى تتمكن من مطابقة الأحداث والإيصالات لاحقًا.
</Tip>

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

<AccordionGroup>
  <Accordion title="Create checkout sessions (PWYW)">
    استخدم `POST /checkouts` لإنشاء جلسات دفع لمرة واحدة من المنتجات. سيطلب الخروج من المشترين إدخال مبلغ يفي بالحد الأدنى لـ PWYW.

    <Card title="API Reference" icon="code" href="/api-reference/checkout-sessions/create">
      اطّلع على واجهة برمجة تطبيقات إنشاء جلسة الدفع.
    </Card>
  </Accordion>

  <Accordion title="Refund payments">
    استخدم `POST /refunds` لإنشاء ردود كاملة أو جزئية. يُسترد للزبائن المبلغ الذي دفعوه بالضبط.

    <Card title="API Reference" icon="code" href="/api-reference/refunds/post-refunds">
      تعرّف على كيفية رد دفعة.
    </Card>
  </Accordion>

  <Accordion title="List and retrieve">
    استخدم `GET /payments` لعرض قائمة الدفعات و`GET /payments/{payment_id}` لاسترجاع دفعة واحدة. استرجع عناصر السطر باستخدام `GET /payments/{payment_id}/line-items`.

    <Card title="List Payments" icon="code" href="/api-reference/payments/get-payments">
      تصفّح واجهة برمجة تطبيقات القوائم.
    </Card>

    <Card title="Get Payment Detail" icon="code" href="/api-reference/payments/get-payments-1">
      اطّلع على واجهة برمجة تطبيقات الاسترجاع.
    </Card>

    <Card title="Retrieve Line Items" icon="code" href="/api-reference/payments/retrieve-line-items">
      فحّص العناصر المشتراة لدفعة.
    </Card>
  </Accordion>

  <Accordion title="Payment webhooks">
    استجب للأحداث مثل payment.succeeded أو payment.failed في الواجهة الخلفية لديك.

    <Card title="Webhook Guide" icon="code" href="/developer-resources/webhooks/intents/payment">
      تعامل مع أحداث دورة حياة الدفع.
    </Card>
  </Accordion>
</AccordionGroup>

## حالات الاستخدام الشائعة

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

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

### جلسات الدفع (دفع واحد، PWYW)

أضف منتج PWYW إلى السلة. تجمع عملية الدفع المبلغ الذي يختاره المشتري (مع احترام الحد الأدنى الخاص بك) - لا توجد حقول إضافية مطلوبة.

```typescript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_pwyw_demo', quantity: 1 }
  ],
  return_url: 'https://yoursite.com/checkout/success'
});
```

## أفضل الممارسات

* **اختر حدًا أدنى معقولًا**: غطِ التكاليف مع الحفاظ على سهولة المشاركة
* **استخدم سعرًا مقترحًا**: ربط التوقعات لتحسين متوسط قيمة الطلب
* **اشرح القيمة بوضوح**: أخبر المشترين بما يفتحونه بمساهمتهم
* **اختبر الحملات A/B**: عروض محدودة زمنياً وتجربة الرسائل
* **راقب التوزيع**: تتبع المبالغ المدفوعة لتحسين الحد الأدنى والسعر المقترح

<Info>
  يُعد PWYW طريقة مرنة لدعوة مزيد من العملاء مع الحفاظ على حد أدنى للإيرادات. ابدأ ببساطة، اختبر بدقة، وكرر بناءً على معدلات التحويل وتوزيع الإسهامات ومعدلات الإرجاع.
</Info>