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

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

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

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

المتصفحات المتوافقة

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

Chromium برنامج المتصفح Safari Firefox
أجهزة الكمبيوتر المكتبي Android أجهزة الكمبيوتر المكتبي الأجهزة الجوّالة أجهزة الكمبيوتر المكتبية/الأجهزة الجوّالة
واجهة برمجة تطبيقات طلب الدفع
واجهة برمجة تطبيقات معالج الدفع
تطبيق الدفع لأجهزة iOS/Android ✔* ✔*

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

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

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

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

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

تسجيل عامل خدمات في الوقت المناسب (JIT)

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

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

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

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

ما الخادم الذي تستخدمه للتطوير؟ يميل العديد من مطوّري البرامج إلى استخدام المضيف المحلي أو بيئة الخادم الداخلية للشركة، ما قد يمثل تحديًا لأن الميزات الفعّالة في المتصفح تتطلب غالبًا بيئة آمنة (HTTPS) وشهادة صالحة. ولا يشكّل Payment Request API وواجهة برمجة تطبيقات 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 من "أدوات مطوري البرامج" على الكمبيوتر المكتبي

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

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

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

لقطة شاشة لتسجيل أحداث معالج الدفع
تسجيل أحداث معالج الدفع

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

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