النهج الموصى به
استخدم كتلةsync — وليس webhook.ecommerce القديمة.
المرجع الكامل: دليل المزامنة.
التدفق النموذجي
- يثبّت المستأجر ميني أبك من السوق.
- يخزّن OAuth أو مفتاح API بيانات الاعتماد على تثبيت المستأجر.
- تصل ويب هوك المزوّد إلى
POST /miniapps/{ns}/webhooks. - تربط المعالجات الحمولات إلى سجلات تجارة كرزون.
- تستخدم الأتمتة المشغّلات (مثل
order.created) لسير العمل.
ما يجب تضمينه في تعريفك
- مصادقة تطابق المنصة — OAuth 2.0 مع
auto_refresh: trueعند وجود رموز تحديث؛ HTTP Basic (Basic [[key]]:[[secret]]) لمفاتيح REST بأسلوب WooCommerce؛ ترويسات مخصصة لرموز Shopify Admin — انظر المصادقة webhook.verification— استراتيجية HMAC أو رمز من مزوّدكwebhook.customerExtraction— ربط حقول المشتري بعملاء كرزونsync.resources— المنتجات والعملاء والطلبات حسب الحاجةsync.webhooks.handlers— ربطات إنشاء/تحديث لكل حدثtriggers— واحد لكل حدث ظاهر في الأتمتة
webhook.ecommerce القديمة
webhook.ecommerce مهملة. يجب أن تستخدم التقديمات الجديدة sync. قد ترفض كرزون التعريفات التي تعتمد فقط على الكتلة القديمة.
إذا كنت تصون تكاملاً قديماً، تواصل مع دعم كرزون لمراجعة الترحيل.
الشركاء
يجب على شركاء التجارة (Salla وZid وMatjrah وWooCommerce) أيضاً قراءة برنامج الشركاء لتدفقات العلامة البيضاء والتأهيل المضمّن.Shopify
يتصل Shopify عبر Shop Domain + Admin API Access Token + API Secret Key.- ترويسة المصادقة:
X-Shopify-Access-Token - HMAC للويب هوك:
X-Shopify-Hmac-Sha256معencoding: 'base64' - تُطبَّع المواضيع من
orders/create→order.created(إلخ) - مزامنة الكتالوج الجماعية معطّلة افتراضياً (يستخدم Shopify ترقيم صفحات cursor/
Link)؛ عمليات upsert الفورية عبر الويب هوك مفعّلة - البحث حسب SKU يستخدم Admin GraphQL
productVariants
WooCommerce
يتصل WooCommerce عبر Consumer Key + Consumer Secret + Store URL (مفاتيح REST API). يتضمن إجراءات البحث بالبريد/SKU/رقم الطلب، وHMAC للويب هوك (encoding: 'base64')، ومزامنة الكتالوج.
- المصادقة: HTTP Basic عبر
Authorization: 'Basic [[consumerKey]]:[[consumerSecret]]'(يشفّر وقت التشغيلkey:secretبـ Base64) — انظر المصادقة → HTTP Basic Auth - HMAC للويب هوك:
X-WC-Webhook-Signatureمعencoding: 'base64'