تعديل على سلوك حدث 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 في رمز عامل الخدمة، افحص الخصائص ذات الصلة على النحو التالي:

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 في شريط العناوين.
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 في شريط العناوين.
3. فعِّل الميزة التجريبية.
4. أعِد تشغيل Chrome.

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

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