> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payzah.site/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# دليل البداية السريعة: أول عملية دفع خلال 5 دقائق

> ابدأ أول عملية دفع تجريبية عبر بوابة Payzah خلال خمس دقائق باستخدام المفتاح التجريبي العام: أنشئ رابط دفع، ادفع ببطاقة اختبار، ثم تحقق من النتيجة.

<div dir="rtl">
  استقبل أول عملية دفع عبر بوابة Payzah خلال خمس دقائق تقريبًا. انسخ طلبًا واحدًا، شغّله، واحصل على رابط دفع مباشر يمكنك فتحه في المتصفح. لا حاجة إلى إنشاء حساب.

  جميع الخطوات في هذه الصفحة تعمل على **البيئة التجريبية**، لذلك لن يتم تحويل أي أموال حقيقية.
</div>

<Note>
  <div dir="rtl">
    متجرك يعمل على Shopify أو WooCommerce أو Odoo؟ لا حاجة لاستخدام الواجهة البرمجية — [ثبّت الإضافة الخاصة بمنصتك](/docs/plugins/overview) مباشرة.
  </div>
</Note>

<div dir="rtl">
  ## ما الذي تحتاجه

  لا شيء. استخدم مفتاح البيئة التجريبية العام أدناه وابدأ فورًا، دون الحاجة إلى حساب.
</div>

```text theme={null}
NzYxMGVlNjFhZDJkZGJlODAzYmU2MjZmNzZhYmM5OTZkNDdkY2JiZA==
```

