Skip to main content

نظرة عامة

بعد التحقق من توفر المنتج، قدّم طلب بطاقة الهدية عبر endpoint الطلب. يستدعي الطلب الناجح إرجاع معرّف الطلب الذي ستستخدمه لتتبع الحالة.
تحقق دائماً من المخزون والرصيد قبل تقديم الطلب لتجنب الأخطاء.

مرجع API

POST /v3/gift-cards/placeOrder

التوثيق الكامل للـ endpoint

تقديم طلب أساسي

مثال على الاستجابة

معالجة الأخطاء

أفضل الممارسات

التحقق أولاً

تحقق دائماً من المخزون والرصيد قبل تقديم أي طلب

مرجعيات فريدة

أنشئ ref فريداً لكل طلب لتجنب التكرار

تخزين orderId

احفظ orderId فوراً في قاعدة البيانات بعد نجاح الطلب

بدء الاستعلام

ابدأ استعلام الحالة فور تقديم الطلب بنجاح

الخطوات التالية

تتبع الحالة

استعلام حالة الطلب حتى اكتماله

التسليم الآمن

تسليم البطاقات بأمان للعملاء

مرجع API

التوثيق الكامل للـ endpoint