رسمي للمطورين

اربط متجرك بالوكلاء الذين يؤكدون طلبياته

ترسل واجهة رسمي البرمجية طلبيات الدفع عند الاستلام إلى وكلاء التأكيد، وتخبر نظامك بنتيجة كل مكالمة ثم كل توصيل. مفتاح واحد لكل متجر، وواجهة REST، وويبهوك موقّع.

التوثيق التقني متاح باللغة الإنجليزية.

  • مفتاح API واحد لكل متجر
  • 19 حدثاً عبر الويبهوك، موقّعة
  • REST وJSON، 60 طلباً في الدقيقة
ما تقدّمه الواجهة

أربعة مداخل إلى متجرك

استعمل واحداً منها أو الأربعة معاً. لكل منها صفحاته في التوثيق، مع أمثلة بـ cURL وPHP وJavaScript وPython.

الطلبيات

أرسل الطلبية إلى قائمة الاتصالات، وصحّح بيانات الزبون، وتابع سجلّها، وألغِها قبل شحنها.

اعرف المزيد

ويبهوك لكل مرحلة

التأكيد والإلغاء والشحن والتوصيل والإرجاع: يصل كل تغيير إلى خادمك خلال ثوانٍ، موقّعاً بسرّك.

اعرف المزيد

المنتجات والمخزون

اقرأ منتجاتك مع متغيراتها، وحدّث المخزون دفعة واحدة، حتى 100 منتج في الطلب الواحد.

اعرف المزيد

استخدام واضح أمامك

الطلبات والأخطاء وأزمنة الاستجابة وإرسالات الويبهوك الخاصة بمفتاحك، في صفحة مفتاح API بلوحة التحكم.

اعرف المزيد
البداية

من صفحة الشراء إلى طلبية مؤكَّدة

أربع خطوات، وتصل أول طلبية إلى وكلائك.

  1. 1

    احصل على مفتاح المتجر

    أنشئه من صفحة مفتاح API في لوحة التحكم. مفتاح واحد لكل متجر، يظهر مرة واحدة.

  2. 2

    أرسل الطلبية

    يضعها الطلب POST /orders في قائمة اتصالات وكلائك، بانتظار التأكيد.

  3. 3

    يتصل الوكيل

    لا تصبح الطلبية «تم التأكيد» إلا بعد مكالمة ردّ عليها الزبون.

  4. 4

    تصلك النتيجة

    يخبر الويبهوك خادمك بالنتيجة، ثم بالشحن والتوصيل.

ابدأ بالدليل السريع

دون برمجة

تبيع على منصة متاجر؟

اربطها من لوحة التحكم ببضع نقرات: تتزامن الطلبيات والمنتجات والمخزون وحدها، وتعود نتائج وكلائك إلى المنصة.

  • Shopify
  • WooCommerce
  • YouCan
  • Lightfunnels
  • Tassyir
  • CodPilot
  • Google Sheets
الأسئلة الشائعة

أسئلة يطرحها المطورون

هل الواجهة البرمجية مدفوعة؟

لا. الواجهة البرمجية والويبهوك متاحان لكل متجر، ولا يدفع التاجر للمنصة أي رسوم. يدفع فقط لوكلائه العمولة المكتوبة في العقد.

من يمكنه إنشاء مفتاح API؟

صاحب المتجر، من صفحة مفتاح API في لوحة التحكم. لكل متجر مفتاح واحد، وإعادة توليده تستبدل السرّ ويتوقف القديم فوراً.

ماذا يمكنني أن أفعل بالواجهة البرمجية؟

إرسال الطلبيات وتصحيحها، ومتابعة سجلّها، وقراءة المنتجات وتحديث المخزون، وإضافة العملاء المحتملين، وإدارة الويبهوك الذي يخبر خادمك بكل تغيير.

كيف أعرف أن الوكيل أكّد الطلبية؟

اشترك في حدث order.confirmed عبر الويبهوك، أو اقرأ حالة الطلبية. لا تُؤكَّد الطلبية إلا بعد مكالمة ردّ عليها الزبون.

هل هناك حدّ لعدد الطلبات؟

نعم: 60 طلباً في الدقيقة لكل مفتاح. استعمل الويبهوك بدل الاستعلام المتكرر، وحدّث المخزون دفعة واحدة.

بأي لغة التوثيق؟

بالإنجليزية، مع أمثلة بـ cURL وPHP وJavaScript وPython. أما هذه الصفحة فمتاحة بالعربية والفرنسية والإنجليزية.

جاهز لربط متجرك؟

أنشئ حساب بائع مجاناً، وولّد مفتاح API لمتجرك، ثم اتبع الدليل السريع.