ابدأ التكامل / GiftU Partner API
أول طلب API
تحقق من الاتصال في TEST، ثم نفّذ عملية شراء بمرجع ثابت يمكنك استخدامه بأمان عند إعادة المحاولة.
1. جهّز صلاحية TEST
احصل على مفتاح pk_test_ عبر القناة الآمنة المتفق عليها. احفظه في خادمك باسم GIFTU_PARTNER_API_KEY. إذا كانت قائمة IP مفعّلة، اطلب من قيفتو السماح بعنوان خروج خادمك.
2. أرسل طلب ping
استدعِ GET /ping. تتضمن الاستجابة الناجحة status: "ok" وmode: "TEST". تستخدم البيئتان عنوان API نفسه، ويحدد المفتاح البيئة.
3. اختر منتجاً وتحقق من الرصيد
استدعِ GET /products واستخدم SKU من الكتالوج المتاح لك. تحقق من GET /products/{sku}/price وGET /balance قبل الشراء. رموز SKU في أمثلة المرجع توضيحية؛ استبدلها بقيم الكتالوج.
4. اشترِ البطاقة وتابع النتيجة
أرسل POST /orders بالحقلين partnerReference وsku فقط. استخدم مرجعاً ثابتاً وفريداً مثل TEST-SUCCESS:order-001. انتهاء المهلة لا يعني فشل الشراء: استعلم بالمرجع أو أعد إرسال المحتوى نفسه.
توجد خلاصة عملية الشراء في data.order.order، بينما توجد خلاصة الاستعلام عن الطلب في data.order. عندما تكون الحالة PROCESSING، انتظر pollAfterSeconds قبل الاستعلام مجدداً.
تفضّل Postman؟
استورد مجموعة TEST. ضع partnerApiKey في بيئة خاصة، وحدد sku، واستبدل partnerReference بقيمة ثابتة وفريدة. احتفظ بالمرجع وSKU نفسيهما لإعادة المحاولة، واختر مرجعاً جديداً فقط لعملية شراء جديدة.