Skip to main content
POST
تقديم طلب

نظرة عامة

أنشئ طلبات لبطاقات الهدايا والمنتجات الرقمية. تُسلَّم البطاقات رقمياً عبر endpoint الـ /checkOrder.
قبل الطلب: تحقق من المخزون عبر /checkProduct وتحقق من رصيد الحساب.

جسم الطلب

string
مطلوب
معرف المنتج من /catalog
string
مطلوب
معرف النوع من /checkProduct
integer
مطلوب
عدد البطاقات للطلب (الحد الأدنى: 1)

أمثلة

استجابة النجاح

قائمة التحقق قبل الطلب

1

التحقق من المخزون

2

التحقق من الرصيد

3

تقديم الطلب

4

الاستعلام عن البطاقات

ردود الخطأ

معاملات طلب غير صالحة
المنتج نفد من المخزون
رصيد غير كافٍ

المعالجة

الطلبات نهائية بمجرد تقديمها. احفظ orderId فوراً.
تُعالَج معظم الطلبات في غضون ثوانٍ. استعلم عن /checkOrder/:orderId كل 5 إلى 10 ثوانٍ حتى تصبح الحالة FULFILLED أو REFUNDED.

روابط ذات صلة

التحقق من الطلب

الحصول على البطاقات عند الاكتمال

التحقق من المنتج

التحقق من المخزون أولاً