نصائح حول استكشاف الأخطاء وإصلاحها في رابط وزر المدفوعات على PayPal

تلقيتُ رسالة خطأ، ولا يظهر الزر على موقعي الإلكتروني.

• تحقّق من عمل الاتصال بالإنترنت لديك.
• تفضّل بزيارة صفحات أخرى في موقعك الإلكتروني وتحقّق من تحميلها بشكل صحيح.
• انتقل إلى صفحة أزرار PayPal وتحقّق مما يلي:

• هل يظهر الزر ضمن "الأزرار المحفوظة"؟
• حدد "تعديل" وتأكد من أن رمز الزر يطابق الرمز الموجود على موقعك الإلكتروني. 

• انقر بزر الماوس الأيمن على صفحة منتجك (حيث لصقت رمز الزر) وانقر على "فحص". انتقل إلى علامة تبويب "وحدة التحكم" (سترى علامة التبويب هذه في الأعلى). قد تظهر لك أخطاء سياسة أمان المحتوى (CSP).

إذا قُمتَ بنشر سياسة أمان المحتوى (CSP)، فقد ترى أخطاء في CSP مثل الأخطاء التالية (عينة من أخطاء CSP):

تم رفض تحميل النص "https://www.paypal.com/sdk/js**" لأنه ينتهك توجيه "سياسة أمان المحتوى" التالي: ‎"default-src 'self'"‎. لاحِظ أنه لم يتم تعيين 'script-src-elem' بشكل صريح، لذلك يتم استخدام 'default-src' كاحتياطي.

تم رفض الاتصال بـ '‎https://www.paypal.com/**‎' لأنه ينتهك توجيه "سياسة أمان المحتوى" التالي: ‎"default-src 'self'"‎. لاحِظ أنه لم يتم تعيين 'connect-src' بشكل صريح، لذلك يتم استخدام 'default-src' كاحتياطي.

تم رفض تنفيذ النص المُضمَّن لأنه ينتهك توجيه "سياسة أمان المحتوى" التالي: ‎"script-src ‎https://*.paypal.com‎"‎. يلزم توفر إما الكلمة الأساسية 'unsafe-inline'، أو علامة تجزئة ('sha256-WYDWDPwB8j2VePYrqy38aHPcJLsasO//lnXymmxscUk=')، أو رقم عشوائي (‎'nonce-...'‎) لتمكين التنفيذ المُضمَّن.

تم رفض تحميل الصورة 'https://tracking.qa.paypal.com/webapps/tracking/ts?**' لأنها تنتهك توجيه "سياسة أمان المحتوى" التالي: ‎"default-src 'self'"‎. لاحِظ أنه لم يتم تعيين 'img-src' بشكل صريح، لذلك يتم استخدام 'default-src' كاحتياطي.

تم رفض تأطير ‎'https://www.paypal.com/'‎ لأنه ينتهك توجيه "سياسة أمان المحتوى" التالي: ‎"default-src 'self'"‎. لاحِظ أنه لم يتم تعيين 'frame-src' بشكل صريح، لذلك يتم استخدام 'default-src' كاحتياطي.

يمكنك محاولة إضافة ما يلي لحل أي من الأخطاء المذكورة أعلاه:

الخيار 1 (HTML): إذا تم تكوين CSP الخاصة بك في ملف HTML، فاستخدِم الكود أدناه لاستبدال كود CSP لديك

<meta http-equiv="Content-Security-Policy" content="default-src 'self';
script-src 'unsafe-inline' https://*.paypal.com https://*.paypalobjects.com;
style-src 'unsafe-inline' https://*.paypal.com; connect-src
https://*.paypal.com; frame-src https://*.paypal.com; img-src
https://*.paypal.com https://*.paypalobjects.com">

الخيار 2 (من جانب الخادم): إذا تم تكوين CSP الخاصة بك من جانب الخادم، فاستخدِم الكود أدناه لاستبدال كود CSP لديك

Content-Security-Policy: script-src 'unsafe-inline' https://*.paypal.com https://*.paypalobjects.com
Content-Security-Policy: style-src 'unsafe-inline' https://*.paypal.com
Content-Security-Policy: connect-src https://*.paypal.com
Content-Security-Policy: frame-src https://*.paypal.com
Content-Security-Policy: img-src https://*.paypal.com https://*.paypalobjects.com

