مركز المساعدة - حساب شخصي

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

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

  • تحقّق من عمل الاتصال بالإنترنت لديك.
  • تفضّل بزيارة صفحات أخرى في موقعك الإلكتروني وتحقّق من تحميلها بشكل صحيح.
  • انتقل إلى صفحة أزرار PayPal وتحقّق مما يلي:
  • هل يظهر الزر ضمن "الأزرار المحفوظة"؟
  • حدد تعديل وتأكد من أن رمز الزر يطابق الرمز يطابق ما على موقعك الإلكتروني.
  • انقر بزر الماوس الأيمن على صفحة منتجك (حيث لصقت رمز الزر) وانقر على فحص. انتقل إلى علامة تبويب "وحدة التحكم" (سترى علامة التبويب هذه في الأعلى). قد تظهر لك أخطاء سياسة أمان المحتوى (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 ('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 الخاص بك

سياسة-حماية-المحتوى: 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

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

إليك كيفية تغيير تخطيط/ حجم/ لون اسم المنتج/ السعر/ الكمية على موقع PayPal:

  1. انتقل إلى صفحة أزرار PayPal.
  2. انقر فوق فتح بجانب الزر المحفوظ وحدد تحرير.
  3. انقر فوق تخصيص الأزرار الخاصة بك وقم بإجراء أي تغييرات ضرورية.

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

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

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

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

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

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

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

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

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

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

لدي حساب Premier 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://developer.paypal.com/api/nvp-soap/ipn/IPNIntro/

تأكد من استخدام عنوان URL الصحيح لإشعار الدفع الفوري (IPN) في رمز الخادم

نماذج للغات مختلفة GitHub - paypal/ipn-code-samples

عند إرسال عميل إلى صفحة إعادة التوجيه، ما المعلومات التي ترسلها 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 بمعرف الزر الفعلي.

<style> #paypal-container-<HostedButton_ID> {

                #paypal-form-fields-container-<HostedButton_ID> {

                                 #price-label {

                                                 display: none !important;

                                }

                }

 

}

</style>

                   

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

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

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

style> #paypal-container-

{ #paypal-form-fields-container-

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

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

<style>

#paypal-container-<HostedButton_ID>

{

                #paypal-form-fields-container-<HostedButton_ID>

                {

                                display: none !important;

                }

}

</style>


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

الإعدادات؟"

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

image

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

الإلكتروني.

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

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

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

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

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

نعم. إليك كيفية تمكين خطافات الويب:

  1. سجل الدخول إلى لوحة تحكم المطور باستخدام بيانات اعتماد حساب التاجر الخاص بك.
  2. التبديل إلى الوضع المباشر.
  3. انقر على التطبيقات وبيانات الاعتماد.
  4. قم بالتمرير لأسفل وحدد إدارة خطافات الويب.
  5. يمكنك الآن إضافة عنوان URL لخطاف الويب للوضع المباشر. إذا كنت ترغب في إضافة خطافات الويب لـ Sandbox، فابق في هذه الصفحة وقم بالتبديل من الوضع المباشر إلى Sandbox من الزاوية اليمنى العليا.
  6. أضف عنوان URL لرد اتصال خطافات الويب، وحدد جميع الأحداث أو الدفع الإلكتروني، وأحداث الدفع التي سيتم استدعاؤها بواسطة PayPal عند الأحداث المحددة اعتماداً على تنفيذ واجهة برمجة تطبيقات NVP أو SOAP لديك تستدعي واجهة برمجة تطبيقات PayPal NVP/SOAP للحصول على معلومات خطاف الويب.

نموذج استجابة خطاف الويب:

"المعرف": "WH-12D11567VE3425924-2G120938U32719946", 
 "event_version": "1.0", 
 "create_time": "2024-09-14T15:55:58.043Z", 
 "resource_type": "تحصيل", 
 "resource_version": "2.0", 
 "event_type": "تم إكمال تحصيل الدفع"،
  "ملخص": "اكتمل دفع مبلغ 128.88 دولاراً أمريكياً"، 
 "المورد": { 
 "supplementary_data": { 
 "related_ids": { 
 "order_id": "8LM68409BR5528307" 
 } 
 ]، 
 "المعرف": "7KK30254642170736"، 
 "الحالة": "مكتملة" 

الموضوعات المتصلة

وسائل أخرى يمكننا مساعدتك بها

سنستخدم ملفات تعريف الارتباط لتحسين وتخصيص تجربتك عند التصفح. هل تقبل أن نستخدم ملفات تعريف الارتباط أيضاً لعرض إعلانات مخصصة بك؟ معرفة المزيد وإدارة ملفات تعريف الارتباط