فهم الخطأ: كيان غير قابل للمعالجة
عندما يتعذر إكمال طلب مدفوعاتك بسبب معلومات غير صحيحة أو انتهاكات لقواعد النشاط التجاري. قد تؤدي المشكلات التالية إلى حدوث خطأ UNPROCESSABLE_ENTITY.
- بطاقة منتهية الصلاحية
- رقم الفاتورة مكرر
- الطلب مفوض به بالفعل
- تم تحصيل الطلب بالفعل
- لم يوافق على الطلب
- إعادة توجيه الدافع للتمويل البديل
- انتهت صلاحية البطاقة المرجعية
- عنوان الشحن غير صالح
- لم يتم العثور على معرف مفتاح الحماية
ملاحظة: إذا استمرت المشكلة أو إذا كانت لديك أسئلة أخرى، يمكنك التواصل مع paypal-techsupport.com.
بطاقة منتهية الصلاحية
المرتجعات من واجهات برمجة تطبيقات طلبات PayPal v2 أو واجهات برمجة تطبيقات v1 للمدفوعات. راجع مستند مطور البطاقات منتهية الصلاحية .
السبب:
يحدث هذا الخطأ عندما يحاول عميل الدفع ببطاقة ائتمان أو سحب اجتاز تاريخ انتهاء صلاحيتها. لا يمكن استخدام بطاقة منتهية الصلاحية لإجراء أي مشتريات.
التأثير
تتوقف الدفعة فورا ولن يستطيع العميل استكمال مشترياته. إذا لم تتم معالجته بسرعة ، فقد تفقد عملية البيع.
دقة
- أظهر للعميل رسالة توضح انتهاء صلاحية بطاقته.
- ساعده في إدخال بطاقة مختلفة عبر PayPal أو منصة PayPal Commerce Platform.
- تقديم تعليمات بسيطة للتبديل إلى وسيلة دفع أخرى لإتمام مشترياته.
رقم الفاتورة مكرر
المرتجعات من واجهات برمجة تطبيقات v1 للمدفوعات أو الطلبات v2. راجع مستند مطور رقم تعريف الفاتورة مكرر.
لأن
PayPal يكتشف رمز فاتورة مكررا. تحتاج كل معاملة إلى invoice_id فريد لمنع المعاملات المكررة. ويحدث هذا عادة عند استخدام نفس رقم الطلب في معاملات متعددة.
التأثير
تتوقف عملية الدفع، مما يمنع عميلك من إتمام عملية الشراء. هذا يمكن أن يؤدي إلى فقدان المبيعات.
حل النزاعات
استخدم رقم تعريف فاتورة مختلفا لكل معاملة. إذا كنت بحاجة إلى استخدام رمز الفاتورة نفسه بشكل متكرر، فاتصل بالدعم PayPal. ضع في اعتبارك إعداد إشعارات الدفع الفوري (IPNs) أو خطافات الويب للحصول على تحديثات فورية حول المعاملات.
الطلب مفوض به بالفعل
المرتجعات من واجهات برمجة تطبيقات v2 للمدفوعات أو الطلبات v2. ارجع إلى مستند المطور "طلب التفويض بالفعل".
السبب
: الطلب مفوض به بالفعل من خلال طلب سابق. عند إنشاء طلب باستخدام intent="AUTHORIZE"، يسمح بتفويض واحد فقط. سترفض محاولة ثانية. قد يحدث ذلك إذا أرسلت الطلب نفسه مرتين عن طريق الخطأ، أو إذا فاتك رؤية نجاح الطلب الأول.
التأثير
لن يكون هناك أي تأثير على التفويض الأصلي. تم رفض المحاولة الثانية فقط. لا يمكنك تفويض مبلغ جزئي الآن، وتفويض بالباقي لاحقا.
حل النزاعات
فوض المبلغ بالكامل في طلب واحد، ثم أنشئ عمليات تحصيل متعددة حسب الحاجة. أنشئ عمليات تحصيل متعددة عن طريق تعيين final_capture="false" في طلبات الالتقاط. هذا مفيد للشحنات المقسمة. ضع في اعتبارك دمج خطافات الويب PayPal لتلقي تحديثات حول حالة الطلب تلقائيا. إذا كانت الاتصالات بخدمة واجهة برمجة التطبيقات تستغرق وقتا طويلا، فاتصل PayPal الدعم الفني.
تم تحصيل الطلب بالفعل
المرتجعات من واجهة برمجة تطبيقات الطلبات v2. ارجع إلى مستند المطور "الطلب الذي تم تحصيله بالفعل".
السبب:
الطلب PayPal في حالة "تم التحصيل" بالفعل، مما يعني أن الدفع قد اكتمل وتم تحويل المبالغ المالية إلى حسابك. لا يمكن إنشاء أي لقطات جديدة على هذا الترتيب. يحدث هذا إذا كنت تستخدم intent="SALE" الذي يسمح بالتقاط واحد فقط لكل طلب، أو إذا لم يسجل نظامك نجاح محاولة الالتقاط الأولى ويحاول مرة أخرى.
التأثير
إذا كنت قد حصلت على جزء فقط من مبلغ الطلب، فلن تتمكن من تحصيل المبلغ المتبقي إلا إذا قمت بإنشاء طلب PayPal جديد. لن يتأثر عميلك إذا كنت تنوي الحصول على لقطة واحدة فقط، ولكن قد يكون نظامك غير متزامن مع سجلات PayPal.
حل المشكلة إذا كنت تريد عمليات التقاط متعددة، فاستخدم intent="AUTHORIZE" بدلا من intent="SALE".
يؤدي هذا إلى إنشاء تفويض أولا ، مما يسمح بعمليات تحصيل متعددة بعد ذلك. تأكد من تعيين معلمة final_capture على false في تحصيلك الاتصال بخدمة API للمدفوعات المصرح بها للسماح بعمليات تحصيل إضافية. استخدم nvoice_id iفريدا لكل لقطة. تتبع استجابات واجهة برمجة التطبيقات الناجحة لتجنب تكرار المكالمات. ضع في اعتبارك استخدام خطافات الويب PayPal لتلقي تحديثات تلقائية حول تغييرات حالة الدفع.
لم يوافق على الطلب
المرتجعات من واجهات برمجة تطبيقات v1 للمدفوعات أو الطلبات v2. ارجع إلى مستند مطور الطلب غير المعتمد .
السبب:
بدأ عميلك عملية الدفع الإلكتروني ولكنها لم يكمل PayPal، أو ربما يكون هناك نقص في الطلب لمعلومات الدفع المطلوبة.
التأثير
رفضت الدفعة ولم تتم معالجتها، مما تسبب في تأخير الشراء.
حل النزاعات
تأكد من إعادة توجيه عميلك إلى عنوان URL "rel":"موافقة" الذي توفره PayPal عند إنشاء طلب. يأخذهم هذا إلى مسار الدفع PayPal للموافقة على المدفوعات. تأكد من أن طلبك يتضمن جميع بيانات الدفع المطلوبة.
لم يتم تفعيل المستفيد لمعالجة البطاقة
المرتجعات من واجهة برمجة تطبيقات الطلبات v2. راجع مستند المطور غير المفعل لمعالجة البطاقات .
السبب:
يظهر هذا الخطأ عندما لا يكون حسابك معدا لقبول مدفوعات بطاقات الائتمان/السحب. لن تكتمل المدفوعات حتى تفعل مدفوعات البطاقات في حسابك. قد يظهر هذا الخطأ أيضا إذا لم تكن قد استكملت جميع خطوات قبول المدفوعات باستخدام PayPal المدفوعات المكتملة.
التأثير
لا يستطيع عملاؤك إكمال مشترياتهم عندما يحاولون الدفع بالبطاقة. قد يؤدي هذا إلى خسارة المبيعات إذا لم يتم إصلاحه بسرعة. سيؤثر هذا في كل عملائك الذين يحاولون الدفع بالبطاقة، وليس في شخص واحد فقط.
حل النزاعات
تأكد أنك استكملت جميع خطوات الإعداد المطلوبة. إذا كنت تستخدم PayPal مدفوعات مكتملة، فحاول إجراء الإعداد مجددا وتأكد من تحديد خيار مدفوعات البطاقات. إذا كنت لا تزال تواجه مشكلات ، فاتصل بالدعم الفني PayPal . إذا كان شخص آخر يدير إعداد حسابك على PayPal، فاطلب منه الاتصال PayPal مباشرة لتفعيل مدفوعات البطاقات في حسابك.
إعادة توجيه الدافع للتمويل البديل
المرتجعات من واجهات برمجة تطبيقات v1 للمدفوعات أو الطلبات v2. راجع مستند مطور إعادة توجيه الدافع للحصول على التمويل البديل.
السبب:
يظهر هذا الخطأ عندما تواجه مشكلة في طريقة الدفع التي اختارها العميل في محفظته PayPal.
التأثير
لا يستطيع عملاؤك إكمال مشترياتهم عندما يحاولون الدفع بالبطاقة. قد يؤدي هذا إلى خسارة المبيعات إذا لم يتم إصلاحه بسرعة. سيؤثر هذا في كل عملائك الذين يحاولون الدفع بالبطاقة، وليس في شخص واحد فقط.
دقة
- أظهر لعميلك رسالة توضح أن مدفوعاته لم تكتمل وأن عليه اختيار وسيلة دفع أخرى.
- أعد توجيهه إلى الدفع PayPal حتى يتمكن من تحديد خيار دفع آخر.
- إذا استمرت المشاكل ، فاقترح عليه محاولة الدفع ببطاقة ائتمان بدلا من ذلك.
- إذا كان لا يزال يواجه مشكلة في حسابه، فننصحك بالاتصال PayPal مباشرة بشأن حسابه.
- استخدم تعليمات بسيطة وواضحة لمساعدة عميلك في إتمام عملية الشراء بسلاسة.
انتهت صلاحية البطاقة المرجعية
المرتجعات من واجهات برمجة تطبيقات الطلبات v2 أو Vault v3. راجع مستند مطور البطاقة المرجعية منتهية الصلاحية .
السبب:
يحدث هذا الخطأ عندما يحاول المشتري الدفع باستخدام بطاقة ائتمان أو سحب محفوظة، ولكن انتهت صلاحية البطاقة المسجلة. ولهذا السبب، لا يمكن معالجة الدفعة. سيتعين على المشتري استخدام بطاقة مختلفة أو اختيار طريقة دفع أخرى لإنهاء عملية الشراء.
التأثير
يتوقف الدفع ولا يستطيع المشتري استكمال طلبه. إذا لم يتم إصلاح هذا بسرعة، فقد تفقد عملية البيع.
دقة
- تفعيل محدث الحساب في الوقت الفعلي (RTAU): إذا كنت تستخدم PayPal مدفوعات مكتملة مع بطاقات ائتمان وسحب متقدمة، فقم بتشغيل محدث الحساب في الوقت الفعلي (RTAU). تعمل هذه الميزة تلقائيا على تحديث بطاقات عملائك المحفوظة بتواريخ انتهاء صلاحية جديدة كلما تم تجديد بطاقاتهم، مما يساعد على تجنب أخطاء البطاقات منتهية الصلاحية.
- اعرض رسالة الخطأ بوضوح: أخبر عميلك بأن صلاحية بطاقته المحفوظة قد انتهت.
- تحديث مفتاح الدفع المحفوظ: عندما تتلقى رمز حماية جديد للدفع من العميل، حدثه في نظامك. تأكد من حذف مفتاح الحماية القديم منتهي الصلاحية من سجلاتك وخزينة PayPal.
- إن إعطاء تعليمات واضحة وبسيطة للعميل سيساعده على إتمام الدفع بسهولة، مما يقلل من فرصة تخليه عن عملية الشراء.
عنوان الشحن غير صالح
المرتجعات من واجهات برمجة تطبيقات v1 للمدفوعات أو الطلبات v2. راجع مستند المطور عنوان الشحن غير صالح .
السبب:
ربما فاتت للعميل حقول عنوان مهمة مثل عنوان الشارع أو المدينة أو الولاية. ربما يكون تنسيق العنوان غير صحيح، أو قد لا يرسل نظامك العنوان الكامل في الطلب بشكل صحيح.
التأثير
لا يستطيع عميلك إكمال عملية الشراء، مما قد يؤدي إلى خسارة عملية بيع إذا لم يتم إصلاحها بسرعة.
حل النزاعات
أضف التحقق من صحة النموذج لضمان اكتمال جميع حقول العنوان المطلوبة بشكل صحيح قبل الإرسال. فكر في استخدام أدوات تصديق العناوين لضمان اتباع العناوين للتنسيق الصحيح. تحقق من أنظمتك للتأكد من التقاط جميع معلومات العنوان وتضمينها بشكل صحيح في طلباتك.
لم يتم العثور على معرف مفتاح الحماية
المرتجعات من واجهات برمجة تطبيقات V1 أو طلبات v2.راجع مستند المطور لمعرف الرمز المميز.
السبب:
يحدث هذا الخطأ عندما يتعذر PayPal التعرف على رمز تعريف الرمز المميز المقدم أثناء الدفع الإلكتروني. الأسباب الشائعة هي أن الرمز المميز قد يكون به خطأ إملائي ، أو أن الحساب الذي يقدم الطلب قد لا يكون لديه الإذن المناسب لاستخدام الرمز المميز.
التأثير
عند حدوث هذا الخطأ، تتوقف عملية الدفع ولا يستطيع العميل إكمال عملية الشراء. إذا لم يتم إصلاح هذا بسرعة، فقد يؤدي ذلك إلى فقدان المبيعات.
التحقق
من التصاريح للتأكد من أن الحساب PayPal الصحيح قد منح التصاريح اللازمة. راجع أيضا الكود الخاص بك للتأكد من أن رمز الحماية لم يتغير عن طريق الخطأ. إذا كان الرمز مشفر غير صالح أو منتهي الصلاحية، فأنشئ رمزا جديدا واستخدمه في طلبك.