الحسابات

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

توجد أدوات العمل مع الحسابات في قسم "الحسابات" ضمن قسم "المدفوعات". توجد الحسابات المدفوعة التي تم إنشاؤها مسبقًا في القائمة العامة. أدناه توجد نموذج لإنشاء حسابات دفع جديدة.

أنواع حسابات الدفع.

في الوقت الحالي، يوجد في النظام نوعان من حسابات الدفع للاختيار من بينها.

Stripe

تدعم منصة OneEntry التكامل مع نظام الدفع Stripe. اختر هذا النوع إذا كنت ترغب في ربط نظام الدفع Stripe بمشروعك. لمزيد من التفاصيل حول كيفية ربط Stripe بمنصة OneEntry، يمكنك الاطلاع على هنا.

مخصص

إذا كنت ترغب في استخدام نظام دفع آخر أو قبول الدفع نقدًا، استخدم هذا النوع من حسابات الدفع.

إنشاء حساب دفع

في نموذج إنشاء حساب الدفع، حدد:

الاسم - سلسلة غير فريدة
النوع - قيمة من القائمة المنسدلة.
العلامة - سلسلة فريدة.

بعد ملء النموذج، اضغط على زر "إضافة". إذا كانت جميع الحقول مملوءة بشكل صحيح، سيتم إنشاء حساب الدفع وإضافته إلى القائمة العامة.

تعديل حساب الدفع

اختر من القائمة حساب الدفع الذي ترغب في تعديله واضغط على أيقونة التعديل .

في وضع التحرير، يمكنك تعديل:

الاسم
النوع
العلامة

سيتم حفظ التغييرات تلقائيًا.

المعلمات المخصصة لواجهة برمجة تطبيقات الدفع

للتكامل المرن مع أنظمة الدفع المختلفة (مثل PayPal وStripe وغيرها)، يمكن إضافة معلمات مخصصة إلى حساب الدفع، وهي محددة لواجهة برمجة التطبيقات المعينة.

تُرسل هذه المعلمات على شكل أزواج "مفتاح-قيمة" عند تهيئة جلسة الدفع. على سبيل المثال، تتطلب واجهة برمجة تطبيقات طلبات PayPal غالبًا حقولًا مثل purchase_units وintent وapplication_context.return_url أو payer.email_address، بينما تستخدم Stripe معلمات أخرى مثل mode وline_items وما إلى ذلك.

كيف يعمل ذلك

بجانب الحقول الأساسية (الاسم، النوع، العلامة)، سترى جدول "المعلمات المخصصة لواجهة برمجة تطبيقات الدفع". الجدول هو تجميع لمجموعات من السمات من وحدة الإعدادات، ويسمح بتحديد المطابقة بين:

العلامة (اسم المعلمة في واجهة برمجة التطبيقات) (مثل purchase_units لـ PayPal أو line_items لـ Stripe)
القيمة التي سيتم إدخالها عند إنشاء الدفع

لتعيين القيمة - يجب فتح تحرير المجموعة، بالضغط على الزر . ثم اختر السمة المطلوبة من المجموعة المعدة مسبقًا، وأدخل القيمة المطلوبة، وفقًا لنوع السمة.

⚠️ مهم: يتم إعداد مجموعات السمات ومحتوياتها بشكل منفصل ويمكن أن تشمل حقولًا من أنواع مختلفة: سلسلة، عدد، قيمة منطقية، JSON وغيرها.

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

    {
      "invoice_id": "90210",
      "amount": {
        "currency_code": "USD",
        "value": "230.00",
        "breakdown": {
          "item_total": {
            "currency_code": "USD",
            "value": "220.00"
          },
          "shipping": {
            "currency_code": "USD",
            "value": "10.00"
          }
        }
      },
      "items": [
        {
          "name": "T-Shirt",
          "description": "قميص فائق النضارة",
          "unit_amount": {
            "currency_code": "USD",
            "value": "20.00"
          },
          "quantity": "1",
          "category": "سلع مادية",
          "sku": "sku01",
          "image_url": "https://example.com/static/images/items/1/tshirt_green.jpg",
          "url": "https://example.com/url-to-the-item-being-purchased-1",
          "upc": {
            "type": "UPC-A",
            "code": "123456789012"
          }
        },
        {
          "name": "أحذية",
          "description": "جري، مقاس 10.5",
          "sku": "sku02",
          "unit_amount": {
            "currency_code": "USD",
            "value": "100.00"
          },
          "quantity": "2",
          "category": "سلع مادية",
          "image_url": "https://example.com/static/images/items/1/shoes_running.jpg",
          "url": "https://example.com/url-to-the-item-being-purchased-2",
          "upc": {
            "type": "UPC-A",
            "code": "987654321012"
          }
        }
      ]
}

ثم في إعدادات حساب الدفع، تربط:

المفتاح: purchase_units القيمة: السمة items من مجموعة "وحدة شراء PayPal" عند إنشاء الطلب، ستقوم النظام تلقائيًا بإدخال القيمة الحالية لهذه السمة في جسم الطلب إلى واجهة برمجة تطبيقات PayPal.

المعلمات الأخرى المستخدمة بشكل شائع في PayPal:

intent — مثل "CAPTURE" أو "AUTHORIZE" application_context.return_url — عنوان URL للعودة بعد الدفع الناجح application_context.cancel_url — عنوان URL لإلغاء الدفع

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

إخفاء حساب الدفع

إذا كنت لا ترغب في استخدام حساب الدفع بعد الآن ولا يمكنك حذفه لأنه مستخدم بالفعل في المشروع، يمكنك إخفاؤه.

للقيام بذلك، على الحساب المحدد، اضغط على أيقونة "العين" .

لن يتم عرض حسابات الدفع المخفية من قبل النظام للاختيار عند إعداد تخزين الطلبات.

حذف حساب الدفع

اختر من القائمة حساب الدفع الذي ترغب في حذفه واضغط على أيقونة الحذف .

أكد الإجراء في نافذة الحوار. بعد ذلك، سيتم حذف حساب الدفع وسيختفي من القائمة العامة.

الحسابات

أنواع حسابات الدفع.​

Stripe​

مخصص​

إنشاء حساب دفع​

تعديل حساب الدفع​

المعلمات المخصصة لواجهة برمجة تطبيقات الدفع​

كيف يعمل ذلك​

إخفاء حساب الدفع​

حذف حساب الدفع​