شارك المقالة
دمج أجهزة Hala POS مع Android: إعداد SDK وتدفق الدفع

دمج أجهزة Hala POS مع Android: إعداد SDK وتدفق الدفع

دمج Hala POS مع Android يحتاج SDK ووثائق التكامل المعتمدة من المزود. هذا الدليل يشرح إعداد AAR وتدفق الطلب والمصالحة…

دمج Hala POS مع Android يحتاج SDK ووثائق التكامل المعتمدة من المزود. هذا الدليل يشرح إعداد AAR وتدفق الطلب والمصالحة دون افتراض واجهة دفع غير موثقة.

احصل على عقد التكامل الصحيح

اطلب من فريق Hala ملف SDK المعتمد وإصداره ووثائق package وواجهات الطلب والنتيجة ومتطلبات الجهاز وبيئة sandbox. لا توجد في هذا الشرح واجهة عامة موثقة تسمح باختراع أسماء دوال أو أصناف. أسماء com.example وأرقام العمليات التجريبية ليست بيانات إنتاج، ولا يصح عرضها على أنها إعداد جاهز لجميع أجهزة Hala.

إضافة مكتبة AAR إلى المشروع

تحقق من مصدر الملف وتوافقه مع إصدار Android وminSdk ومتطلبات ProGuard أو R8 التي يحددها المزود. امتداد مكتبة Android هو .aar وليس .arr. يمكن اعتماد ملف محلي كما في مثال Gradle أدناه بعد وضع الملف الموافق داخل app/libs. غيّر الاسم إلى الملف الذي استلمته فعليًا، ولا تضف صلاحيات أو repositories عشوائية لتجاوز فشل البناء.

صمّم طلب الدفع كعملية مستقلة

ابدأ الدفع من إجراء صريح للمستخدم بعد عرض المبلغ والعملة والتأكيد المناسبين. لا تبدأ الشراء تلقائيًا داخل onCreate لأن إعادة إنشاء Activity قد تكرر العملية. احفظ معرّف طلب فريدًا وحالة العملية قبل إطلاق واجهة الدفع، وطبّق آلية منع التكرار التي يوفرها المزود. حوّل المبلغ وفق وحدة العملة الموثقة، دون تقريب عشوائي للأرقام العشرية.

النتيجة قد تكون غير متزامنة

استخدم callback أو Activity Result أو طريقة الإشعار التي تنص عليها وثائق SDK، ولا تفترض أن قراءة النتيجة فور إرسال الطلب تعيد القرار النهائي. افصل النجاح والرفض والإلغاء والحالة المعلقة وغير المعروفة. انقطاع الاتصال لا يثبت فشل الدفع؛ استعلم عن حالة المعاملة وأجرِ المصالحة قبل محاولة جديدة. لا تمسح سجل الطلب قبل إتمام التحقق وحفظ النتيجة.

الاسترداد والسجلات واختبارات القبول

الاسترداد عملية منفصلة تتطلب صلاحية وربطًا بمعاملة أصلية بحسب المزود، وليس كلمة مرور ثابتة مثل 123456. لا تسجل أرقام البطاقات أو PIN أو أسرار الجهاز. اختبر في sandbox النجاح والرفض وإعادة تشغيل التطبيق وانقطاع الشبكة ووصول النتيجة مرتين. المثال التالي يوضح إضافة مكتبة فقط؛ لا ينفذ دفعًا ولا يثبت التوافق مع جهاز فعلي.

مثال للتطبيق

// app/build.gradle.kts — غيّر الاسم إلى ملف SDK المعتمد
 dependencies {
     implementation(files("libs/vendor-sdk.aar"))
 }

المرجع الرسمي

للتفاصيل الخاصة بإصدار الأداة وبيئة التشغيل، راجع توثيق دمج Hala POS مع Android. قد تختلف أسماء القوائم بين الإصدارات؛ طابق الإعداد مع مشروعك قبل تطبيقه.

الصور والفيديو من الشرح السابق

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

كيفية ربط Hala POS في مشروع أندرويد خطوة بخطوة
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع