VibeFox 2C2P for PrestaShop

نظرة عامة

تضيف وحدة VibeFox 2C2P Payment المدفوعات عبر 2C2P، وهي منصة دفع تعمل في جنوب شرق آسيا وأسواق أخرى، إلى PrestaShop. في خطوة الدفع يختار العميل 2C2P ويُنقل إلى صفحة الدفع الخاصة بـ 2C2P ويدفع هناك بأي طريقة مفعّلة في حساب التاجر لديك لدى 2C2P: البطاقات، والمحافظ الإلكترونية، ومدفوعات QR، والتحويل المصرفي عبر الإنترنت، أو المدفوعات النقدية في نقاط البيع. لا تمر بيانات البطاقة عبر موقعك أبدًا. لا يُنشأ الطلب إلا بعد أن تُبلغ 2C2P بالنتيجة، لذلك لا تترك المدفوعات المتروكة طلبات غير مدفوعة.

تناسب المتاجر في جنوب شرق آسيا التي لديها حساب تاجر لدى 2C2P وتريد دفعًا بسيطًا عبر التحويل إلى صفحة الدفع، دون نموذج بطاقة في موقعها. تُحدَّد طرق الدفع المعروضة في حسابك لدى 2C2P، لا في الوحدة. لا تدعم الوحدة الاسترداد من PrestaShop (يُنفَّذ الاسترداد من بوابة التاجر في 2C2P)، ولا حفظ البطاقات، ولا المدفوعات المتكررة، ولا حقول البطاقات في موقعك.

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

صفحة الدفع الخاصة بـ 2C2P: تستخدم واجهة 2C2P Redirect API. تُرسل عناوين العودة والإشعار مع كل دفعة، فلا حاجة إلى أي إعداد في بوابة 2C2P.

الدفع يُعتمد فقط عند تأكيد 2C2P: تُبلغ 2C2P بالنتيجة عبر عودة العميل وعبر إشعار من الخادم إلى الخادم. يُتحقق من الاثنين بتوقيع HMAC الخاص بوضع الدفع، ولا تغيّر النتائج غير الموقّعة أو المعدّلة أي طلب أبدًا.

التحقق من المبلغ والعملة: يُقارَن المبلغ المدفوع والعملة بسلة الشراء. وعند عدم التطابق ينتقل الطلب إلى 2C2P payment on hold مع ملاحظة.

لا معالجة مزدوجة: النتائج المكررة أو المتزامنة لا تنشئ طلبًا ثانيًا ولا تسجّل الدفعة مرتين. ولا تُخفِّض نتيجة فشل لاحقة طلبًا مدفوعًا.

المدفوعات المعلّقة: المدفوعات النقدية وغيرها من المدفوعات المؤجلة تنشئ الطلب بحالة Awaiting 2C2P payment حتى تُبلغ 2C2P بالدفع.

وضعا بيئة الاختبار (sandbox) والإنتاج: لكل وضع Merchant ID ومفتاح Secret Key منفصلان. واجهة Redirect API 8.5 (HMAC-SHA256)، أو الإصدار القديم 7.0 (HMAC-SHA1) للحسابات الأقدم.

لغة صفحة الدفع وبادئة رقم الطلب: الإنجليزية أو التايلندية أو اليابانية أو الإندونيسية أو البورمية أو الصينية المبسطة. وبادئة اختيارية عندما تشارك عدة متاجر حسابًا واحدًا لدى 2C2P.

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

المتطلبات

PrestaShop من الإصدار 8.0 إلى 9.x، وPHP 8.0 أو أحدث. حساب تاجر لدى 2C2P مع Merchant ID ومفتاح Secret Key. عملة سلة شراء تدعمها الوحدة ومفعّلة في حسابك لدى 2C2P. ومفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).