VibeFox Omise for PrestaShop

نظرة عامة

تضيف VibeFox Omise Payment إلى PrestaShop مدفوعات البطاقات Visa وMastercard وJCB عبر Omise (Opn Payments). يُدخل العميل بيانات بطاقته في نموذج موجود في خطوة الدفع من صفحة الدفع. يرسل Omise.js بيانات البطاقة من المتصفح مباشرةً إلى Omise، ولا يستلم متجرك سوى رمز دفع لمرة واحدة، ثم يُنشأ الخصم على الخادم. تتم معالجة 3-D Secure عبر توجيه العميل إلى البنك ثم إعادته إلى المتجر. لا يُنشأ الطلب إلا بعد رد Omise، لذلك لا تترك البطاقة المرفوضة أي طلبات فاشلة.

تناسب المتاجر في تايلاند واليابان وسنغافورة وماليزيا وغيرها من الأسواق التي تخدمها Omise، والتي تريد مدفوعات البطاقات مع خيار التحصيل اليدوي والاسترداد من صفحة طلبات PrestaShop. تقبل الوحدة البطاقات فقط. ولا تتضمن PromptPay وTrueMoney والخدمات المصرفية عبر الهاتف والتقسيط وغيرها من طرق الدفع في Omise، ولا البطاقات المحفوظة أو الاشتراكات، ولا التحصيل الجزئي.

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

نموذج البطاقة مع Omise.js: الاسم على البطاقة ورقمها وتاريخ انتهائها ورمز الأمان في خطوة الدفع. لا تُرسل حقول البطاقة إلى متجرك أبدًا.

الدفع يُعتمد فقط عند تأكيد Omise: تُقرأ الرسوم دائمًا من واجهة Omise البرمجية، وتُقارن قيمتها وعملتها بالسلة. وعند عدم التطابق ينتقل الطلب إلى Omise payment on hold مع ملاحظة.

3-D Secure والـ webhook: ينشئ الـ webhook الطلب عندما لا يعود العميل من 3-D Secure، ويلتقط عمليات التحصيل التي تتم في لوحة تحكم Omise. ولا يُوثق بمحتواه أبدًا.

التحصيل الفوري أو التفويض فقط: تبقى الطلبات المفوَّضة في Omise payment authorized حتى تنقر Capture payment أو Void authorization في كتلة Omise الخاصة بالطلب.

بلا خصومات مكررة: لا يؤدي تكرار الـ webhook والعودة أبدًا إلى إنشاء طلب ثانٍ أو تسجيل الدفع مرتين. تُكمل المحاولة المعادة الطلب بخصم مدفوع سابق، وتنتهي صلاحية محاولة 3-D Secure غير المكتملة قبل أي خصم جديد.

الاسترداد من صفحة الطلب: استرداد كامل أو جزئي بالمبلغ والعملة اللذين حصّلهما Omise، مع سجل للاستردادات. ويؤدي الاسترداد الكامل لتفويض لم يُحصَّل إلى إلغائه.

وضعا الاختبار والإنتاج: مفاتيح منفصلة. تستخدم عمليات التحصيل والاستردادات وفحوص الحالة دائمًا مفاتيح الوضع الذي دُفع فيه الطلب. يعيد Sync payment status قراءة الخصم عند الطلب.

13 عملة: THB وJPY وSGD وMYR وUSD وEUR وGBP وAUD وCAD وCHF وCNY وDKK وHKD، وJPY بلا منازل عشرية. سجل اختياري لا يتضمن المفاتيح ولا الرموز ولا بيانات البطاقة.

المتطلبات

PrestaShop من 8.0 إلى 9.x، وPHP 8.0 أو أحدث. حساب Omise بمفتاح عام ومفتاح سري لوضعي الاختبار والإنتاج، وwebhook في لوحة تحكم Omise (HTTPS). مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).