تسجيل تطبيق دفع مستند إلى الويب

تعرَّف على كيفية إعداد تطبيق دفع مستند إلى الويب أثناء التسجيل.

Eiji Kitamura

تطبيقات الدفع المستندة إلى الويب هي تطبيقات ويب تقدّمية (PWA) وتعمل على برامج الخدمة. يؤدي برنامج service worker في تطبيق الدفع دورًا مهمًا، إذ يتلقّى طلبات الدفع من التاجر، ويشغّل تطبيق الدفع، ويتوسّط في عملية التواصل مع التاجر.

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

دعم المتصفح

تتألف Web Payments من بعض التقنيات المختلفة، ويعتمد حالة التوافق على المتصفّح.

Chromium Safari Firefox
أجهزة الكمبيوتر المكتبي Android أجهزة الكمبيوتر المكتبي الجهاز الجوّال أجهزة الكمبيوتر المكتبي/الأجهزة الجوّالة
Payment Request API ✔ ✔ ✔ ✔
Web-based Payment Handler API ✔ ✔
تطبيق دفع على iOS/Android ✔ ✔ ✔* ✔*

ضبط تطبيق دفع باستخدام بيان تطبيق الويب

لضبط تطبيق الدفع المستند إلى الويب بشكل تعريفي، عليك عرض بيان تطبيق الويب.

السمات التالية في بيان تطبيق الويب ذات صلة بتطبيقات الدفع المستندة إلى الويب:

  • name
  • icons
  • serviceworker
    • src
    • scope
    • use_cache

راجِع مقالة إعداد طريقة دفع للتأكّد من أنّ بيان طريقة الدفع يشير إلى بيان تطبيق الويب بشكلٍ سليم.

تسجيل مشغّل الخدمات في الوقت المناسب

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

تصحيح أخطاء تطبيق دفع مستند إلى الويب

عند تطوير الواجهة الأمامية لتطبيق دفع مستند إلى الويب، من المحتمل أن تنتقل بين سياق التاجر وسياق تطبيق الدفع. ستساعدك نصائح تصحيح الأخطاء التالية في تحسين تجربة التطوير على Chrome.

التطوير على خادم محلي

ما هو الخادم الذي تستخدمه للتطوير؟ يميل العديد من المطوّرين إلى استخدام localhost أو بيئة خادم داخلية خاصة بالشركة، ما قد يشكّل تحديًا لأنّ الميزات الفعّالة في المتصفّح تتطلّب عادةً بيئة آمنة (HTTPS) وشهادة صالحة. ولا تشكّل واجهة Payment Request API وواجهة Web-based Payment Handler API أي استثناء، كما أنّ المضيفات المحلية أو الخوادم الداخلية للشركة لا تتضمّن عادةً شهادة صالحة.

والخبر السار هو أنّ بعض المتصفّحات، بما في ذلك Chrome، تستثني الشهادات التي تتضمّن http://localhost تلقائيًا. في Chrome أيضًا، يمكنك إعفاء الجهاز من شرط الشهادة من خلال تشغيل مثيل من Chrome. على سبيل المثال، لإعفاء المتطلبات من http://*.corp.company.com، استخدِم العلامات التالية:

‫macOS

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --ignore-certificate-errors --unsafely-treat-insecure-origin-as-secure=http://*.corp.company.com

Windows

chrome.exe --ignore-certificate-errors --unsafely-treat-insecure-origin-as-secure=http://*.corp.company.com

يمكنك الاطّلاع على مزيد من المعلومات حول تشغيل Chrome باستخدام علامة وقت التشغيل في تشغيل Chromium باستخدام العلامات.

إعادة توجيه المنفذ إلى خادم محلي

يمكنك إعادة توجيه خادم الويب المحلي إلى جهاز Android باستخدام "أدوات مطوّري البرامج في Chrome" واختبار طريقة عمله من متصفّح على الجهاز الجوّال. لمعرفة كيفية تنفيذ ذلك، اطّلِع على مقالة الوصول إلى الخوادم المحلية.

تصحيح الأخطاء عن بُعد في موقع إلكتروني على Chrome لنظام Android من "أدوات المطوّرين" على الكمبيوتر

يمكنك أيضًا تصحيح أخطاء Chrome على Android باستخدام "أدوات مطوّري البرامج" على الكمبيوتر. لمعرفة كيفية إجراء ذلك، اطّلِع على بدء تصحيح الأخطاء عن بُعد على أجهزة Android.

تسجيل أحداث "معالج الدفع"

يمكن لأدوات مطوّري البرامج عرض أحداث Web-based Payment Handler API لتسهيل عملية التطوير المحلية. افتح "أدوات مطوّري البرامج" في سياق التاجر وانتقِل إلى قسم "معالج الدفع" ضمن لوحة التطبيق. ضَع علامة في المربّع بجانب "عرض أحداث من نطاقات أخرى"، ثم انقر على الزر "تسجيل" لبدء تسجيل الأحداث التي يتم إرسالها إلى عامل الخدمة الذي يتعامل مع الدفعات.

لقطة شاشة لسجلّ أحداث "معالج الدفع المستند إلى الويب"
تسجيل أحداث "معالج الدفع المستند إلى الويب".

الخطوات التالية

الخطوة التالية هي التعرّف على كيفية تنسيق عامل الخدمة لمعاملة دفع في وقت التشغيل.