الشراء وإعادة المحاولة

مرجع واحد لكل عملية شراء مقصودة

المرجع حساس لحالة الأحرف، وطوله من 1 إلى 100 حرف. يقبل الحروف الإنجليزية والأرقام والنقطة والشرطة السفلية والنقطتين والشرطة. يقبل الشراء partnerReference وsku فقط، ولا يتطلب ترويسة Idempotency-Key.

تعيد المحاولة المطابقة الطلب الأصلي مع replayed: true. إعادة استخدام المرجع مع SKU مختلف تعيد HTTP 409 والرمز 6220. لا تستخدم متغيراً عشوائياً يتجدد مع كل طلب لهذا الحقل.

استرجع نتيجة غير مؤكدة

بعد انتهاء المهلة أو انقطاع الاتصال أو خطأ الخادم، احتفظ بالمرجع والمحتوى الأصليين. استعلم عبر GET /orders/by-reference/{partnerReference}. إذا ظلت النتيجة غير معروفة، أعد إرسال المحتوى نفسه. المرجع الجديد يعني عملية شراء جديدة.

تابع حالة الطلب

PROCESSING: التنفيذ لم يُحسم، ويشمل الطلبات التي تنتظر المراجعة؛ التزم بـpollAfterSeconds. COMPLETED: نجح التنفيذ؛ اقرأ بيانات البطاقة من التفاصيل. FAILED: وصل الطلب إلى حالة فشل نهائية. أوقف الاستعلام التلقائي عند الوصول إلى حالة نهائية.

استخدم supportReference وrequestId عند تصعيد طلب طويل المعالجة إلى قيفتو. قد تبقى منتجات البيع النهائي في PROCESSING للمراجعة؛ لا تفترض إمكانية استرداد طلب غير محسوم أو إعادة شرائه.