VibeFox Razorpay for PrestaShop

نظرة عامة

تضيف VibeFox Razorpay Payment المدفوعات عبر Razorpay إلى PrestaShop. يدفع العميل في نافذة Razorpay Checkout المنبثقة التي تُفتح في صفحة دفع في متجرك. تعرض النافذة طرق الدفع المفعّلة في حساب Razorpay الخاص بك، مثل UPI وبطاقات الائتمان والخصم وNetBanking والمحافظ الإلكترونية. تُدخل بيانات البطاقة والحساب البنكي في نافذة Razorpay، وليس في موقعك. لا يُنشأ الطلب إلا بعد أن تؤكد Razorpay الدفعة، لذلك لا تترك المدفوعات المتروكة أي طلبات غير مدفوعة.

تناسب المتاجر في الهند وغيرها من المتاجر التي لديها حساب Razorpay وتريد تقديم UPI وطرق الدفع المحلية. تتطلب العملات غير الروبية الهندية (INR) تفعيل International Payments في حساب Razorpay الخاص بك. تقبل الوحدة المدفوعات لمرة واحدة فقط. لا تتضمن الاشتراكات، ولا البطاقات المحفوظة، ولا Razorpay Magic Checkout، ولا Payment Links، ولا Route (المدفوعات المقسّمة)، ولا أدوات عروض الأسعار.

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

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

Webhook: تؤكد webhooks الموقّعة المدفوعات حتى لو أغلق العميل المتصفح مباشرةً بعد الدفع. وتُرفض webhooks التي لا تحمل توقيعًا صالحًا.

لا دفع مزدوج: إذا كانت السلة مدفوعة بالفعل عبر Razorpay، تجد الوحدة الدفعة ولا تطلب دفعة ثانية. ولا تُنشئ عمليات الاستدعاء المتكررة وwebhooks أي طلب ثانٍ أبدًا.

Authorize & Capture أو Authorize Only: خصم المبلغ فورًا، أو حجزه وتحصيله لاحقًا بـ Capture Razorpay payment في صفحة الطلب.

الاسترداد من صفحة الطلب: استرداد كامل أو جزئي في كتلة Razorpay payment الخاصة بالطلب، حتى المبلغ الذي خصمته Razorpay فعليًا. وتُسجَّل في الطلب الاستردادات التي تُجرى من Razorpay Dashboard.

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

مبالغ صحيحة لكل عملة: تُرسل العملات ذات الخانتين العشريتين، والعملات بلا منازل عشرية (JPY وKRW وغيرهما)، والعملات ذات الثلاث منازل عشرية (KWD وBHD وOMR) بالطريقة التي يتوقعها Razorpay.

كتلة Razorpay في صفحة الطلب: معرّف الدفعة وسجل الاستردادات والملاحظات. وسجل لا يتضمن المفاتيح ولا بيانات الاتصال بالعميل.

المتطلبات

PrestaShop من 8.0 إلى 9.x، وPHP 8.0 أو أحدث. حساب Razorpay مع Key ID وKey Secret، وwebhook (يُوصى به). ومفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).