<div dir="rtl">
  هذا مفتاح تجريبي مشترك، مُشفَّر مسبقًا بصيغة Base64، ويعمل على البيئة التجريبية فقط. عندما تصبح جاهزًا للإطلاق، [سجّل عبر تطبيق Payzah](http://onelink.to/gjt5ed) للحصول على مفتاحك الخاص.
</div>

<Steps>
  <Step title="إنشاء عملية دفع">
    <div dir="rtl">
      شغّل الأمر التالي كما هو — المفتاح التجريبي مُدرج بالفعل.
    </div>

    ```bash Terminal theme={null}
    curl --request POST \
      --url https://development.payzah.net/ws/paymentgateway/index \
      --header 'Content-Type: application/json' \
      --header 'Authorization: NzYxMGVlNjFhZDJkZGJlODAzYmU2MjZmNzZhYmM5OTZkNDdkY2JiZA==' \
      --data '{
        "trackid": "QUICKSTART-001",
        "amount": "1.000",
        "currency": "414",
        "payment_type": "3",
        "success_url": "https://example.com/success",
        "error_url": "https://example.com/error"
      }'
    ```

    <div dir="rtl">
      ستحصل على استجابة مشابهة لما يلي:
    </div>

    ```json Response theme={null}
    {
      "status": true,
      "data": {
        "PaymentUrl": "https://development.payzah.net/pgaction",
        "PaymentID": "2019070115360420",
        "transit_url": "https://devgateway.trytajer.app?id=202409271806248183",
        "direct_url": ""
      }
    }
    ```

    <div dir="rtl">
      **احتفظ بقيمة `PaymentID`.** ستحتاج إليها في الخطوة التالية وعند تنفيذ أي عملية استرداد.
    </div>

    <Tip>
      <div dir="rtl">
        هل حصلت على `status: false` بدلًا من ذلك؟ الرمز `10014` يعني أن المفتاح لم يُرسل بشكل صحيح — تأكد من عدم وجود مسافة أو سطر إضافي. راجع [حل المشكلات](/docs/guides/troubleshooting) لبقية الرموز.
      </div>
    </Tip>
  </Step>

  <Step title="إتمام الدفع">
    <div dir="rtl">
      افتح رابط `transit_url` من الاستجابة في متصفحك. هذه هي صفحة الدفع التي سيراها عملاؤك.

      أتمم الدفع باستخدام [بطاقة اختبار](/docs/guides/test-credentials)، ثم دع الصفحة تعيد توجيهك.
    </div>

    <Warning>
      <div dir="rtl">
        إعادة التوجيه إلى رابط النجاح **لا تعني** أنك استلمت المبلغ. أي شخص يستطيع فتح ذلك الرابط مباشرة. تحقّق دائمًا من جهة الخادم — وهذه هي الخطوة التالية.
      </div>
    </Warning>
  </Step>

  <Step title="تأكيد استلام المبلغ">
    <div dir="rtl">
      تحقّق من النتيجة الفعلية باستخدام `trackid` و`PaymentID` من الخطوة الأولى.
    </div>

    ```bash Terminal theme={null}
    curl --request POST \
      --url https://development.payzah.net/ws/paymentgateway/get-payment-details \
      --header 'Content-Type: application/json' \
      --header 'Authorization: NzYxMGVlNjFhZDJkZGJlODAzYmU2MjZmNzZhYmM5OTZkNDdkY2JiZA==' \
      --data '{
        "trackid": "QUICKSTART-001",
        "payment_id": "2019070115360420"
      }'
    ```

    <div dir="rtl">
      ابحث عن حقل `paymentStatus` في الاستجابة:
    </div>

    ```json Response theme={null}
    {
      "status": true,
      "data": {
        "payzahRefrenceCode": "202303935749373001",
        "trackId": "QUICKSTART-001",
        "paymentStatus": "CAPTURED"
      }
    }
    ```

    <div dir="rtl">
      القيمة `CAPTURED` تعني أن المبلغ تم تحصيله فعليًا. **لا تنفّذ الطلب إلا عند الحصول على `CAPTURED`** — أي قيمة أخرى تعني أن المبلغ لم يُستلم. راجع [جميع قيم الحالة](/docs/api-reference/response-codes).
    </div>
  </Step>
</Steps>

<div dir="rtl">
  بهذا تكون قد أتممت دورة دفع كاملة. كل ما تبقّى يُبنى على هذه الطلبات الثلاثة.

  ## جرّبها دون كتابة أي كود

  تفضّل النقر بدلًا من استخدام سطر الأوامر؟ كل نقطة نهاية لديها واجهة تفاعلية موجّهة إلى البيئة التجريبية — املأ الحقول واضغط إرسال.
</div>

<CardGroup cols={3}>
  <Card title="إنشاء عملية دفع" icon="play" href="/docs/api-reference/payments/initialize-a-payment">
    إنشاء جلسة دفع جديدة.
  </Card>

  <Card title="التحقق من حالة الدفع" icon="magnifying-glass" href="/docs/api-reference/payments/check-payment-status">
    التأكد من نتيجة العملية.
  </Card>

  <Card title="استرداد مبلغ" icon="rotate-left" href="/docs/api-reference/refunds/refund-a-payment">
    إعادة المبلغ إلى العميل.
  </Card>
</CardGroup>

<div dir="rtl">
  ## الخطوات التالية

  بقية التوثيق متوفرة باللغة الإنجليزية.
</div>

<CardGroup cols={2}>
  <Card title="اختيار طريقة الربط" icon="code-branch" href="/docs/getting-started/integration-methods">
    قارن بين صفحة الدفع المستضافة والربط المباشر مع كي نت أو البطاقات.
  </Card>

  <Card title="عمليات الاسترداد" icon="rotate-left" href="/docs/guides/refund">
    تنفيذ استرداد كلي أو جزئي لعملية مكتملة.
  </Card>

  <Card title="بيانات الاختبار" icon="flask" href="/docs/guides/test-credentials">
    بطاقات تجريبية لكي نت وفيزا وماستركارد.
  </Card>

  <Card title="قائمة الإطلاق" icon="rocket" href="/docs/guides/go-live-checklist">
    راجع القائمة قبل التحويل إلى بيئة الإنتاج.
  </Card>
</CardGroup>

<div dir="rtl">
  ## تحتاج مساعدة؟

  تواصل مع فريق Payzah على [Info@payzah.com](mailto:Info@payzah.com) أو اتصل على [22410760 965+](tel:+96522410760).
</div>