دليل تكامل سلة
اربط متجر سلة الخاص بك بـ ZaLinkAI ومكّن وكلاء الذكاء الاصطناعي من الوصول الكامل لنظام سلة.
مصادقة OAuth 2.0
يوفر سلة تدفق OAuth 2.0 قياسي لتفويض التطبيقات الخارجية بأمان.
بدء التفويض
أعد توجيه التاجر إلى شاشة موافقة OAuth الخاصة بسلة مع app_id و redirect_uri والنطاقات. أضف معامل state لحماية CSRF.
التاجر يوافق على الوصول
يراجع التاجر الأذونات المطلوبة (المنتجات، الطلبات، العملاء، السلات، webhooks) ويمنح الوصول لمتجره.
رد التفويض
يعيد سلة التوجيه إلى عنوان الرد الخاص بك مع رمز تفويض. تحقق من تطابق معامل state مع طلبك الأصلي.
تبادل الرموز
استبدل رمز التفويض برموز الوصول والتحديث عبر نقطة نهاية رموز سلة. يقوم ZaLinkAI بتشفير وتخزين الرموز بـ AES-256.
قدرات المنصة
كل ما يمكن لوكلاء الذكاء الاصطناعي تحقيقه من خلال تكامل سلة.
إدارة المنتجات
- مزامنة كاملة لكتالوج المنتجات
- تتبع المخزون وتنبيهات النفاد
- دعم متغيرات وخيارات المنتج
- إدارة الصور والأصول الإعلامية
معالجة الطلبات
- إنشاء وقراءة وتحديث الطلبات
- إدارة حالة التنفيذ
- معالجة الإرجاع والاسترداد
- ملاحظات الطلب والتعليقات الداخلية
ملفات العملاء
- بيانات العملاء ومعلومات الاتصال
- سجل المشتريات والتفضيلات
- الوصول لمجموعات وفئات العملاء
- إدارة دفتر العناوين
أحداث Webhook
- إشعارات الطلبات الفورية
- أحداث تغيير المنتجات
- تتبع نشاط العملاء
- أحداث دورة حياة التطبيق
السلة والدفع
- الوصول لواجهة سلة التسوق
- إنشاء روابط دفع آمنة
- تطبيق الكوبونات والخصومات
- حساب أسعار الشحن
RTL والتوطين
- دعم واجهة RTL أصلي
- معالجة محتوى عربي أولاً
- دعم عملات دول الخليج
- بيانات منتج ثنائية اللغة
بوابات الدفع في الشرق الأوسط
يتكامل سلة مع مزودي الدفع المحليين المنتشرين في دول الخليج.
مدى
شبكة بطاقات الخصم السعودية، مستخدمة على نطاق واسع للمعاملات المحلية.
STC Pay
محفظة إلكترونية من STC، شائعة للدفع السريع في السعودية.
تابي
خدمة اشتر الآن وادفع لاحقاً متاحة في دول الخليج.
تمارا
حل الدفع بالتقسيط لسوق الشرق الأوسط.
Apple Pay
دفع لاتلامسي مدعوم لمتاجر سلة.
مُيسر
بوابة دفع تدعم طرق دفع سعودية متعددة.
استكشاف الأخطاء
المشكلات الشائعة وحلولها لتكامل سلة.
invalid_client
بيانات اعتماد التطبيق (client_id أو client_secret) غير صحيحة.
تحقق من بيانات تطبيق شريك سلة. أعد إنشاء السر من لوحة تحكم شركاء سلة إذا لزم الأمر.
access_denied
رفض التاجر طلب التفويض.
يجب أن يوافق التاجر على جميع النطاقات المطلوبة. تأكد من طلب الأذونات التي يحتاجها تطبيقك فقط.
refresh_token_expired
تجاوز رمز التحديث فترة صلاحيته.
اطلب من التاجر إعادة التفويض. يقوم ZaLinkAI تلقائياً بتحديث الرموز قبل 30 دقيقة من انتهاء الصلاحية.
rate_limit_exceeded
عدد كبير جداً من طلبات API في فترة قصيرة.
طبّق تراجعاً أسياً. يسمح سلة بـ 100 طلب/دقيقة لكل متجر. تحقق من رؤوس X-RateLimit.