VibeFox IntaSend for OpenCart

نظرة عامة

تضيف VibeFox IntaSend Pay Gateway مدفوعات IntaSend إلى OpenCart 3 وOpenCart 4 للمتاجر في كينيا وشرق أفريقيا. في خطوة الدفع الأخيرة ينقر العميل على Confirm Order، فينتقل إلى صفحة الدفع المستضافة من IntaSend، ويدفع عبر M-Pesa أو البطاقة أو أي طريقة أخرى مفعّلة في حسابك لدى IntaSend، ثم يعود إلى متجرك. ينشئ OpenCart الطلب قبل الدفع، لكن الطلب لا يحصل على حالة إلا بعد أن تؤكد IntaSend الدفع، لذلك تبقى المحاولات غير المدفوعة طلبات مفقودة.

تناسب المتاجر التي تريد قبول M-Pesa والبطاقات عبر حساب IntaSend دون وجود نموذج دفع على موقعها. تقبل الإضافة مدفوعات الدفعة الواحدة فقط. لا تُرسل المبالغ المستردة من المتجر إلى IntaSend، ولا تتضمن الإضافة بطاقات محفوظة أو اشتراكات أو نموذج دفع مضمّن (منبثق).

الميزات الرئيسية

صفحة الدفع المستضافة من IntaSend: دفعة واحدة لإجمالي الطلب بعملة الطلب. العملات المدعومة: KES وUSD وEUR وGBP وUGX وTZS وNGN وGHS وXAF وXOF. تُرسل UGX وXAF وXOF بدون منازل عشرية.

مدفوع فقط عند تأكيد IntaSend: لا تُحدَّد حالة الطلب إلا بعد أن يستعلم خادمك من واجهة Payment Status API لدى IntaSend باستخدام مفتاحك السري. لا يُوثق بأي شيء يرسله المتصفح أو يرد في نص Webhook. ثم يرسل OpenCart رسائل الطلب المعتادة.

Webhook مع عبارة تحقق: تُؤكَّد المدفوعات حتى عندما يغلق العميل المتصفح أو تؤكد M-Pesa الدفع لاحقًا. تُرفض طلبات Webhook التي تحمل عبارة تحقق خاطئة.

فحص المبلغ والعملة: يُقارن المبلغ والعملة اللذان تبلغ عنهما IntaSend بالطلب. وعند وجود اختلاف أو دفعة جزئية ينتقل الطلب إلى حالة مراجعة مع ملاحظة.

منع المعالجة المزدوجة: تُطبَّق الدفعة مرة واحدة فقط، حتى عندما تصل عودة العميل وطلب Webhook في اللحظة نفسها. تُدفع سلة واحدة مرة واحدة، وتُعلَّم الدفعة الثانية بملاحظة.

وضعا الاختبار (Sandbox) والتشغيل المباشر: أزواج مفاتيح منفصلة لكل وضع. يُخفى أسلوب الدفع ما دامت مفاتيح الوضع الحالي مفقودة أو تنتمي إلى الوضع الآخر. تُفحص المدفوعات السابقة دائمًا في الوضع الذي أُجريت فيه.

رسائل واضحة: رسالة بعد دفعة فاشلة أو متروكة، وصفحة «قيد التأكيد» بزر Check again ما دامت M-Pesa تؤكد الدفع.

شروط OpenCart وتبويب الطلب: المنطقة الجغرافية، والحد الأدنى لإجمالي الطلب، وترتيب العرض، وحالات الطلب الخاصة بك. تحتوي صفحة الطلب على تبويب يعرض محاولات الدفع وفواتير IntaSend. لا يتضمن السجل مفاتيح ولا بيانات العملاء.

المتطلبات

OpenCart 3.0.x (تم الاختبار على 3.0.5.0) أو OpenCart 4.0.2 والإصدارات الأحدث (تم الاختبار على 4.1.0.3)، وPHP 8.0 أو أحدث مع cURL. يحتوي التنزيل الواحد على حزم الإصدارين. حساب IntaSend يحتوي على مفتاح API قابل للنشر ومفتاح API سري، وWebhook مع عبارة تحقق. HTTPS للمدفوعات المباشرة. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).