بوابة Mollie Terminal
تتيح لك بوابة Mollie Terminal قبول المدفوعات الحضورية على أجهزة Mollie Terminal مباشرةً من WCPOS. تبدأ الدفعة من WooCommerce وتكتمل على الجهاز الطرفي، ويُكتب تأكيد Mollie في الطلب.
الميزات
تكامل الأجهزة
أرسل المدفوعات إلى أجهزة Mollie الطرفية المسجّلة في حساب Mollie لديك واقبل مدفوعات البطاقات الحضورية
بلا إقران يدوي
تُجلب الأجهزة الطرفية مباشرةً من حساب Mollie لديك — اختر واحدًا من قائمة منسدلة، بلا معرّف جهاز تلصقه
إتمام موثوق
تُؤكَّد المدفوعات باستطلاع Mollie، وتنتقل نقطة البيع تلقائيًا إلى الإيصال بمجرد تأكيد الجهاز الطرفي
معاملات آمنة
معالجة حضورية متوافقة مع PCI تجري على أجهزة Mollie
استرداد المبالغ مدعوم
استرد المبالغ من شاشة طلب WooCommerce، مع مطابقتها مع Mollie كي لا تتكرر عمليات الاسترداد أبدًا
كيف تعمل
تستخدم Mollie Terminal مدفوعات pointofsale على جانب خادم Mollie. فعند بدء دفعة، ينشئ WooCommerce دفعة Mollie للطلب وتدفعها Mollie إلى الجهاز الطرفي المحدد. ويدفع العميل على الجهاز، وتكون Mollie هي مصدر الحقيقة لحالة الدفع والاسترداد — أما بيانات طلب WooCommerce المحلية فليست سوى ذاكرة مؤقتة.
كيف تُؤكَّد الدفعة. أثناء تقدّم الدفعة تستطلع نقطة البيع Mollie (كل ثانيتين افتراضيًا)، وعند تأكيد الجهاز الطرفي تنتقل مباشرةً إلى صفحة الشكر. وتُستخدم خطافات ويب Mollie أيضًا لتسريع ذلك — ويُضبط عنوان خطاف الويب تلقائيًا مع كل دفعة، فليس هناك ما يُهيَّأ في لوحة معلومات Mollie.
ويجب أن يكون الجهاز الطرفي مسجَّلًا ونشطًا على حساب Mollie نفسه الذي تستخدمه الإضافة.
الإعداد
تثبيت Mollie Terminal for WooCommerce
ثبّته من WP Admin > POS > Settings > Extensions، أو نزّل أحدث ملف zip الخاص بالإضافة (وليس ملف zip أو tarball الخاص بشفرة GitHub المصدرية) من صفحة إصدارات GitHub وارفعه عبر Plugins > Add New > Upload Plugin.
تهيئة بيانات اعتماد Mollie لديك
- انتقل إلى
WP Admin > WooCommerce > Settings > Paymentsوافتح Mollie Terminal - اضبط الوضع على
Live— إذ تتطلب مدفوعات الأجهزة الطرفية حسابًا مباشرًا (راجع النطاق والقيود) - اضبط مصدر مفتاح API لإعادة استخدام المفتاح من إضافة Mollie Payments for WooCommerce الرسمية، أو استخدم المفتاح المُدخَل في هذه الشاشة
- إذا أدخلت المفتاح هنا، فالصق مفتاح API المباشر الخاص بـ Mollie في Mollie API Key
- احفظ
لا توجد أجهزة Mollie الطرفية إلا على الحسابات المباشرة، لذا لا يستطيع مفتاح API التجريبي تشغيل جهاز طرفي. وتحذّرك شاشة الإعدادات عند اختيار الوضع التجريبي — فبدّل إلى Live مع مفتاح API المباشر لديك لقبول المدفوعات. راجع النطاق والقيود.
لا تتطلب مدفوعات pointofsale معرّف Profile ID في Mollie، كما تُدرَج الأجهزة الطرفية على مستوى الحساب بأكمله، فليس هناك ما يُلصق غير ذلك.
اختيار أجهزتك الطرفية
- اختر الجهاز الطرفي الافتراضي من القائمة المنسدلة. وتُجلب القائمة من بيئة Mollie المحددة — وتُخفى الأجهزة الطرفية غير النشطة، لأن Mollie لا تستطيع إعادة تفعيلها.
- (اختياري) قيّد الأجهزة الطرفية المفعّلة بالأجهزة المستخدمة فعلًا. ويبقى الافتراضي المحفوظ متاحًا حتى لو لم يُحدَّد هنا؛ واترك الإعداد فارغًا للسماح بجميع الأجهزة الطرفية النشطة. ولإحالة جهاز طرفي إلى التقاعد، غيّر أيضًا الجهاز الطرفي الافتراضي أو امسحه.
- (اختياري) فعّل قفل اختيار الجهاز الطرفي كي لا يتمكن أمناء الصندوق من تغيير الجهاز الطرفي عند إتمام الدفع — فيُستخدَم الجهاز الافتراضي دائمًا، وهذا مفروض على الخادم أيضًا.
- احفظ
التمكين في WCPOS
- انتقل إلى
WP Admin > POS > Settings > Checkout - ابحث عن بوابة Mollie Terminal وفعّلها لنقطة البيع
- احفظ إعداداتك
لا يتحكم مربع التفعيل/التعطيل في شاشة إعدادات WooCommerce إلا في إتمام الدفع في المتجر الإلكتروني. أما WCPOS فيستخدم هذه البوابة بمجرد تهيئتها، سواء أكان ذلك المربع محدَّدًا أم لا.
مرجع الإعدادات
| الإعداد | وظيفته |
|---|---|
| التفعيل/التعطيل | يفعّل البوابة لإتمام الدفع في المتجر الإلكتروني (غير مطلوب لنقطة البيع) |
| العنوان / الوصف | التسمية والنص المعروضان للعميل عند إتمام الدفع |
| الوضع | Test أو Live. تتطلب مدفوعات الأجهزة الطرفية الوضع Live — إذ لا يستطيع مفتاح API التجريبي تشغيل جهاز طرفي |
| مصدر مفتاح API | يستخدم المفتاح المُدخَل أدناه، أو يعيد استخدام المفتاح التجريبي/المباشر المطابق من إضافة Mollie Payments for WooCommerce الرسمية. وإذا لم يتوفر المفتاح المشترك، تعود الإضافة إلى المفتاح أدناه |
| Mollie API Key | مفتاح API التجريبي أو المباشر للوضع المحدد. يُستخدَم حين يكون مصدر مفتاح API مضبوطًا على المفتاح المُدخَل هنا، وبوصفه البديل عند غياب المفتاح المشترك |
| الجهاز الطرفي الافتراضي | الجهاز الطرفي المستخدَم افتراضيًا عند إتمام الدفع، ويُختار من قائمة منسدلة بالأجهزة الطرفية النشطة في بيئة Mollie المحددة |
| الأجهزة الطرفية المفعّلة | يقيّد قائمة إتمام الدفع بالأجهزة الطرفية المحددة. والفراغ = جميع الأجهزة الطرفية النشطة. ويبقى الافتراضي المحفوظ متاحًا دائمًا، لذا غيّره أو امسحه أيضًا عند إحالة جهاز طرفي إلى التقاعد |
| قفل اختيار الجهاز الطرفي | يفرض الجهاز الطرفي الافتراضي عند إتمام الدفع كي لا يتمكن أمناء الصندوق من تغييره (يتطلب جهازًا طرفيًا افتراضيًا) |
| سجلات تصحيح إتمام الدفع | تعرض أدوات Show logs وCopy وClear في لوحة الدفع عند إتمام الطلب. اتركها معطّلة إلا عند جمع السجلات للدعم؛ فنشاط الدفع يُسجَّل دائمًا تحت WooCommerce > Status > Logs |
ويُطبَّق عنوان خطاف الويب تلقائيًا مع كل دفعة، فليس هناك حقل خطاف ويب لتعبئته ولا تهيئة مطلوبة في لوحة معلومات Mollie.
الاستخدام
معالجة المدفوعات
- إضافة العناصر: أضف المنتجات إلى سلة التسوق في نقطة البيع
- اختيار البوابة: اختر «Mollie Terminal» كطريقة الدفع
- اختيار الجهاز الطرفي: اختر جهازًا طرفيًا من القائمة المنسدلة (يكون الافتراضي هو المهيَّأ؛ وتُخفى القائمة إذا كان اختيار الجهاز الطرفي مقفلًا)
- بدء الدفع: انقر على بدء دفعة الجهاز الطرفي — فتدفع Mollie الدفعة إلى الجهاز
- دفع العميل: يلمس العميل بطاقته أو يدخلها أو يمررها على الجهاز الطرفي. وتتحدث الحالة مباشرةً —
جارٍ الإرسال إلى الجهاز الطرفي…←في انتظار الجهاز الطرفي… - الإكمال التلقائي: عند تأكيد الجهاز الطرفي، يُوضَع على الطلب علامة مدفوع وتنتقل نقطة البيع تلقائيًا إلى الإيصال
عناصر التحكم في الدفع
- بدء دفعة الجهاز الطرفي: إرسال طلب دفع جديد إلى الجهاز الطرفي المحدد
- إلغاء الدفع: إلغاء دفعة لا تزال مفتوحة. وبمجرد وصول الدفعة إلى الجهاز الطرفي تبلّغ Mollie بأنها لم تعد قابلة للإلغاء، فيلغيها أمين الصندوق على الجهاز نفسه
إدارة الطلبات
- إتمام مُتحقَّق منه: كل خطاف ويب واستطلاع وإلغاء وإعادة محاولة يجلب حالة Mollie الموثوقة قبل تغيير أي طلب، فلا توضع علامة مدفوع على الطلبات إلا بناءً على حالة Mollie المؤكدة
- تتبع الدفع: تُسجَّل محاولات الدفع بوصفها سجلًا تاريخيًا يُضاف إليه فقط على الطلب
- إنشاء الإيصال: تُنشَأ إيصالات نقطة البيع القياسية بعد نجاح عمليات الدفع
استرداد المبالغ
استرداد المبالغ مدعوم. استرد مبلغ طلب من شاشة طلب WooCommerce المعتادة فيُرسَل الاسترداد إلى Mollie. ولأن Mollie هي مصدر الحقيقة، فإن محاولات الاسترداد المتكررة تُطابَق مع معرّفات استرداد Mollie وبياناتها الوصفية قبل إنشاء استرداد آخر، فلا يُصدر استرداد مرتين بالخطأ أبدًا.
تنظيف المدفوعات القديمة
قد تبقى دفعة pointofsale في Mollie «مفتوحة» على جانب Mollie إذا هُجر إتمام الدفع. وتلغي الإضافة هذه المدفوعات المفتوحة تلقائيًا حين:
- تنتهي مهلة الاستطلاع التلقائي (5 دقائق افتراضيًا) — فيُرسَل الإلغاء بدلًا من ترك الدفعة خلفه
- يكتمل الطلب بطريقة دفع مختلفة (على سبيل المثال يدفع العميل نقدًا بدلًا من ذلك)، أو يُلغى الطلب في WooCommerce
- تُغلق صفحة إتمام الدفع في منتصف الدفعة — فيُطلق إلغاء بأفضل جهد ممكن عند مغادرة علامة التبويب
- تعمل جولة WP-Cron كل 10 دقائق فتلغي أو تحسم المدفوعات التي بقيت مفتوحة بعد عتبة التقادم (10 دقائق افتراضيًا)، بما في ذلك حين يُغلق المتصفح أو ينقطع الاتصال قبل تشغيل مسارات التنظيف الأخرى
وإذا كانت الدفعة قد وصلت إلى الجهاز الطرفي سلفًا، تبلّغ Mollie بأنها غير قابلة للإلغاء فيلغيها أمين الصندوق على الجهاز نفسه — وتكون عمليات التنظيف هذه بلا أثر وآمنة في تلك الحالة.
المتطلبات
النطاق والقيود
لا توجد أجهزة Mollie الطرفية إلا على الحسابات المباشرة. ولا يستطيع مفتاح API التجريبي في Mollie تشغيل جهاز طرفي فعلي (أو على iOS/Android)، لذا يتعذّر اختبار مدفوعات الأجهزة الطرفية من طرف إلى طرف في الوضع التجريبي. وهذا قيد في منصة Mollie لا تقييد من الإضافة — وتعرض شاشة الإعدادات تحذيرًا عند اختيار الوضع التجريبي. فاستخدم الوضع Live مع مفتاح API المباشر لديك لقبول مدفوعات الأجهزة الطرفية.
تقتصر مدفوعات الأجهزة الطرفية في نقطة البيع على اليورو (EUR) إلى أن يتأكد دعم Mollie Terminal لعملات أوسع.
استكشاف الأخطاء وإصلاحها
المشكلات الشائعة
لا تظهر أي أجهزة طرفية في القائمة المنسدلة
- تأكد من ضبط الوضع على
Liveوأن مفتاح API الفعّال مفتاح مباشر — فالأجهزة الطرفية لا توجد على الحسابات التجريبية - تحقق من أن الجهاز الطرفي مسجَّل ونشط على حساب Mollie لديك؛ فالأجهزة الطرفية غير النشطة تُخفى لأن Mollie لا تستطيع إعادة تفعيلها
- تأكد من قدرة موقعك على الوصول إلى Mollie — فالقائمة تُجلب مباشرةً عبر API
الدفعة لا تبدأ
- تأكد من تحديد جهاز طرفي (أو من ضبط جهاز طرفي افتراضي حين يكون الاختيار مقفلًا)
- تحقق من أن الجهاز الطرفي قيد التشغيل ومتصل ونشط على حساب Mollie نفسه
- تحقق من أن عملة الطلب هي اليورو (EUR)
انتهت مهلة الجهاز الطرفي أو بقيت الدفعة مفتوحة
- تحاول الإضافة إلغاء المدفوعات المفتوحة تلقائيًا عند انتهاء المهلة (5 دقائق افتراضيًا)
- وإذا كانت الدفعة قد وصلت إلى الجهاز الطرفي سلفًا وتعذّر إلغاؤها تلقائيًا، فألغِها على الجهاز نفسه
- ويمكنك عندئذٍ بدء دفعة جديدة أو قبول الدفع بطريقة أخرى
اكتمل الطلب على الجهاز الطرفي لكنه بطيء في التحديث
- تستطلع نقطة البيع Mollie كل ثانيتين وتنتقل عند تأكيد الدفعة؛ وعادةً ما يؤكدها خطاف ويب أولًا
- ولأن Mollie هي مصدر الحقيقة، تُطابَق حالة الطلب مع حالة Mollie الموثوقة — فهو ليس مفقودًا
- راجع
WooCommerce > Status > Logsبحثًا عن أي رسائل من واجهة Mollie البرمجية
الحصول على المساعدة
للدعم الفني:
- تفضل بزيارة مستودع GitHub للإبلاغ عن المشكلات
- راجع دليل إعداد Mollie Terminal وواجهة Mollie لإنشاء المدفوعات للأسئلة المتعلقة بـ API
- اتصل بدعم Mollie لمشكلات الحساب والأجهزة
لقطات الشاشة
ستتم إضافة لقطات الشاشة في تحديث مستقبلي لعرض:
- شاشة إعدادات Mollie Terminal — مفتاح API، والجهاز الطرفي الافتراضي، والأجهزة الطرفية المفعّلة
- تفعيل البوابة في إعدادات WCPOS
- سير عمل معالجة الدفع عند إتمام الدفع في نقطة البيع