كيف يمكنني تغيير المخطط/ الحجم/ اللون لاسم/ سعر/ كمية المنتج؟

ليس من الممكن حالياً تغيير المخطط/الحجم/اللون لهذا الدمج.

لقد عدّلتُ معلومات المنتج (الاسم أو المبلغ أو أي شيء آخر)؛ هل يتعين عليّ

نسخ/لصق رمز الزر مجدداً؟

لا، فنحن نأخذ جميع المعلومات من خادم PayPal. بمجرد أن تحفظ التغييرات في حسابك، لن يلزمك تحديث معرّف زر النسخ/اللصق بموقعك الإلكتروني. 

ملاحظة: إذا غيرت رمز العملة على منتجك، فسيتعين عليك تحديث زر الدفع لديك.

أرى معرّف عميل في الرمز؛ فماذا يعني ذلك؟

معرّف العميل هو معرّف العميل الخاص بالتاجر الذي يشكّل جزءاً من حسابك. ينبغي عدم تعديله. استخدمه كما هو معروض في رمز الزر.

لقد أضفتُ أزراراً متعددة، ولكن لا يظهر أيٌّ منها على صفحة الويب الخاصة بي.

لن تعمل الأزرار المتعددة على نفس صفحة الويب في السيناريوهات التالية:

• إذا نسخت/لصقت معرِّف الزر نفسه عدة مرات في نفس صفحة الويب، فسيظهر الزر الأول فقط. لا يمكنك تكرار معرّف الزر نفسه عدة مرات.
• إذا نسخت/لصقت معرّفات أزرار مختلفة ولكن بعملات أخرى على صفحة الويب نفسها، فسيظهر الزر الأول فقط. لا يمكنك إضافة عملات أجنبية على الأزرار الموجودة في صفحة الويب نفسها.
• إذا نسخت/لصقت معرّفات أزرار مختلفة ولاحظت أن الصفحة بطيئة، فتأكد من إضافة علامة البرنامج النصي بمعرّف العميل مرة واحدة فقط. سيبدو سطر البرنامج النصي على النحو التالي:
  

  • <البرنامج النصي src="https://www.paypal.com/sdk/js?client-id=XYZ&components=hosted-buttons&enable-funding=venmo&currency=USD"></script> 

لديّ حساب PayPal متميز ولا أرى ميزة رابط وزر

المدفوعات.

هذه الخاصية متاحة فقط للحسابات التجارية على PayPal. إنشاء حساب تجاري.

كيف يمكنني اختبار هذه التجربة على بيئة PayPal Sandbox؟

تتوفر روابط وأزرار المدفوعات لاختبارها على Sandbox.

لا يظهر امتداد "بطاقة الائتمان/ الخصم" المضمَّن بالكامل على موقعي

الإلكتروني.

تأكّد من ضبط عرض الحاوية الأصلية وارتفاعها لاستيعاب الامتداد المضمَّن. راجِع وثائق/دعم منصة الاستضافة لديك لمزيد من التفاصيل.

هل تدعم روابط وأزرار المدفوعات إشعار الدفع الفوري (IPN)؟

نعم. اتبع هذه الخطوات لإعداد إشعار الدفع الفوري (IPN) وتفعيله.

إليك كيفية العثور على إعدادات إشعار الدفع الفوري (IPN) في PayPal:

1. انتقل إلى إعدادات الحساب.
2. حدد الإشعارات وإشعارات الدفع الفوري.
3. انقر على تحديث الرابط.

إليك كيفية تفعيل إعدادات إشعار الدفع الفوري (IPN):

1. أضف رابط URL لمعالج إشعار الدفع الفوري (IPN) وحدد تلقي مراسلات إشعار الدفع الفوري (IPN) (مفعلة).
2. انقر على حفظ.

التعامل مع إشعار الدفع الفوري (IPN) في رمز الخادم الخاص بك:

• عند اكتمال مدفوعات روابط وأزرار المدفوعات، يقوم إشعار الدفع الفوري (IPN) على PayPal باستدعاء رابط URL للإشعار الذي تم تكوينه في الخطوة 2.

