Shopify يوسّع دعم WebMCP إلى عملية الدفع للوكالات المتصفح

قامت Shopify بتمديد أدوات وكيل WebMCP إلى عملية الدفع، مما يسمح للوكالات الذكاء الاصطناعي القائمة على المتصفح بقراءة وتحديث عمليات الدفع على Shopify وتقديم الطلبات بعد تأكيد المشتري. أعلنت الشركة عن التغيير في منشور سجل التغييرات للمطورين بتاريخ 28 سبتمبر 2026، على فهرس سجل التغييرات الخاص بـ Shopify.

تسرد الإعلان أربعة أدوات يمكن للوكالات استدعاؤها عند عملية الدفع: get_checkout, التي تقرأ حالة عملية الدفع والرسائل وتفاصيل الطلب بعد إكماله؛ update_checkout, التي تُحدّث الحقول المدعومة في عملية الدفع؛ complete_checkout, التي تُرسل عملية الدفع بعد تأكيد المشتري؛ و navigate_to_storefront, التي تعيد علامة التبويب إلى واجهة المتجر. تعمل الأدوات على عملية الدفع النشطة في جلسة المتصفح الخاصة بالمشتري وتعيد التحكم إلى المشتري عندما يُطلب إدخال، مثل مصادقة 3D Secure أو حجب امتدادات واجهة المستخدم. تُشغَّل داخل checkout-web، وتستخدم نفس حالة واجهة الدفع، ولا تُظهر أي واجهة برمجة تطبيقات جديدة، ولا تتطلب أي إعداد من التاجر.

مع توفر أدوات الواجهة والمتجر الآن، صرّحت Shopify بأن الوكالات المتصفح يمكنها الآن مساعدة رحلة التسوق الكاملة على منصتها، من اكتشاف المنتجات وإدارة سلة التسوق مرورًا بعملية الدفع وتأكيد الطلب. تخدم الأدوات الوكالات التي يجلبها المتسوقون إلى المتجر في متصفحهم الخاص.

كيف تعمل أدوات عملية الدفع

تُنفّذ Checkout WebMCP قدرة الدفع UCP (dev.ucp.shopping.checkout) عبر أدوات WebMCP المسجلة في المتصفح بدلاً من JSON‑RPC على الخادم، وتشارك كائن عملية الدفع والحالات والرسائل مع Checkout MCP، النظير الخادمي لـ Shopify، وفقًا لـ وثائق Checkout WebMCP. يكتشف الوكالات الأدوات باستخدام document.modelContext.getTools() وتستدعيها باستخدام document.modelContext.executeTool()، مع تمرير الوسائط كسلاسل JSON؛ تشير الوثائق إلى أن Chrome 153 يرفض وسائط الكائنات وأن Chrome يخطط لقبول الكائنات في Chrome 155.

get_checkout تقرأ عملية الدفع الحالية دون تعديلها، وتعيد كائن الدفع UCP بالقيم المالية كأعداد صحيحة بوحدة العملة الصغرى. بالنسبة لمشتري Shop Pay، تُدرج البطاقات المحفوظة القابلة للاستخدام تحت payment.instruments، وعلى صفحة الشكر تُعيد إيصال الطلب. update_checkout تحل محل تفاصيل اتصال المشتري، والتنفيذ، ورموز الخصم، والحقول المعلنة، والدفع. تستخدم دلالة PUT، لذا يجب على الوكيل إرسال الحالة الكاملة المطلوبة المُبنية من get_checkout استجابة، وتتجاهل عناصر السطر والنسب لأن المشتري يغيّر العناصر على الصفحة. تُظهر الحقول المعلنة الإضافات التي تم جمعها خلال عملية الدفع، مثل رقم الضريبة (تشير الوثائق إلى CPF أو CNPJ البرازيلي) وعلم ائتمان المتجر، عبر امتداد Shopify إلى UCP.

complete_checkout تضع الطلب بعد تأكيد المشتري له. إذا فتحت عملية الدفع خطوة مراجعة، يراجع المشتري الطلب على الصفحة ويستدعي الوكيل complete_checkout مرة أخرى فقط بعد أن يصرّح المشتري بالإرسال؛ إذا كان هناك تحدي دفع أو إجراء آخر مطلوب من المشتري، يكمل المشتري ذلك على صفحة الدفع في نفس علامة التبويب. فقط حالة completed تؤكد الطلب. navigate_to_storefront تغادر عملية الدفع دون وضع طلب أو تغيير السلة، تُسجَّل فقط عندما يكون للمتجر واجهة متجر إلكترونية، وتظل متاحة على صفحة الشكر. لا تمتلك Checkout WebMCP ما يعادل أداة Checkout MCP’s cancel_checkout الأداة، لذا لا تكون حالة عملية الدفع أبدًا canceled.

