انتقل إلى المحتوى الرئيسي

الحسابات

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

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

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

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

Stripe​

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

Midtrans​

تدعم منصة OneEntry التكامل مع نظام الدفع الإندونيسي Midtrans. لمزيد من التفاصيل حول ربط Midtrans، يمكنك الاطلاع على هنا.

Xendit​

تدعم منصة OneEntry التكامل مع نظام الدفع Xendit. لمزيد من التفاصيل حول ربط Xendit، يمكنك الاطلاع على هنا.

مخصص​

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

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

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

  • الاسم - سلسلة غير فريدة
  • النوع - قيمة من القائمة المنسدلة. يمكن إنشاء حسابات من الأنواع Stripe وMidtrans وXendit واحدة فقط لكل مشروع؛ بينما يمكن أن يكون هناك عدد غير محدود من الحسابات من النوع المخصص.
  • العلامة - سلسلة فريدة.

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

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

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

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

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

تحتوي حسابات Stripe وMidtrans وXendit في وضع التعديل أيضًا على إعدادات الاتصال بنظام الدفع. تم وصفها في صفحات Stripe، Midtrans وXendit.

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

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

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

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

كيف يعمل ذلك​

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

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

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

⚠️ مهم: يتم إعداد مجموعات السمات ومحتوياتها بشكل منفصل ويمكن أن تشمل حقولًا من أنواع مختلفة: سلسلة، عدد، قيمة منطقية، 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 لإلغاء الدفع

تتيح هذه الآلية تكييف تكاملات الدفع وفقًا لمتطلبات واجهات برمجة التطبيقات الخارجية.

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

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

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

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

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

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

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