تجاوز إلى المحتوى الرئيسي
الإصدار: 1.x

بوابة Vipps MobilePay

تتيح لك بوابة Vipps MobilePay قبول المدفوعات الهاتفية مباشرة داخل WCPOS. يقوم العملاء بالدفع عن طريق مسح رمز QR على الشاشة أو تأكيد إشعار الدفع على هواتفهم - بدون الحاجة إلى أجهزة قراءة بطاقات.

الميزات

مدفوعات رمز QR

عرض رمز QR عند الدفع ل scan العملاء والدفع من خلال هواتفهم

الإشعارات الدفعية

إرسال طلب الدفع مباشرة إلى هاتف العميل بإدخال رقمهم

التغطية الاسكندنافية

يعمل مع Vipps في النرويج و MobilePay في الدنمارك وفنلندا

التقاط تلقائي

التقاط الأموال على الفور بعد المصادقة، أو الاحتفاظ بها للاستخدام اليدوي

التثبيت

1

تحميل وتثبيت

  1. زيارة صفحة إصدارات WCPOS Vipps MobilePay
  2. تحميل ملف wcpos-vipps.zip الأحدث
  3. في لوحة إدارة ووردبريس، انتقل إلى الإضافات > إضافة جديدة > تحميل الإضافة
  4. تحميل ملف zip وتفعيل الإضافة
2

تكوين بيانات اعتماد Vipps

  1. الانتقال إلى WP Admin > ووCommerce > الإعدادات > المدفوعات
  2. العثور على WCPOS Vipps MobilePay في قائمة طرق الدفع
  3. النقر على WCPOS Vipps MobilePay للوصول إلى الإعدادات
  4. إدخال بيانات الاعتماد الخاصة بك من بوابة Vipps:
    • رقم تسلسلي للتاجر (MSN)
    • معرف العميل
    • سر العميل
    • مفتاح الاشتراك
  5. حفظ الإعدادات
ملاحظة

لا تحتاج إلى تفعيل البوابة هنا للاستخدام في نقطة البيع - سيتم تفعيلها بشكل خاص لنقطة البيع في الخطوة التالية. تفعيلها في إعدادات WooCommerce سيجعلها متاحة أيضًا في صفحة الدفع لمتجرك عبر الإنترنت، وهو ما يمكن أن يكون مفيدًا للاختبار.

هل تستخدم بالفعل إضافة Vipps؟

إذا كانت لديك الإضافة الرسمية الدفع بواسطة Vipps MobilePay مثبتة، فسيتم استيراد بيانات الاعتماد الخاصة بك تلقائيًا عند تفعيل هذه الإضافة. يمكنك تخطي إدخال بيانات الاعتماد يدويًا.

3

تفعيل في WCPOS

  1. الانتقال إلى WP Admin > POS > الإعدادات > الدفع
  2. العثور على بوابة WCPOS Vipps MobilePay في القائمة
  3. تفعيل البوابة للاستخدام في نقطة البيع
  4. حفظ إعداداتك

الاستخدام

معالجة المدفوعات - رمز QR

  1. إضافة العناصر: إضافة منتجات إلى سلة التسوق الخاصة بك في نقطة البيع
  2. اختيار البوابة: اختيار "Vipps MobilePay" كطريقة للدفع
  3. توليد رمز QR: النقر على زر "توليد رمز QR"
  4. يتم مسح رمز QR من قبل العميل: يقوم العميل بمسح رمز QR من خلال تطبيق Vipps أو MobilePay الخاص بهم
  5. تأكيد العميل: يؤكد العميل الدفع في تطبيقه
  6. الاكتمال التلقائي: يتم إكمال الطلب تلقائيًا بمجرد تفويض الدفع

معالجة المدفوعات - إرسال إلى الهاتف

  1. إضافة العناصر: إضافة منتجات إلى سلة التسوق الخاصة بك في نقطة البيع
  2. اختيار البوابة: اختيار "Vipps MobilePay" كطريقة للدفع
  3. إدخال رقم الهاتف: كتابة رقم هاتف العميل
  4. إرسال إلى الهاتف: النقر على زر "إرسال إلى الهاتف"
  5. تأكيد العميل: يتلقى العميل إشعار دفع أو يتم توجيهه إلى صفحة هبوط Vipps، ثم يؤكد الدفع في تطبيقه
  6. الاكتمال التلقائي: يتم إكمال الطلب تلقائيًا بمجرد تفويض الدفع

تكتشف الإضافة تلقائيًا أفضل طريقة لإرسال طلب الدفع إلى هاتف العميل:

  • الدفع الفوري (المفضل) - يرسل إشعارًا مباشرة إلى تطبيق Vipps الخاص بالعميل. هذه هي أسرع تجربة ولكن تتطلب من Vipps تفعيل PUSH_MESSAGE على وحدة البيع الخاصة بك (راجع تمكين الدفع الفوري أدناه).
  • استرجاع صفحة الهبوط - إذا لم يتم تمكين الدفع الفوري، تفتح الإضافة صفحة الهبوط الخاصة بـ Vipps في علامة تبويب متصفح جديدة. تتولى صفحة الهبوط معالجة إرسال الإشعار. يعمل هذا على الفور دون الحاجة إلى موافقة خاصة.

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

