AI-translated from English; not yet reviewed by a fluent editor.

# تضيف Shopify أدوات لوكيل المتصفح داخل صفحة الدفع، مع اشتراط موافقة المشتري

> يتيح إصدار Shopify الصادر في 28 سبتمبر لوكيل متصفح قراءة صفحة الدفع النشطة للمشتري وتحديثها. ويتطلب إرسال الطلب أن يراجع المشتري الإجمالي الحالي ويؤكده؛ كما تظل عدة أنواع من عمليات الدفع مستثناة.

By BIG CHANGE Editorial

Published: 2026-09-28T22:34:31.965Z
Updated: 2026-09-28T22:34:31.965Z
Canonical: https://bigchange.ai/blog/shopify-webmcp-browser-agent-checkout

![Conceptual charcoal illustration of a shopper reviewing a generic checkout on a laptop at a kitchen counter, with a hand poised on the trackpad.](https://bigchange.ai/api/media/file/shopify-checkout-buyer-review-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

تتجاوز أدوات التسوق بالذكاء الاصطناعي من Shopify سلة المشتريات الآن لتصل إلى صفحة الدفع. ففي [سجل المطورين الصادر في 28 سبتمبر](https://shopify.dev/changelog/posts/webmcp-support-for-checkout)، قالت الشركة إن وكيل المتصفح يستطيع قراءة صفحة الدفع المفتوحة في علامة تبويب المشتري وتحديثها، ثم إرسال الطلب بعد أن يؤكده المشتري. وكانت أدوات المتجر السابقة قادرة على نقل المتسوق إلى صفحة الدفع؛ أما الأدوات الجديدة فتتيح للوكيل التعامل مع حقول الدفع.

## التغيير الأبرز

- **ما الذي تغيّر:** أصبح بإمكان وكيل المتصفح التعامل مع صفحة الدفع التي يراها المشتري، بما في ذلك بيانات الاتصال وخيارات التوصيل والخصومات. وكانت أدوات المتجر التي أطلقتها Shopify في أغسطس تقتصر على الانتقال إلى صفحة الدفع؛ أما إصدار سبتمبر فيضيف أدوات للدفع داخل علامة التبويب نفسها.
- **لماذا يهم ذلك:** يستطيع المتسوق تفويض مزيد من العمل على النموذج مع الاحتفاظ بالسيطرة على الطلب وإجماليه. وتشترط Shopify أن يعرض الوكيل كليهما وأن يحصل على الإذن قبل إرسال الطلب. ويظل تسجيل الدخول وتحديات الدفع وبعض خطوات المراجعة من مسؤولية المشتري على الصفحة.
- **ما الذي ينبغي متابعته:** الحد العملي للمطورين هو أهلية الاستخدام. تستثني Shopify عدة أنواع من عمليات الدفع، وتقول إن دعم وكلاء المتصفح لا يزال مقتصراً على Chromium. وتحدد هذه الشروط ما إذا كان الوكيل يستطيع استخدام الأدوات الجديدة لعملية شراء معينة.

## من المتجر إلى صفحة الدفع

في [إصدار 5 أغسطس](https://shopify.dev/changelog/posts/webmcp-liquid-hydrogen)، أتاحت Shopify أدوات WebMCP في جميع المتاجر المبنية على Liquid، وكذلك في متاجر Hydrogen ضمن معاينة المطورين. ويمكن لوكيل متوافق في متصفح المتسوق البحث عن المنتجات وفحص خياراتها وقراءة سلة التسوق المباشرة وتحديثها واستدعاء `proceed_to_checkout`. وتقول Shopify إن أدوات المتجر لا تتطلب من التاجر تثبيتاً أو إعداداً. وتستخدم تغييرات السلة إجراءات المتجر القياسية، لذلك يراها المتسوق في جلسته النشطة.

أما إضافة سبتمبر فتعمل في صفحة الدفع. ويكتشف الوكيل الأدوات المسجلة عبر `document.modelContext.getTools()` ويستدعيها عبر `document.modelContext.executeTool()`. وتقول Shopify إن قائمة أدوات الدفع قد تتغير مع انتقال المشتري عبر خطوات الدفع، لذا ينبغي للوكلاء تحديثها عند إطلاق `toolchange`. تعمل الأدوات على صفحة الدفع المفتوحة في علامة التبويب. ولا تتلقى معرّفاً لعملية الدفع، كما أنها منفصلة عن نقطة النهاية Checkout MCP من Shopify المخصصة للعمل على الخادم.

لكل أداة من أدوات الدفع وظيفة محددة. `get_checkout` تقرأ الحالة الحالية، بما فيها الإجماليات والرسائل وإيصال الطلب في صفحة «شكراً لك». `update_checkout` تغيّر بيانات اتصال المشتري وخيار تنفيذ الطلب ورموز الخصم والحقول المعلنة وخيارات الدفع المدعومة. وتستخدم دلالات الاستبدال: على الوكيل قراءة الحالة الحالية أولاً ثم إرسال الحالة الكاملة التي يريد الإبقاء عليها. ولا يمكنه تغيير بنود الطلب أو مصدر الإحالة من خلال أداة الدفع هذه؛ بل يغيّر المشتري البنود على الصفحة. `navigate_to_storefront` تعيد علامة التبويب إلى المتجر إذا كان لديه متجر إلكتروني.

تحدد أمثلة Shopify إصدار UCP لعملية الدفع بأنه `2026-08-25`. هذا هو إصدار البروتوكول في الاستجابات الموثقة، أما 28 سبتمبر فهو تاريخ إصدار أدوات الدفع للمتصفح. وتتضمن الاستجابة حالة نتيجة UCP وحالة دورة حياة الدفع. فعلى سبيل المثال، `ready_for_complete` تعني أن عملية الدفع جاهزة لمحاولة إتمامها؛ ولا تعني أن المشتري وافق على الشراء. وتقول Shopify إن `completed` وحدها تؤكد الطلب.

## المشتري هو من يتحكم في الإرسال

قبل استدعاء `complete_checkout`، توجّه Shopify الوكيل إلى عرض الطلب الحالي وإجماليه والحصول على إذن المشتري لإتمامه. وإذا تغيّر الإجمالي، يلزم تأكيد جديد. ولا تمنح حالة الجاهزية أو توقيع Web Bot Auth أو موافقة Shop Pay ذلك الإذن.

حتى بعد الاستدعاء، قد تتطلب الصفحة تدخّل المشتري. إذ تعيد خطوة المراجعة المهيأة الحالة `requires_escalation`؛ ولا يستدعي الوكيل `complete_checkout` مجدداً إلا بعد أن يأذن المشتري بالإرسال هناك. وفي حال وجود تحدٍ للدفع أو أي إجراء آخر من المشتري، يُكمل المشتري الخطوة في صفحة الدفع ويتحقق الوكيل من الحالة الناتجة. كما تترك Shopify تسجيل الدخول إلى Shop Pay والتفاعلات التي تحددها التطبيقات ضمن إضافات الدفع للمشتري. هذه عملية دفع بمساعدة الوكيل، مع حد واضح لموافقة المشتري عند إرسال الطلب.

## الوصول والقيود

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

لا تُسجّل الأدوات على صفحة الدفع القياسية ذات الخطوات الثلاث إلا إذا استخدم المشتري Shop Pay. كما لا تدعم الدفع بين الشركات (B2B)، أو الدفع المضمّن، أو حزم تطوير الدفع للأجهزة المحمولة، أو عمليات الدفع التي تتضمن بضاعة من متجر آخر، أو الطلبات المسودة، أو تعديلات الطلبات، أو تحصيل المدفوعات. ويقتصر دعم WebMCP لوكلاء المتصفح حالياً على المتصفحات المبنية على Chromium. ويشير مرجع الدفع من Shopify أيضاً إلى تفصيل في المتصفح قد يتغير: ففي Chrome 153، تقبل `executeTool()` الوسائط على هيئة سلاسل JSON، بينما تخطط Chrome لقبول الكائنات في Chrome 155.

لا تذكر صفحات WebMCP التي تستشهد بها Shopify سعراً منفصلاً لهذه الأدوات. وما زالت صفحة الدفع تعرض إجمالي الشراء ليتمكن المشتري من مراجعته. راجعت BIG CHANGE ملاحظات إصدار Shopify ووثائقها، لكنها لم تختبر متجراً مباشراً أو تنفذ عملية شراء.

## المصادر ومزيد من القراءة

- [سجل تغييرات Shopify لأدوات WebMCP في صفحة الدفع، 28 سبتمبر](https://shopify.dev/changelog/posts/webmcp-support-for-checkout) يؤرخ لإضافة أدوات الدفع الجديدة للمتصفح ويشرح تسليم الخطوة إلى المشتري.
- [مرجع Shopify لأدوات Checkout WebMCP](https://shopify.dev/docs/agents/carts-and-checkout/checkout-webmcp) يوثق اكتشاف الأدوات والأدوات الأربع وأمثلة UCP `2026-08-25` وسياق تأكيد المشتري وWeb Bot Auth وسلوك المتصفح. هذا عرض للوثائق، وليس اختباراً أجرته BIG CHANGE.
- [دليل Shopify للسلال والدفع](https://shopify.dev/docs/agents/carts-and-checkout) يقارن الدفع في المتصفح بخدمة Checkout MCP على الخادم ويسرد أنواع الدفع المستثناة.
- [سجل تغييرات Shopify لأدوات المتاجر، 5 أغسطس](https://shopify.dev/changelog/posts/webmcp-liquid-hydrogen) و[مرجع WebMCP للمتاجر](https://shopify.dev/docs/api/web-mcp) يوثّقان أدوات الكتالوج والسلة والانتقال إلى الدفع التي أُضيفت سابقاً، وقيد دعم Chromium.

## Sources

- [Shopify: دعم WebMCP لصفحة الدفع](https://shopify.dev/changelog/posts/webmcp-support-for-checkout) — يؤرخ لأدوات الدفع الجديدة في المتصفح ويشرح شرط تأكيد المشتري.
- [Shopify: Checkout WebMCP](https://shopify.dev/docs/agents/carts-and-checkout/checkout-webmcp) — اكتشاف المتصفح وسلوك الأدوات وأمثلة UCP المؤرخة في 2026-08-25 وWeb Bot Auth وموافقة المشتري والأخطاء.
- [Shopify: السلال والدفع للوكلاء](https://shopify.dev/docs/agents/carts-and-checkout) — يقارن الدفع عبر المتصفح والدفع عبر الخادم ويحدد أنواع الدفع المستثناة.
- [Shopify: دعم WebMCP لمتاجر Liquid وHydrogen](https://shopify.dev/changelog/posts/webmcp-liquid-hydrogen) — يؤرخ لأدوات المتجر السابقة وإمكان الانتقال إلى صفحة الدفع.
- [Shopify: أدوات WebMCP](https://shopify.dev/docs/api/web-mcp) — يحدد مجموعة أدوات المتجر وشروط الأهلية وقيد دعم Chromium لوكلاء المتصفح.