ستتطلّب واجهة برمجة تطبيقات معالجة الدفع باستخدام سياسة أمان المحتوى Connect-src

واجهة برمجة تطبيقات معالجة الدفع تسمح لمقدّمي خدمات الدفع بتوفير تجربة الدفع المخصّصة والتجار بالإضافة إلى Payment Request API

لا تنطبق المعلومات الواردة في هذه الصفحة إلا على المواقع الإلكترونية التي تستخدم كلاً من سياسة أمان المحتوى (CSP). وPayment Request API إذا لم تستخدم أيًا من الخيارين أو لم تستخدم أيًا منهما، يمكنك تخطي هذه التعليمات.

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

إذا كنت تستخدم واجهة برمجة تطبيقات معالجة الدفع وسياسة أمان المحتوى (CSP) من أجل حماية أفضل، فإنك بحاجة إلى التأكد من أن نطاقات طلبات HTTP المرسلة من تتم إضافة المتصفِّح إلى التوجيه connect-src لعنوان CSP.

على سبيل المثال، إذا استدعى رمز JavaScript new PaymentRequest([{supportedOrigins: ‘https://example.com/pay’}], details)، فعندئذٍ يجب أن يحتوي connect-src CSP على https://example.com أو https://example.com/pay:

Content-Security-Policy: connect-src https://example.com/pay

إذا كانت https://example.com/pay عبارة عن إعادة توجيه من مصادر متعددة، يتم تحديد الوجهة يجب تضمين المصدر في سياسة أمان المحتوى (CSP) أيضًا. على سبيل المثال، إذا تتم إعادة التوجيه من خلال https://example.com/pay إلى https://pay.example.com، ثم كليهما يجب تضمين المصادر في سياسة أمان المحتوى (CSP):

Content-Security-Policy: connect-src https://example.com/pay https://pay.example.com

تجربتها محليًا

لتفعيل الميزة محليًا قبل شحنها:

  1. انتقِل إلى chrome://flags/#web-payment-api-cspعلى Chrome.
  2. تغيير "سياسة CSP لواجهة برمجة تطبيقات الدفع على الويب" من "تلقائي" إلى "مفعّلة".
  3. أعِد تشغيل متصفّح Chrome.

التحقّق من عناوين URL للطلبات

للتحقّق من عناوين URL للطلبات المُرسَلة من Payment Handler API:

  1. تفعيل ميزة chrome://flags/#web-payment-api-csp
  2. انتقِل إلى صفحة الدفع وافتح "أدوات المطوّرين" في Chrome.
  3. ابحث عن رسائل خطأ مثل ما يلي: text RangeError: Failed to construct 'PaymentRequest': https://example.com/pay payment method identifier violates Content Security Policy.
  4. أضِف معرِّف الطريقة المحدّد إلى سياسة أمان المحتوى (CSP).

تصوير إدواردو سواريس على موقع Unسباش