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

Eiji Kitamura

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

سيزيل Chrome الحقول التعريفية من حدث canmakepayment ويبدأ مرحلة التجربة والتقييم من الإصدار 108 من Chrome.

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

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

عندما يتصل التاجر بالرقم new PaymentRequest()، يتلقّى عامل الخدمة المسجّل حدث canmakepayment (CanMakePaymentEvent) الذي يحتوي على المعلومات التالية:

• topOrigin
• paymentRequestOrigin
• methodData
• modifiers

ستتم إزالة هذه الأحداث وسيتلقّى العامل في الخدمة ببساطة حدث canmakepayment بدون أي معلومات إضافية.

رصد الميزات

لرصد ما إذا تم تغيير الحدث canmakepayment في رمز worker الخدمة، راجِع السمات ذات الصلة على النحو التالي:

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 (وIntent IS_READY_TO_PAY في Android).

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

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

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

لتسجيل نسخة تجريبية من المصدر:

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

Origin-Trial: Auw/tjTQ2eJQ911wiMHi1Bb7i71...

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