تمكين الدفع الفوري

تقدم عملية الدفع الفوري أفضل تجربة للمدفوعات الهاتفية - بدون علامات تبويب إضافية، بدون صفحات هبوط. لتمكينه:

  1. تسجيل الدخول إلى portal.vippsmobilepay.com
  2. الاتصال بمدير حسابك الرئيسي في Vipps، أو مدير الشركاء، أو خدمة العملاء
  3. أخبرهم: "أحتاج تمكين PUSH_MESSAGE على رقم MSN الخاص بي للاستخدام مع تكامل نقطة البيع"

بمجرد الموافقة، ستكتشف الإضافة التغيير تلقائيًا خلال 24 ساعة وتنتقل إلى تدفق الدفع الفوري. سترى إشعارًا تذكيريًا على صفحة إعدادات البوابة أثناء استخدامك لاسترجاع صفحة الهبوط.

إلغاء الدفع

أثناء انتظار تأكيد العميل، يمكنك النقر على زر إلغاء الدفع لإلغاء المعاملة. سيلغي هذا الدفع المعلق على جانب Vipps ويعيد تعيين واجهة الدفع.

استرداد الأموال

يتم التعامل مع استرداد الأموال من خلال عملية استرداد WooCommerce القياسية. افتح الطلب، انقر على استرداد، وادخل المبلغ، ويتم معالجة الاسترداد تلقائيًا من خلال واجهة برمجة التطبيقات Vipps.

الأسواق المدعومة

يعمل Vipps MobilePay عبر المنطقة الاسكندنافية تحت علامتين تجاريتين:

المنطقةالعلامة التجاريةالعملات
النرويجVippsNOK
الدنمارك، فنلنداMobilePayDKK، EUR

تحدد حساب التاجر الخاص بك الأسواق والعملات المتاحة. يمكن للعملاء في أي سوق مدعوم الدفع باستخدام تطبيق Vipps أو MobilePay المحلي الخاص بهم.

المتطلبات

حساب Vipps: حساب تاجر Vipps MobilePay نشط مع بيانات اعتماد API
بيانات اعتماد API: رقم تسلسلي للتاجر، معرف العميل، سر العميل، ومفتاح الاشتراك
WCPOS: الإصدار الاحترافي مطلوب للدفع بنقطة البيع. تعمل البوابة أيضًا على طريقة الدفع القياسية في WooCommerce بدون احترافية.
HTTPS: يجب أن يستخدم موقعك SSL/HTTPS (مطلوب من واجهة برمجة التطبيقات لـ Vipps)

استكشاف الأخطاء

المشاكل الشائعة

الدفع لم يكتمل
  • يستمر الخروج لمدة تصل إلى 5 دقائق - إذا لم يؤكد العميل خلال هذه الفترة، فإن الدفعة تنتهي
  • تحقق من عدم خلطك بين وضع الاختبار وبيانات الاعتماد الإنتاجية
  • تحقق من أن اتصال الإنترنت لديك مستقر على كل من جهاز نقطة البيع وهاتف العميل
خطأ في بيانات الاعتماد غير صالحة
  • تحقق مرة أخرى من جميع حقول البيانات الأربعة (MSN، معرف العميل، سر العميل، مفتاح الاشتراك)
  • تأكد من أنك تستخدم بيانات اعتماد الاختبار عندما يكون وضع الاختبار مفعلًا، وبيانات اعتماد الإنتاج عندما يكون غير مفعل
  • تحقق من بيانات اعتماداتك في بوابة Vipps
فتح 'إرسال إلى الهاتف' علامة تبويب جديدة بدلاً من الإرسال مباشرة

هذا يعني أن حساب Vipps الخاص بك ليس لديه PUSH_MESSAGE مفعل بعد. تستخدم الإضافة استرجاع صفحة الهبوط، والتي تعمل ولكن تضيف خطوة إضافية. للحصول على تجربة الدفع الفوري بسلاسة، اتصل بـ Vipps واطلب منهم تفعيل PUSH_MESSAGE على وحدة البيع الخاصة بك (MSN). راجع تمكين الدفع الفوري أعلاه.

لم يتم توليد رمز QR
  • تأكد من أن موقعك يعمل من خلال HTTPS - ترفض واجهة برمجة التطبيقات Vipps الطلبات من مواقع HTTP
  • تحقق من سجلات WooCommerce (WooCommerce > الحالة > السجلات) للحصول على تفاصيل أخطاء API
  • تحقق من أن حساب التاجر الخاص بك نشط وقد تم تمكين واجهة برمجة التطبيقات الخاصة ب ePayment

الحصول على المساعدة

للحصول على الدعم الفني:

  • زيارة مستودع GitHub للإبلاغ عن المشكلات
  • تحقق من وثائق المطور من Vipps لأسئلة متعلقة بواجهة برمجة التطبيقات
  • اتصل بدعم Vipps MobilePay لمشكلات الحساب وبيانات الاعتماد

لقطات الشاشة

ستتم إضافة لقطات الشاشة في تحديث مستقبلي لتظهر:

  • تكوين البوابة في إعدادات دفع WooCommerce
  • واجهة الدفع في نقطة البيع مع خيارات رمز QR وإشعار الدفع
  • تدفق تأكيد الدفع