> ## 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="License Keys" icon="code" href="/features/license-keys">
    أصدر مفاتيح ترخيص فريدة بعد الشراء.
  </Card>

  <Card title="Digital Delivery" icon="code" href="/features/digital-product-delivery">
    سلم الملفات والمحتوى تلقائيًا بعد الدفع.
  </Card>

  <Card title="Payment Webhooks" icon="code" href="/developer-resources/webhooks/intents/payment">
    تفاعل مع أحداث نجاح/فشل الدفع والإيصالات.
  </Card>

  <Card title="Refunds API" icon="code" href="/api-reference/refunds/post-refunds">
    أنشئ ردود أموال كاملة أو جزئية برمجيًا.
  </Card>
</CardGroup>

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

المدفوعات لمرة واحدة هي عمليات شراء ثابتة ومقدمة - مثالية لـ:

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

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

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

## إنشاء منتجات لمرة واحدة

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

<Frame>
  <img src="https://mintcdn.com/dodopayments/r-ndtvzx3WhKqwER/images/products.png?fit=max&auto=format&n=r-ndtvzx3WhKqwER&q=85&s=fb41221c4f2af4de0155e71de1ac6904" alt="منتجات الدفع لمرة واحدة" style={{ maxHeight: '500px', width: 'auto' }} width="1911" height="927" data-path="images/products.png" />
</Frame>

### تكوين المنتج

قم بتكوين الحقول في لوحة التحكم لتعريف كيفية ظهور منتجك وبيعه.

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

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

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

#### التسعير

* **نوع التسعير**: اختر <b>دفعة واحدة</b>
* **السعر** (مطلوب): رسوم ثابتة مع العملة
* **الخصم المطبق (%)**: نسبة الخصم الاختيارية المعروضة في الدفع والفواتير

<Warning>
  يؤثر تغيير تسعير المنتج على عمليات الشراء الجديدة فقط. العملاء الحاليون غير متأثرين.
</Warning>

#### الإعدادات المتقدمة

* **أسعار شاملة الضرائب**: عرض الأسعار شاملة الضرائب المطبقة
* **إنشاء مفاتيح الترخيص**: إصدار مفتاح فريد بعد الشراء. انظر <a href="/features/license-keys">مفاتيح الترخيص</a>
* **تسليم المنتج الرقمي**: تسليم الملفات أو المحتوى تلقائيًا. انظر <a href="/features/digital-product-delivery">تسليم المنتج الرقمي</a>
* **البيانات الوصفية**: إرفاق أزواج مفتاح-قيمة مخصصة للتصنيف الداخلي أو التكاملات. انظر <a href="/api-reference/metadata">البيانات الوصفية</a>

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

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

<AccordionGroup>
  <Accordion title="Create payments">
    استخدم `POST /checkouts` لإنشاء رسوم لمرة واحدة من المنتجات.

    <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 payments">
    استخدم `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>

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

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

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

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

إنشاء جلسة دفع مع منتج لمرة واحدة في السلة:

```typescript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_one_time', quantity: 1 }
  ]
});
```

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

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

<Info>
  المدفوعات لمرة واحدة هي أسرع طريق لبيع المنتجات ذات السعر الثابت. ابدأ ببساطة، وحقق التوصيل، وكرر عرضك بناءً على التحويل والتعليقات.
</Info>