الوصول إلى سجل إشعار الدفع الفوري (IPN):

• https://www.sandbox.paypal.com//ipn/history
• https://www.paypal.com/merchantnotification/ipn/history

الوصول إلى سجل إشعار الدفع الفوري (IPN):

• https://developer.paypal.com/api/nvp-soap/ipn/IPNIntro/

عند إرسال عميل إلى صفحة إعادة التوجيه، ما المعلومات التي ترسلها PayPal

حول عملية الشراء؟ هل تدعم روابط وأزرار مدفوعات تحويل بيانات الدفع (PDT)،

وما المتغيرات المدعومة؟

نعم، نحن ندعم متغيرات تحويل بيانات الدفع على النحو الموثق هنا. ستتلقى تحويل بيانات الدفع إذا شغّلت إعداد العودة التلقائية خلال تهيئة رابط وزر المدفوعات. 

هل تدعم روابط وأزرار المدفوعات لغة محلية إذا أضافها التاجر يدوياً

في رمز الزر أو رابط المدفوعات؟

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

يمكن للتجار إلغاء ذلك فقط في رابط المدفوعات ورمز الزر من خلال إلحاق "locale.x=fr_FR" كمعلمة استعلام. يمكن العثور على قائمة الرموز المدعومة للغات المحلية هنا. ولن يُترجَم أي ينص يدخله التاجر خلال عملية التهيئة.

مثال: https://www.paypal.com/ncp/payment/F3YMU2ZGT49XX?locale.x=jp_JP

مثال: 

<script src="……¤cy=USD&locale.x=jp_JP"></script>

هل يمكن إخفاء بعض الملصقات التي تنتج عن روابط المدفوعات

ورمز الزر؟

نحن نتفهم أنه قد يكون لديك إعداد بصري مختلف على موقعك الإلكتروني، لكننا لا نوصي بإخفاء رمز الزر الذي نقدمه. 

لن يؤدي إخفاؤه من موقعك الإلكتروني إلى تغيير طريقة معالجة المعاملة. ستُجرى المعاملة مع ذلك باستخدام تهيئة معرف الزر المستضاف الخاص بك. 

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

فيما يلي مثال على كيفية إخفاء سعر سلعة:

أضف هذا البرنامج النصي أسفل رمز الزر، واستبدل HostedButton_ID بمعرف الزر الفعلي.

وعلى غرار إخفاء سعر سلعة، يمكنك القيام بالأمر نفسه لنص آخر أيضاً:

• desc-label (لاسم المنتج)
• price-label (للسعر)

إذا كنت تريد إخفاء عناصر متعددة منها، فاستخدم معرفاً منفصلاً:

style> #paypal-container-

{ #paypal-form-fields-container-

{ #price-label,  #desc-label { display: none !important; }} }

إذا كنت تريد إخفاء جميع النصوص حول الأزرار، فتذكر أن نوع الزر ينبغي ألا يتطلب أي اختيارات أو إدخالات من العميل:

هل يمكن إلغاء رابط وأزرار المدفوعات الخاصة بي لاستخدام "رسم الشحن من

الإعدادات؟"

لن تخضع روابط وأزرار المدفوعات لإلغاء الشحن بطريقة مجمعة من إعدادات الحساب، المعروفة أيضاً بالإعداد التالي من إعداد الشحن.

لقد غيرت عملة الزر الخاص بي لكنني لا أراه محدَّثاً على الموقع

الإلكتروني.

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

لا يمكنني تحديد "استخدام رسم الشحن من الإعدادات" و"استخدام معدل الضريبة من

الإعدادات" عندما أحدد "لا تسجل عنوان الشحن".

يعتمد خيار رسوم الشحن والضريبة من الإعدادات على الرمز البريدي للشحن و/أو الدولة الخاصة بالعميل. إذا حددت "لا تسجل عنوان الشحن"، فلن تتلقى عنوان الشحن الخاص بالعميل للسماح بحساب رسوم الشحن والضريبة من الإعدادات. نوصي باستخدام خيارات أخرى من القائمتين المنسدلتين "رسم الشحن" و"نسبة الضريبة".