واجهة برمجة التطبيقات Payment Handler API: تتيح لمقدّمي خدمات الدفع توفير تجربة الدفع المخصّصة للتجّار، فضلاً عن Payment Request API. عند إعداد Payment Request API من خلال
الطريقة الإنشائية new PaymentRequest()
، يتم تنشيط حدث canmakepayment
بدون تنبيه مع أصل التاجر والبيانات العشوائية إلى
مشغّل خدمات مسجَّل في واجهة برمجة التطبيقات Payment Handler API.
لا يتطلب هذا التواصل متعدد المصادر إيماءة مستخدم ولا يُظهر أي واجهة مستخدم.
سيُزيل Chrome الحقول التعريفية من حدث canmakepayment
ويبدأ مرحلة التجربة والتقييم من Chrome 108.
لا تنطبق المعلومات الواردة في هذه الصفحة إلا على مقدّمي تطبيقات الدفع الذين يستخدمون واجهة برمجة التطبيقات Payment Handler API. وإذا لم تكن تستخدمه، يمكنك تخطي هذه التعليمات.
ما الذي سيتغيّر؟
عندما يتصل تاجر بـ new PaymentRequest()
، يتلقى عامل خدمات مسجَّل
حدث canmakepayment
(CanMakePaymentEvent
)
يحتوي على المعلومات التالية:
topOrigin
paymentRequestOrigin
methodData
modifiers
ستتم إزالة هذه الأحداث وسيتلقّى مشغّل الخدمات
حدث canmakepayment
بدون أي معلومات إضافية.
رصد الميزات
لاكتشاف ما إذا كان قد تم تغيير حدث canmakepayment
في رمز مشغّل الخدمات، افحص الخصائص المناسبة على النحو التالي:
self.addEventListener(e => {
if (e.paymentRequestOrigin) {...}
if (e.topOrigin) {...}
if (e.methodData && e.methodData.length > 0) {...}
if (e.modifiers && e.modifiers.length > 0) {...}
...
});
تجربة التغيير محليًا
لتمكين التغيير محليًا لأغراض التطوير:
- استخدِم الإصدار 108 أو 109 أو 110 من Chrome.
- أدخِل
chrome://flags/#clear-identity-in-can-make-payment
في شريط عنوان URL. - تفعيل العلامة
- أعِد تشغيل Chrome.
من خلال تفعيل العلامة، سيتم إفراغ حقول الهوية في الحدث canmakepayment
(والهدف IS_READY_TO_PAY
لنظام التشغيل Android).
تفعيل التغيير في قناة الإصدار العلني
يمكنك أيضًا تفعيل التغيير في مرحلة الإنتاج لأغراض الاختبار قبل وصوله إلى Chrome. تُعرف هذه الآلية باسم مرحلة التجربة والتقييم.
تتيح لك مرحلة التجربة والتقييم تجربة ميزات جديدة وتقديم ملاحظات حول سهولة استخدامها وعملها العملي وفعاليتها في منتدى معايير الويب. لمزيد من المعلومات، يُرجى الاطّلاع على دليل الفترات التجريبية الأصلية لمطوّري البرامج على الويب. للاشتراك في هذه التجربة أو مرحلة التجربة والتقييم الأخرى، يُرجى الانتقال إلى صفحة التسجيل.
لتسجيل مرحلة التجربة والتقييم:
- اطلب رمزًا مميّزًا للأصل.
- أضِف الرمز المميّز إلى ملف JavaScript لمشغِّل الخدمات باستخدام عنوان HTTP
Origin-Trial
. يتطلب إعداد عناوين HTTP الدخول إلى تهيئة الخادم. يجب أن يبدو عنوان الاستجابة الناتج على النحو التالي:
Origin-Trial: Auw/tjTQ2eJQ911wiMHi1Bb7i71...
للاطّلاع على الرمز المميّز لمرحلة التجربة والتقييم في ملف مشغّل الخدمات،
استخدِم "أدوات مطوري البرامج"
أو الأمر curl
على النحو التالي:
$ curl --head <Service Worker JS file URL> | grep -i origin-trial
origin-trial: Auw/tjTQ2eJQ911wiMHi1Bb7i71...
إعادة تفعيل حقول الهوية على الجهاز بعد Chrome 111
في حال استخدام الإصدار 111 من Chrome أو إصدار أحدث، سيتم ترك حقول الهوية في
حدث canmakepayment
فارغة. لإعادة تفعيل الحقول
على الجهاز، يمكنك اتّباع الخطوات التالية:
- استخدِم الإصدار 111 من Chrome أو إصدارًا أحدث.
- أدخِل
chrome://flags/#add-identity-in-can-make-payment
في شريط عنوان URL. - تفعيل العلامة
- أعِد تشغيل Chrome.
الخطوات التالية
تم التخطيط لتفعيل هذا التغيير تلقائيًا بدءًا من الإصدار 111 من Chrome. يمكنك بدء الاختبار اليوم للاستعداد للتغيير في الوقت المناسب للإطلاق.