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

Eiji Kitamura

واجهة برمجة تطبيقات معالجة الدفع تسمح لمقدّمي خدمات الدفع بتوفير تجربة الدفع المخصّصة والتجار بالإضافة إلى Payment Request API عند إعداد Payment Request API عبر الدالة الإنشائية "new PaymentRequest()"، فهي تعمل على تنشيط حدث canmakepayment بدون تنبيه باستخدام أصل التاجر والبيانات العشوائية مشغِّل خدمات مسجَّل في واجهة برمجة تطبيقات معالجة الدفع لا يتطلّب هذا الاتصال المتعدد المصادر استخدام إيماءة المستخدم ولا تعرض أي واجهة مستخدم.

سيزيل Chrome حقول التعريف من حدث واحد (canmakepayment). وبدء مرحلة التجربة والتقييم من Chrome 108.

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

ما الذي سيتغيّر؟

عندما يتصل أحد التجّار بخدمة "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. استخدِم إصدارات Chrome 108 أو 109 أو 110.
2. أدخِل chrome://flags/#clear-identity-in-can-make-payment في شريط عنوان URL.
3. تفعيل الإبلاغ
4. أعِد تشغيل Chrome.

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

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

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

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

لتسجيل مرحلة التجربة والتقييم، اتّبِع الخطوات التالية:

1. طلب رمز مميّز المصدر.
2. أضِف الرمز المميّز إلى ملف JavaScript لمشغِّل الخدمات باستخدام Origin-Trial. عنوان HTTP: يتطلب إعداد عناوين HTTP إمكانية الوصول لتهيئة الخادم. من المفترض أن يبدو عنوان الاستجابة الناتج على النحو التالي:

Origin-Trial: Auw/tjTQ2eJQ911wiMHi1Bb7i71...

للاطّلاع على الرمز المميّز الخاص بالتجربة الأصلية في ملف مشغّل الخدمات، استخدام أدوات مطوري البرامج أو الأمر curl على النحو التالي:

$ curl --head <Service Worker JS file URL> | grep -i origin-trial
origin-trial: Auw/tjTQ2eJQ911wiMHi1Bb7i71...

إعادة تفعيل حقول الهوية محليًا بعد الإصدار 111 من Chrome

إذا كنت تستخدم الإصدار 111 من Chrome أو إصدارًا أحدث، ستظهر حقول الهوية في تم ترك حدث واحد (canmakepayment) فارغًا. لإعادة تفعيل محليًا، يمكنك القيام بما يلي:

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

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

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