ما هو x402؟ بروتوكول الدفع HTTP 402 لوكلاء الذكاء الاصطناعي
x402 بروتوكول دفع مفتوح يضع المدفوعات داخل طلبات الويب العادية. عندما يطلب تطبيقٌ موردًا مدفوعًا، يرد الخادم برمز الحالة HTTP 402 (Payment Required) وبسعر. فيوقّع التطبيق، وهو غالبًا وكيل ذكاء اصطناعي، دفعة بعملة مستقرة، عادةً USDC، ثم يرسل الطلب نفسه مرة أخرى ومعه الدفعة. لا حاجة إلى إنشاء حساب ولا إلى إدارة مفتاح API ولا إلى صفحة دفع.
يشرح هذا الدليل خطوة بخطوة كيف يعمل x402، والمصطلحات التي ستراها في مواصفاته، وما الذي تغيّر في x402 V2، والشبكات التي يعمل عليها، وكم يكلّف، ومتى تكون صفحة الدفع العادية بالعملات الرقمية خيارًا أفضل. لا تقدم OrcaRail اليوم مدفوعات عبر x402، ونوضح في آخر المقال ما تقدمه بدلًا من ذلك.
ما هو x402
يقدّم x402 نفسه معيارًا مفتوحًا ومحايدًا للمدفوعات الأصلية على الإنترنت (x402.org). وتشرحه وثائق x402 من Coinbase بشكل أدق: يتيح x402 للخادم أن يتقاضى ثمن مورد في الطلب نفسه الذي يُجلب به هذا المورد (الأسئلة الشائعة عن x402).
يأتي الاسم من رمز الحالة HTTP 402، أي Payment Required. يعرّف معيار HTTP هذا الرمز لكنه يتركه دون استخدام، إذ ينص على أنه "محجوز للاستخدام المستقبلي" (RFC 9110). ويمنح x402 هذا الرمز وظيفة حقيقية.
- من أنشأه. بدأت Coinbase العمل على x402 (إعلان Cloudflare وCoinbase)، وأُطلق البروتوكول في مايو 2025 (إعلان x402 V2).
- من يديره اليوم. في 14 يوليو 2026 أعلنت مؤسسة لينكس (Linux Foundation) الإطلاق التشغيلي لمؤسسة x402 (x402 Foundation)، وهي هيئة ذات حوكمة مفتوحة أُنشئت لرعاية بروتوكول x402 الذي قدّمته Coinbase (الإعلان).
- أين الشيفرة. في github.com/x402-foundation/x402، بترخيص Apache-2.0، مع حزم SDK للغات TypeScript وPython وGo.
معلومات البروتوكول في هذا المقال مأخوذة من x402.org ومستودع مؤسسة x402 والأسئلة الشائعة عن x402 من Coinbase، وقد راجعناها في 12 نوفمبر 2026.
كيف يعمل x402 خطوة بخطوة
يصف المستودع المسار المعتاد. باختصار:
- يطلب التطبيق (العميل) موردًا، مثل
GET /api/report. - يرد الخادم بـ
402 Payment Required. تسرد الترويسةPAYMENT-REQUIREDخيارات الدفع التي يقبلها: المخطط (scheme) والشبكة والرمز والمبلغ وعنوان الدفع. - يختار العميل أحد الخيارات ويوقّع دفعة بمحفظته.
- يرسل العميل الطلب نفسه مرة أخرى، ومعه الدفعة الموقّعة في الترويسة
PAYMENT-SIGNATURE. - يتحقق الخادم من الدفعة، بنفسه أو باستدعاء نقطة النهاية
/verifyلدى وسيط دفع (facilitator). - ينفّذ الخادم العمل ويسوّي الدفعة على البلوكشين، بنفسه أو عبر نقطة النهاية
/settleلدى الوسيط. - يرد الخادم بـ
200 OKمع المورد وترويسةPAYMENT-RESPONSEالتي تحمل نتيجة التسوية.
إذا كان العميل يعرف السعر مسبقًا، يمكنه تخطي الجولة الأولى والدفع مع أول طلب.
هكذا يبدو الأمر على الشبكة. قيمة كل ترويسة هي JSON مرمّز بـ base64:
GET /api/report HTTP/1.1
Host: api.example.com
HTTP/1.1 402 Payment Required
PAYMENT-REQUIRED: <price, network, token and pay-to address>
GET /api/report HTTP/1.1
Host: api.example.com
PAYMENT-SIGNATURE: <the signed payment>
HTTP/1.1 200 OK
PAYMENT-RESPONSE: <settlement result>
مصطلحات x402: العميل والخادم والوسيط والمخطط
| المصطلح | معناه |
|---|---|
| العميل (Client) | التطبيق أو السكربت أو وكيل الذكاء الاصطناعي الذي يدفع. يحتاج إلى محفظة فيها رصيد من رمز ما، عادةً USDC. |
| خادم المورد (Resource server) | واجهة API أو الموقع الذي يتقاضى المال. يرد على الطلبات غير المدفوعة بـ 402 وبسعر. |
| الوسيط (Facilitator) | خادم يتولى التحقق من المدفوعات وتنفيذها على شبكة واحدة أو أكثر. وجوده اختياري: يستطيع خادم المورد التحقق من المدفوعات وتسويتها بنفسه. |
| المخطط (Scheme) | طريقة الدفع. يسرد المستودع exact (مبلغ ثابت، مثل دولار واحد لقراءة مقال)، وupto (يسمح العميل بحد أقصى ويسوّي البائع الاستخدام الفعلي حتى هذا الحد)، وbatch-settlement (على EVM فقط: تسوية رسوم صغيرة كثيرة على البلوكشين على دفعات). |
ما الذي تغيّر في x402 V2
يسرد إعلان V2 والأسئلة الشائعة من Coinbase هذه التغييرات:
- ترويسات جديدة. تحل
PAYMENT-REQUIREDوPAYMENT-SIGNATUREوPAYMENT-RESPONSEمحلX-PAYMENTوX-PAYMENT-RESPONSEفي V1. وصارت كل بيانات الدفع تنتقل في الترويسات، بينما كان V1 يرسل متطلبات الدفع في جسم الاستجابة. - أسماء شبكات موحّدة. تستخدم الشبكات معرّفات CAIP-2، فمعرّف Base هو
eip155:8453، وتُكتب شبكة Solana بالشكلsolana:متبوعًا بالـ genesis hash الخاص بها. - الجلسات. يضيف V2 هوية مبنية على المحفظة، حتى لا تحتاج إلى الدفع من جديد في كل استدعاء.
- الإضافات والمكونات. تصل الميزات الجديدة كإضافات (extensions) دون تغيير المواصفات. ومن أمثلتها Discovery التي تتيح لخدمات x402 نشر بيانات وصفية يمكن للوسطاء فهرستها. وفي حزم SDK تُضاف الشبكات والرموز والمخططات كمكونات (plugins).
- التوافق مع الإصدار السابق. حزم SDK المرجعية متوافقة تمامًا مع V1.
ما الشبكات والرموز التي يدعمها x402
يقول x402.org إن البروتوكول لا يرتبط ببلوكشين بعينه، وإنه يدعم كل السلاسل المتوافقة مع EVM وSolana وغيرها، وإن الدفع بالعملات المستقرة (stablecoins) هو الاستخدام الرئيسي. وهو مصمم أيضًا ليتوسع إلى وسائل الدفع التقليدية.
ما يعمل فعليًا يعتمد على الوسيط الذي تستخدمه. فالوسيط المستضاف من Coinbase مثلًا يسوّي المدفوعات على الشبكات الرئيسية لـ Base وPolygon وArbitrum وMonad وWorld وSolana (الأسئلة الشائعة). ويقبل رموز ERC-20 على شبكات EVM هذه، ورموز SPL أو Token-2022 على Solana. أما الرموز التي تطبّق EIP-3009، مثل USDC وEURC، فتُسوّى دون أن يحتاج المشتري إلى رمز لدفع رسوم الغاز. وتمر رموز ERC-20 الأخرى عبر Permit2، وقد يضيف ذلك موافقة لمرة واحدة يدفع المشتري غازها.
كم يكلّف x402
- رسوم البروتوكول: لا شيء. يذكر x402.org أن البروتوكول بلا رسوم، وأنه مجاني للعميل والتاجر، ولا يدفعان إلا رسوم شبكة الدفع الزهيدة.
- رسوم الشبكة. كل تسوية معاملة على البلوكشين، ولا بد أن يدفع أحدٌ غازها. يدفعه وسيط Coinbase ويغطيه بالسعر الذي يتقاضاه عن كل معاملة.
- رسوم الوسيط. يحدد كل وسيط رسومه. يجعل وسيط Coinbase أول 1,000 معاملة كل شهر مجانية، ثم يتقاضى 0.001 دولار عن كل معاملة. والتحقق مجاني.
x402 مقابل بوابة الدفع بالعملات الرقمية
| x402 | بوابة الدفع بالعملات الرقمية | |
|---|---|---|
| من يدفع | برنامج: وكيل ذكاء اصطناعي أو سكربت أو تطبيق لديه محفظة | أشخاص، على صفحة دفع |
| متى يتم الدفع | داخل طلب HTTP، مع كل استدعاء | عند الشراء، لكل طلب أو لكل فترة فوترة |
| التسعير | لكل طلب: مبلغ محدد أو حتى سقف معيّن | طلبات وفواتير واشتراكات |
| كيف يتم الدفع | يوقّع العميل برمجيًا، دون صفحة | يدفع الشخص من محفظته على صفحة دفع مستضافة |
| كيف يعرف الخادم لديك بالدفع | ترويسة PAYMENT-RESPONSE في الطلب نفسه | الـ webhooks ولوحة التحكم |
| OrcaRail اليوم | غير متاح | نعم |
الاثنان يحلان مشكلتين مختلفتين. يناسب x402 واجهات API والبيانات والمحتوى الذي تشتريه البرامج بنفسها، طلبًا بعد طلب. وتناسب بوابة الدفع البيع للأشخاص: صفحة منتج أو فاتورة أو خطة شهرية.
لمن يناسب x402
- مزودو واجهات API والبيانات الذين يريدون التحصيل عن كل استدعاء دون حسابات أو مفاتيح API.
- مطورو وكلاء الذكاء الاصطناعي الذين يجب أن يدفع وكلاؤهم بأنفسهم ثمن الأدوات أو البيانات أو المحتوى.
- الناشرون الذين يريدون التحصيل عن كل مقال أو كل طلب بدلًا من الاشتراك.
إذا كان عملاؤك أشخاصًا يشترون منتجات أو خططًا أو خدمات، فما زالت صفحة الدفع المستضافة هي الطريق الأبسط. يتوقع الناس صفحة دفع وإيصالًا وطريقة لإدارة اشتراكهم.
كيف تبدأ مع x402
- اقرأ المواصفات في مستودع مؤسسة x402 واختر مخططًا. المخطط
exactهو الأبسط. - ثبّت حزمة SDK. يسرد ملف README حزم TypeScript تحت
@x402/، وحزمة Python (pip install x402)، ووحدة Go. - اختبر على شبكة تجريبية أولًا، مثل Base Sepolia (
eip155:84532). يوضح دليلنا عن صنابير شبكات الاختبار من أين تحصل على USDC تجريبية مجانًا. - اختر وسيطًا، أو تحقق من المدفوعات وسوّها في خادمك.
- انتقل إلى الشبكة الرئيسية عندما تتم تسوية الدفعات التجريبية كما تتوقع، مع محفظة تتحكم فيها كعنوان لاستلام الدفع.
ما الذي تقدمه OrcaRail بدلًا من ذلك
لا تدعم OrcaRail بروتوكول x402 اليوم. إنها بوابة دفع بالعملات الرقمية للبيع للأشخاص. يدفع عملاؤك على صفحة دفع مستضافة (payment intents)، أو عبر رابط دفع، أو من خلال اشتراك، بـ USDC أو USDT أو رموز أخرى على شبكات EVM وSolana وBitcoin. وتُحوَّل كل دفعة إلى محافظك الخاصة. تتقاضى OrcaRail 0.5% لكل معاملة مكتملة، وأول 100 معاملة مجانية (الأسعار).
ومع ذلك، يمكن لوكلاء الذكاء الاصطناعي إدارة هذه المدفوعات نيابة عنك. يتيح خادم MCP من OrcaRail لـ Claude Code وCursor وCodex إنشاء صفحات دفع واشتراكات من طلب نصي (prompt)، ويشرح مقال مدفوعات وكلاء الذكاء الاصطناعي كيف تربطه في بيئة تجريبية. ولبناء تكامل بمساعدة وكيل برمجة، أعطه llms.txt وراجع البناء بالذكاء الاصطناعي.
تريد تحصيل USDC من عملائك اليوم؟ راجع كيف تقبل مدفوعات USDC.
الأسئلة الشائعة
من أين جاء اسم x402؟
من رمز الحالة HTTP 402، أي Payment Required، الذي يحجزه معيار HTTP للاستخدام المستقبلي. وx402 بروتوكول وليس عملة: المدفوعات تنقل رموزًا موجودة أصلًا، معظمها عملات مستقرة مثل USDC.
هل استخدام x402 مجاني؟
البروتوكول نفسه بلا رسوم. لكنك تدفع رسوم الشبكة، وقد يتقاضى الوسيط رسومًا على التحقق من المدفوعات وتسويتها. فوسيط Coinbase مثلًا يجعل أول 1,000 معاملة كل شهر مجانية، ثم يتقاضى 0.001 دولار عن كل معاملة (بحسب ما راجعناه في 12 نوفمبر 2026).
هل يعمل x402 على Solana؟
نعم. يذكر x402.org سلاسل EVM وSolana، ووسيط Coinbase يسوّي المدفوعات على شبكة Solana الرئيسية. وفي V2 تُسمّى شبكة Solana بالشكل solana: متبوعًا بالـ genesis hash الخاص بها.
أين مستودع x402 على GitHub؟
في github.com/x402-foundation/x402، بترخيص Apache-2.0. أصبح المستودع الأقدم coinbase/x402 نسخة تطوير متفرعة (fork)، وانتقلت قضاياه وطلبات الدمج فيه إلى مستودع مؤسسة x402.
هل تدعم OrcaRail بروتوكول x402؟
ليس اليوم. تقدم OrcaRail صفحات دفع مستضافة وروابط دفع واشتراكات للأشخاص الذين يدفعون بـ USDC وUSDT ورموز أخرى، وخادم MCP يتيح لوكلاء الذكاء الاصطناعي إنشاء هذه المدفوعات نيابة عنك.
ابدأ في البيئة التجريبية · مدفوعات وكلاء الذكاء الاصطناعي · الأسعار