تعديل على سلوك حدث CanMakePayment في واجهة برمجة التطبيقات Payment Handler API

Eiji Kitamura

واجهة برمجة التطبيقات 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) {...}
  ...
});

تجربة التغيير محليًا

لتمكين التغيير محليًا لأغراض التطوير:

1. استخدِم الإصدار 108 أو 109 أو 110 من Chrome.
2. أدخِل chrome://flags/#clear-identity-in-can-make-payment في شريط عنوان URL.
3. تفعيل العلامة
4. أعِد تشغيل Chrome.

من خلال تفعيل العلامة، سيتم إفراغ حقول الهوية في الحدث canmakepayment (والهدف IS_READY_TO_PAY لنظام التشغيل Android).

تفعيل التغيير في قناة الإصدار العلني

يمكنك أيضًا تفعيل التغيير في مرحلة الإنتاج لأغراض الاختبار قبل وصوله إلى Chrome. تُعرف هذه الآلية باسم مرحلة التجربة والتقييم.

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

لتسجيل مرحلة التجربة والتقييم:

1. اطلب رمزًا مميّزًا للأصل.
2. أضِف الرمز المميّز إلى ملف 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 فارغة. لإعادة تفعيل الحقول على الجهاز، يمكنك اتّباع الخطوات التالية:

1. استخدِم الإصدار 111 من Chrome أو إصدارًا أحدث.
2. أدخِل chrome://flags/#add-identity-in-can-make-payment في شريط عنوان URL.
3. تفعيل العلامة
4. أعِد تشغيل Chrome.

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

تم التخطيط لتفعيل هذا التغيير تلقائيًا بدءًا من الإصدار 111 من Chrome. يمكنك بدء الاختبار اليوم للاستعداد للتغيير في الوقت المناسب للإطلاق.