# بوابة Vipps MobilePay

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

## الميزات[​](#features "رابط مباشر إلى الميزات")

#### مدفوعات رمز QR

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

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

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

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

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

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

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

## التثبيت[​](#installation "رابط مباشر إلى التثبيت")

1

#### تحميل وتثبيت

1. زيارة [صفحة إصدارات WCPOS Vipps MobilePay](https://github.com/wcpos/wcpos-vipps/releases)
2. تحميل ملف **wcpos-vipps.zip** الأحدث
3. في لوحة إدارة ووردبريس، انتقل إلى `الإضافات > إضافة جديدة > تحميل الإضافة`
4. تحميل ملف zip وتفعيل الإضافة

2

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

1. الانتقال إلى `WP Admin > ووCommerce > الإعدادات > المدفوعات`

2. العثور على **WCPOS Vipps MobilePay** في قائمة طرق الدفع

3. النقر على **WCPOS Vipps MobilePay** للوصول إلى الإعدادات

4. إدخال بيانات الاعتماد الخاصة بك من [بوابة Vipps](https://portal.vipps.no/):

   <!-- -->

   * **رقم تسلسلي للتاجر (MSN)**
   * **معرف العميل**
   * **سر العميل**
   * **مفتاح الاشتراك**

5. حفظ الإعدادات

ملاحظة

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

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

إذا كانت لديك الإضافة الرسمية [الدفع بواسطة Vipps MobilePay](https://wordpress.org/plugins/woo-vipps/) مثبتة، فسيتم استيراد بيانات الاعتماد الخاصة بك تلقائيًا عند تفعيل هذه الإضافة. يمكنك تخطي إدخال بيانات الاعتماد يدويًا.

3

#### تفعيل في WCPOS

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

## الاستخدام[​](#usage "رابط مباشر إلى الاستخدام")

### معالجة المدفوعات - رمز QR[​](#processing-payments-qr-code "رابط مباشر إلى معالجة المدفوعات - رمز QR")

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

### معالجة المدفوعات - إرسال إلى الهاتف[​](#processing-payments-send-to-phone "رابط مباشر إلى معالجة المدفوعات - إرسال إلى الهاتف")

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

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

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

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

### تمكين الدفع الفوري[​](#enabling-direct-push "رابط مباشر إلى تمكين الدفع الفوري")

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

1. تسجيل الدخول إلى [portal.vippsmobilepay.com](https://portal.vippsmobilepay.com)
2. الاتصال بمدير حسابك الرئيسي في Vipps، أو مدير الشركاء، أو خدمة العملاء
3. أخبرهم: **"أحتاج تمكين PUSH\_MESSAGE على رقم MSN الخاص بي للاستخدام مع تكامل نقطة البيع"**

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

### إلغاء الدفع[​](#cancelling-a-payment "رابط مباشر إلى إلغاء الدفع")

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

### استرداد الأموال[​](#refunds "رابط مباشر إلى استرداد الأموال")

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

## الأسواق المدعومة[​](#supported-markets "رابط مباشر إلى الأسواق المدعومة")

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

| المنطقة          | العلامة التجارية | العملات  |
| ---------------- | ---------------- | -------- |
| النرويج          | Vipps            | NOK      |
| الدنمارك، فنلندا | MobilePay        | DKK، EUR |

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

## المتطلبات[​](#requirements "رابط مباشر إلى المتطلبات")

حساب Vipps

<!-- -->

: حساب تاجر Vipps MobilePay نشط مع بيانات اعتماد API

بيانات اعتماد API

<!-- -->

: رقم تسلسلي للتاجر، معرف العميل، سر العميل، ومفتاح الاشتراك

WCPOS

<!-- -->

: الإصدار الاحترافي مطلوب للدفع بنقطة البيع. تعمل البوابة أيضًا على طريقة الدفع القياسية في WooCommerce بدون احترافية.

HTTPS

<!-- -->

: يجب أن يستخدم موقعك SSL/HTTPS (مطلوب من واجهة برمجة التطبيقات لـ Vipps)

## استكشاف الأخطاء[​](#troubleshooting "رابط مباشر إلى استكشاف الأخطاء")

### المشاكل الشائعة[​](#common-issues "رابط مباشر إلى المشاكل الشائعة")

الدفع لم يكتمل

* يستمر الخروج لمدة تصل إلى 5 دقائق - إذا لم يؤكد العميل خلال هذه الفترة، فإن الدفعة تنتهي
* تحقق من عدم خلطك بين وضع الاختبار وبيانات الاعتماد الإنتاجية
* تحقق من أن اتصال الإنترنت لديك مستقر على كل من جهاز نقطة البيع وهاتف العميل

خطأ في بيانات الاعتماد غير صالحة

* تحقق مرة أخرى من جميع حقول البيانات الأربعة (MSN، معرف العميل، سر العميل، مفتاح الاشتراك)
* تأكد من أنك تستخدم بيانات اعتماد الاختبار عندما يكون وضع الاختبار مفعلًا، وبيانات اعتماد الإنتاج عندما يكون غير مفعل
* تحقق من بيانات اعتماداتك في [بوابة Vipps](https://portal.vipps.no/)

فتح 'إرسال إلى الهاتف' علامة تبويب جديدة بدلاً من الإرسال مباشرة

هذا يعني أن حساب Vipps الخاص بك ليس لديه `PUSH_MESSAGE` مفعل بعد. تستخدم الإضافة استرجاع صفحة الهبوط، والتي تعمل ولكن تضيف خطوة إضافية. للحصول على تجربة الدفع الفوري بسلاسة، اتصل بـ Vipps واطلب منهم تفعيل PUSH\_MESSAGE على وحدة البيع الخاصة بك (MSN). راجع [تمكين الدفع الفوري](#enabling-direct-push) أعلاه.

لم يتم توليد رمز QR

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

### الحصول على المساعدة[​](#getting-help "رابط مباشر إلى الحصول على المساعدة")

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

* زيارة [مستودع GitHub](https://github.com/wcpos/wcpos-vipps) للإبلاغ عن المشكلات
* تحقق من [وثائق المطور من Vipps](https://developer.vippsmobilepay.com/) لأسئلة متعلقة بواجهة برمجة التطبيقات
* اتصل بدعم Vipps MobilePay لمشكلات الحساب وبيانات الاعتماد

## لقطات الشاشة[​](#screenshots "رابط مباشر إلى لقطات الشاشة")

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

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