فهم الخطأ: كيان غير قابل للمعالجة
عندما يتعذر إكمال طلب مدفوعاتك بسبب معلومات غير صحيحة أو انتهاكات لقواعد النشاط التجاري. قد تؤدي المشكلات التالية إلى حدوث خطأ UNPROCESSABLE_ENTITY.
- رقم الفاتورة مكرر
- الطلب مفوض به بالفعل
- تم تحصيل الطلب بالفعل
- لم يوافق على الطلب
- عنوان الشحن غير صالح
ملاحظة: إذا استمرت المشكلة أو إذا كانت لديك أسئلة أخرى، يمكنك التواصل مع paypal-techsupport.com.
رقم الفاتورة مكرر
المرتجعات من واجهات برمجة تطبيقات 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 للموافقة على المدفوعات. تأكد من أن طلبك يتضمن جميع بيانات الدفع المطلوبة.
عنوان الشحن غير صالح
المرتجعات من واجهات برمجة تطبيقات v1 للمدفوعات أو الطلبات v2. راجع عنوان الشحن مستند مطور غير صالح .
السبب:
ربما فاتت للعميل حقول عنوان مهمة مثل عنوان الشارع أو المدينة أو الولاية. ربما يكون تنسيق العنوان غير صحيح، أو قد لا يرسل نظامك العنوان الكامل في الطلب بشكل صحيح.
التأثير
رفضت الدفعة ولم تتم معالجتها، مما تسبب في تأخير الشراء.
حل النزاعات
أضف التحقق من صحة النموذج لضمان اكتمال جميع حقول العنوان المطلوبة بشكل صحيح قبل الإرسال. فكر في استخدام أدوات تصديق العناوين لضمان اتباع العناوين للتنسيق الصحيح. تحقق من أنظمتك للتأكد من التقاط جميع معلومات العنوان وتضمينها بشكل صحيح في طلباتك.