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

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

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

سياسة-حماية-المحتوى: 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://www.sandbox.paypal.com/merchantnotification/ipn/history
• https://www.paypal.com/merchantnotification/ipn/history

المراجع

المقدمة: https://developer.paypal.com/api/nvp-soap/ipn/IPNIntro/

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

• Sandbox https://www.sandbox.paypal.com/cgi-bin/webscr
• الوضع المباشر https://www.paypal.com/cgi-bin/webscr

نماذج للغات مختلفة 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 بمعرف الزر الفعلي.

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

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

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

style> #paypal-container-

{ #paypal-form-fields-container-

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

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

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

الإعدادات؟"

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

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

الإلكتروني.

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

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

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

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

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

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

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"، 
"الحالة": "مكتملة"