VibeFox Viva Wallet for PrestaShop

نظرة عامة

تضيف VibeFox Viva Wallet Gateway بوابة Viva Wallet (Viva.com) Smart Checkout إلى PrestaShop. في خطوة الدفع يختار العميل Viva Wallet، فيُنقل إلى صفحة الدفع الآمنة لدى Viva، ويدفع بالبطاقة أو عبر Apple Pay أو Google Pay أو بطريقة دفع محلية مفعّلة في حسابك لدى Viva، ثم يعود إلى متجرك. لا تمر بيانات البطاقة عبر موقعك أبدًا. لا يُنشأ الطلب إلا بعد أن تؤكد Viva الدفع، لذلك لا تترك المدفوعات المتروكة طلبات غير مدفوعة.

تناسب الوحدة المتاجر التي لديها حساب تاجر لدى Viva وتفضّل صفحة دفع مستضافة بدلًا من نموذج بطاقة على موقعها الخاص. تقبل الوحدة المدفوعات لمرة واحدة فقط. لا تتضمن التفويض المسبق والتحصيل، أو الدفع بالتقسيط، أو البطاقات المحفوظة، أو الاشتراكات، أو حقول البطاقة في صفحتك الخاصة، أو أجهزة نقاط البيع (POS)، ولا تُستورد الاستردادات التي تُجرى من لوحة تحكم Viva.

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

Smart Checkout: يُنشأ طلب دفع في Viva بإجمالي السلة وبعملة السلة، مع الوحدات الصغرى الصحيحة للعملة.

يُعتمد الدفع فقط عند تأكيد Viva: لا تُوقَّع webhooks الخاصة بـ Viva، لذا تعيد الوحدة قراءة كل معاملة من واجهة Viva API. يجب أن تنتمي المعاملة إلى طلب الدفع في Viva لهذه السلة، وأن تكون مكتملة، وأن تطابق إجمالي السلة وعملتها.

Webhooks وعمليات العودة: يُنشأ الطلب عبر webhook من Viva، أو عندما يعود العميل إلى المتجر. ويُجاب التحقق من عنوان URL الخاص بـ webhook من Viva تلقائيًا باستخدام Merchant ID وAPI Key الخاصين بك.

لا معالجة مزدوجة: لا تُنشئ webhooks وعمليات العودة المتكررة أو المتوازية طلبًا ثانيًا أبدًا، ولا تُسجَّل الدفعة مرتين. ولا يعيد الدفع المتأخر فتح طلب ملغى أو مسترد.

التحقق من المبلغ والعملة: يضع الاختلاف الطلب في حالة Viva Wallet payment on hold للمراجعة، مع ملاحظة توضح السبب.

حسابات تجريبية وحسابات حقيقية: بيانات اعتماد منفصلة لكل منهما. تُتحقَّق المدفوعات التي بدأت بالفعل وتُسترد في الحساب الذي تمت فيه، حتى بعد تبديل Test Mode.

الاسترداد من صفحة الطلب: استرداد كامل أو جزئي في كتلة Viva Wallet payment الخاصة بالطلب، حتى المبلغ الذي حصّلته Viva، ضمن حساب الدفع وعملته. يضع الاسترداد الكامل الطلب في حالة Refunded.

كتلة Viva في صفحة الطلب: المعاملة، ومحاولات الدفع، وسجل الاسترداد، والملاحظات. حالة الطلب التي تختارها بعد الدفع، وسجل لا يتضمن المفاتيح أو بيانات العميل.

المتطلبات

PrestaShop من 8.0 إلى 9.x، وPHP 8.0 أو أحدث. حساب تاجر لدى Viva مع بيانات اعتماد Smart Checkout (Client ID وClient Secret) ومصدر دفع (Source Code). عملة السلة EUR أو GBP أو PLN أو RON أو BGN أو CZK أو HUF أو DKK أو SEK أو NOK أو CHF. ومفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).