تأكيد المشتري، الدفع، ومصادقة الوكيل

تُرشد الوثائق الوكالات للحصول على إذن المشتري قبل وضع طلب: “قبل أن تستدعي complete_checkout، اعرض على المشتري الطلب الحالي والإجمالي، واحصل على إذنه لوضعه,” تقول الوثائق، مضيفةً أن Web Bot Auth، وموافقة Shop Pay، و ready_for_complete الحالة لا تمنح ذلك الإذن، وأنه يجب على الوكيل أن يطلب الإذن مرة أخرى إذا تغير الإجمالي.

لا تقبل Checkout WebMCP تفاصيل بطاقة جديدة. حسب عملية الدفع، payment.instruments تقبل بطاقة Shop Pay المحفوظة لمشتري Shop Pay، أو موافقة Shop Pay لعملية دفع كضيف تقبل الموافقات، أو عنوان الفوترة فقط؛ يختار المشتري أي طريقة دفع أخرى مباشرةً على صفحة الدفع.

يجب على الوكالات توقيع طلبات المتصفح باستخدام Web Bot Auth بدلاً من وسائط الأداة، وتتحقق Shopify فقط من المفاتيح المسجلة. يتطلب التسجيل إنشاء مفتاح توقيع Ed25519، واستضافة المفتاح العام في دليل مفاتيح، ونشر ذلك الدليل مع Shopify؛ بدون Web Bot Auth، قد تُخفض آلية اكتشاف الروبوتات في Shopify أولوية أو تحظر طلبات الوكيل. كما تحذر الوثائق الوكالات من اعتبار النصوص الخاصة بالتاجر أو الطرف الثالث في استجابات الأدوات كبيانات دفع بدلاً من تعليمات، لأن هذه النصوص قد تحتوي على محاولات حقن أوامر، وتُخبر الوكالات بعدم التحايل على أداة عن طريق تشغيل عناصر التحكم في الصفحة بأنفسهم.

التوفر ومعيار WebMCP

يقوم Checkout بتسجيل الأدوات فقط على عمليات الدفع المؤهلة. توثيق توثيق السلال ومراحل الدفع الخاص بـ Shopify يسرد عمليات الدفع التي لا تُسجل فيها الأدوات: عملية الدفع القياسية ذات الثلاث صفحات ما لم يقم المشتري بالدفع عبر Shop Pay؛ عملية دفع B2B؛ الدفع المدمج وعمليات الدفع في SDKs الخاصة بالدفع عبر الجوال؛ عمليات الدفع التي تحتوي على سلع من متجر آخر؛ وأوامر المسودة، وتعديلات الطلب، وجمع المدفوعات. تتعامل تفاعلات امتدادات الدفع المعرفة بالتطبيق أيضًا مع المشتري على صفحة الدفع. توصي Shopify باستخدام Checkout MCP للوكالات التي يمكن تشغيلها على خادم وتوجه المطورين إلى Checkout WebMCP فقط عندما تكون الوكالة تعمل بالفعل في متصفح المشتري.

أطلقت Shopify أولاً أدوات WebMCP للواجهات Liquid و Hydrogen في 5 أغسطس 2026، في منشور سجل التغييرات يغطي بحث الكتالوج (search_catalog, browse_store, get_product, show_variant)، إدارة السلة (get_cart, update_cart, cancel_cart)، وتسليم عملية الدفع (proceed_to_checkout, manage_orders). تلك الأدوات متاحة على كل واجهة Liquid وعلى معاينة مطوري Hydrogen دون الحاجة إلى تثبيت أو تكوين. وفقًا لـ توثيق WebMCP للواجهة، بعد proceed_to_checkout، تستبدل عمليات الدفع المؤهلة أدوات الواجهة بأدوات الدفع، ويتم توجيه الوكالات لتحديث قائمة أدوات المتصفح على صفحة الدفع.

WebMCP هو معيار ويب مقترح يتيح للصفحة تسجيل أدوات مع المتصفح، ودعم الوكالات محدود حاليًا على المتصفحات القائمة على Chromium عبر تجربة أصلية. صرحت Shopify بأنها تساعد في تشكيل مواصفة WebMCP جنبًا إلى جنب مع Google و Microsoft.