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 المسماة 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 عبر تجربة Origin Trial. صرحت Shopify بأنها تساعد في تشكيل مواصفة WebMCP جنبًا إلى جنب مع Google و Microsoft.