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

الحسابات

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

تجد أدوات العمل مع الحسابات في القسم الفرعي "Accounts" ضمن قسم "Payments". تظهر حسابات الدفع التي أُنشئت مسبقًا في القائمة العامة، وتحتها نموذج إنشاء حسابات دفع جديدة.

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

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

Stripe​

تدعم منصة OneEntry التكامل مع نظام الدفع Stripe. اختر هذا النوع إذا أردت ربط نظام الدفع Stripe بمشروعك. يُشرح ربط Stripe بمنصة OneEntry بالتفصيل هنا. (يفتح في علامة تبويب جديدة)

Midtrans​

تدعم منصة OneEntry التكامل مع نظام الدفع الإندونيسي Midtrans. يُشرح ربط Midtrans بالتفصيل هنا. (يفتح في علامة تبويب جديدة)

Xendit​

تدعم منصة OneEntry التكامل مع نظام الدفع Xendit. يُشرح ربط Xendit بالتفصيل هنا. (يفتح في علامة تبويب جديدة)

Custom​

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

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

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

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

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

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

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

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

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

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

تحتوي شاشة التحرير أيضًا على جدول سجل إصدارات الحساب (الأعمدة Version وWho made the change وDate وSaved data، وأيقونة Restore Data في صف الإصدار؛ وما دامت لم تُجرَ أي عملية حفظ، تظهر عبارة «No data available» بدلًا من الجدول). يمكنك من خلاله الاطلاع على عمليات الحفظ السابقة واستعادة ما تحتاجه منها. التفاصيل في قسم سجل الإصدارات.

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

Custom parameters for payment API​

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

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

كيف يعمل ذلك​

إلى جانب الحقول الأساسية (الاسم، النوع، العلامة)، يظهر في حسابات الأنواع Stripe وMidtrans وXendit جدول Custom parameters for payment API. أما حسابات النوع Custom فلا تحتوي على هذا الجدول. يعرض الجدول مجموعات السمات من قسم Settings → Attributes، ويتيح لك تحديد المطابقة بين:

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

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

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

مثال على الاستخدام مع PayPal لنفترض أنك تريد تمرير تفاصيل الطلب إلى PayPal عبر الحقل purchase_units. تنشئ مجموعة سمات باسم «PayPal Purchase Unit»، وتضيف إليها السمة 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": "Super Fresh Shirt",
          "unit_amount": {
            "currency_code": "USD",
            "value": "20.00"
          },
          "quantity": "1",
          "category": "PHYSICAL_GOODS",
          "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": "Shoes",
          "description": "Running, Size 10.5",
          "sku": "sku02",
          "unit_amount": {
            "currency_code": "USD",
            "value": "100.00"
          },
          "quantity": "2",
          "category": "PHYSICAL_GOODS",
          "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 Purchase Unit» عند إنشاء الطلب، يُدرج النظام تلقائيًا القيمة الحالية لهذه السمة في نص الطلب المُرسل إلى PayPal API.

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

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

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

تصدير بيانات حساب الدفع​

إلى جانب أزرار الإخفاء والتعديل والحذف، يحتوي صف الحساب على زر لتصدير البيانات (تلميحه في الإصدار الحالي هو "Settings"). يفتح الزر نافذة التصدير: اختر صيغة الملف (csv أو xml) وأكّد التصدير، فيُنزَّل الملف عبر المتصفح. يتاح الزر للمسؤول الذي يملك صلاحية التصدير في وحدة المدفوعات.

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

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

للقيام بذلك، انقر على أيقونة "العين" إخفاء في الحساب المطلوب.

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

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

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

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

آخر تحديث في