
لا يتطلب تحصيل رسوم مقابل واجهة API أو مجموعة بيانات أو صفحة مميزة أو أداة MCP تحويل كل مورد إلى صفحة دفع تقليدية. فمع x402، يستطيع تدفق HTTP نفسه أن يُعلم بأن الدفع مطلوب، ويصف الخيارات المقبولة، ويتيح لعميل متوافق أن يأذن بالوصول. لكن التحدي الحقيقي أكبر من إرجاع حالة 402: إنه تصميم القواعد والتحقق والتنفيذ والتسوية والقياس والمطابقة دون ترك الخادم الأصلي (origin) مكشوفًا.
يشرح هذا الدليل كيف تفكر في Monetization Gateway قابل للتشغيل البيني مع x402، مستندًا إلى إعلان Cloudflare والوثائق الحالية للبروتوكول كمرجع تقني. ولا يدّعي المقال أن جميع القدرات الموصوفة متاحة لدى AZPay أو Cloudflare لأي حساب. يجب التأكد من التوافر والشبكة والأصل والوسيط (facilitator) والشروط التجارية في البيئة المختارة.
ما الذي يحلّه x402
يتضمن HTTP بالفعل الحالة `402 Payment Required`، لكنه لم يحدد وحده تاريخيًا كيف يُبلغ الخادم عن السعر أو الشبكة أو الأصل أو المستفيد أو التفويض. يضيف x402 كائنات وترويسات تتيح للخادم وصف المتطلبات وللعميل إعادة تفويض موقَّع. وفي الإصدار 2، تستخدم الاستجابة `PAYMENT-REQUIRED` ويستخدم الطلب المدفوع `PAYMENT-SIGNATURE`، وكلاهما يحمل بيانات مرمّزة بصيغة Base64.
التدفق الأساسي بسيط. يطلب العميل المورد. فتردّ البوابة بـ 402 مع خيارات الدفع. يختار العميل خيارًا ويوقّع التفويض ويعيد إرسال الطلب. تتحقق البوابة أو الوسيط من التفويض، ويُنفَّذ المورد وفق دلالات المخطط (scheme)، وتُسوّى الدفعة. وبعد ذلك فقط يتلقى العميل الاستجابة المميزة.
هذه البساطة قوية لأنها تعمل في القناة نفسها التي تعمل فيها واجهة API. لكنها لا تحوّل أي متصفح إلى محفظة، ولا تُسقط المسؤوليات المتعلقة بالهوية والتفويض وحماية الخادم الأصلي والدعم.
Monetization Gateway طبقة تحكم، لا مجرد جدار دفع
على بوابة تحقيق الدخل أن تجيب عن خمسة أسئلة لكل طلب: ما المورد الذي يُطلب الوصول إليه، ومن يحق له الوصول، وكم يكلّف، وكيف سيُتحقق من الدفع، وماذا يحدث بعد التنفيذ. ويمكن للقاعدة أن تجمع بين النطاق والمسار وطريقة HTTP والجمهور والترويسات والمعاملات وسمات الجهة المتصلة.
يجب أن يحتفظ مستوى التحكم بالموارد والخوادم الأصلية والقواعد ذات الإصدارات ومحافظ الاستلام والشبكات والبيئات وأحداث التدقيق. أما مستوى البيانات فيقيّم القاعدة على الحافة، ويعيد 402 عند الحاجة، ويحمي الخادم الأصلي، ويسجّل وقائع الدورة. ويتيح الفصل بين المستويين نشر سياسة جديدة دون إعادة نشر كل تطبيق، لكنه يتطلب لقطات ذات إصدارات وأولوية صريحة وإمكانية التراجع.
المحرر الجيد يميّز بين المسارات المدفوعة وغير المُحقِّقة للدخل. ويُظهر كذلك أي قاعدة طُبّقت، ولماذا سُمح بطلب أو حُظر، وفي أي بيئة يكون التحصيل مفعّلًا. يجب أن تغيّر أزرار النشر والتراجع إعدادًا حقيقيًا؛ فالشاشة التي تبدو فقط كأنها تعمل تخلق مخاطر على المنتج والمالية.
`exact` و`upto`: سعر ثابت وسقف للاستهلاك
في المخطط `exact`، يجب أن يطابق المبلغ المأذون به السعر المطلوب. وهو مناسب لصفحة أو استدعاء API أو أداة يكون سعرها معروفًا قبل التنفيذ.
في نموذج `upto`، يأذن العميل بمبلغ حتى سقف معيّن، ويمكن للخادم الإبلاغ عن المبلغ المستهلك فعليًا، متى دعم التنفيذ والوسيط هذه الدلالة. وهذا مفيد للتسعير بحسب الرموز (tokens) أو البايتات أو السجلات المُعادة أو المعالجة المتغيرة، لكنه يتطلب قياسًا موثوقًا. السقف ليس رخصة لتحصيل أي مبلغ: يجب أن يبلّغ الخادم الأصلي عن الاستهلاك الحقيقي، وأن تمنع البوابة التسوية من تجاوز التفويض.
لا تخلط بين التسعير لكل طلب والاشتراك أو الرصيد المدفوع مسبقًا أو الفوترة اللاحقة. لكل نموذج حالاته ومطابقته الخاصة. والعملية الناضجة تسجّل النية والتفويض والتحقق والتنفيذ والمبلغ المقيس والتسوية والاستجابة المُسلَّمة وأي إخفاق بوصفها وقائع مترابطة، لا عمودًا واحدًا بعنوان «مدفوع».
يبقى الخادم الأصلي داخل نموذج الأمان
يقلل التحقق من الدفع على الحافة العبء عن الخادم الأصلي، لكنه لا يجيز تجاوزه. يجب أن تمنع البوابة الوصول المباشر الذي يتخطاها، وأن تحافظ على السياق اللازم، وأن ترسل عند الاقتضاء سياقًا موقّعًا يتحقق منه الخادم الأصلي. فإذا كان الخادم الأصلي لا يثق إلا في ترويسة يستطيع أي عميل تزويرها، يبقى المورد المميز مكشوفًا.
ثمة فرق مهم بين ترويسات x402 الموجهة إلى العميل والترويسات الداخلية بين البوابة والخادم الأصلي. لا ينبغي للعميل أن يختلق سياق الثقة الذي يعتمد عليه التطبيق. ويجب أن يعرف الخادم الأصلي أيضًا ما إذا كان التحصيل ثابتًا أم متغيرًا، وما دلالة التنفيذ: التحقق أولًا ثم التسوية، أم استخدام تدفق آخر يحدده المخطط.
في بعض المنتجات، يمكن تحويل استجابة 401 من الخادم الأصلي إلى فرصة للدفع. يجب أن يكون ذلك سياسة صريحة. فلا ينبغي لمستخدم مسجّل الدخول أن يفقد جلسته بسبب قاعدة سيئة الإعداد، ولا ينبغي لمشترٍ غير مسجّل الدخول أن يحصل على الوصول لمجرد أن البوابة حوّلت أي خطأ إلى 402.
الوسيط والشبكة والبيئة
الوسيط هو المكوّن الذي يتيح عمليات التحقق والتسوية لمخطط وشبكة متوافقين. ولا ينبغي التعامل معه كتفصيل غير مرئي: فالتوافر والموقِّعون والأصول والحدود ومُدد الانتهاء والتكاليف والمسؤوليات تختلف.
استخدم شبكة اختبار للتحقق من العقد التقني. وافصل بوضوح بين التطوير وشبكة الاختبار والإنتاج. فالدفعة المؤكدة على شبكة اختبار تثبت أن تدفق الاختبار ذاك نجح؛ ولا تثبت الانضمام التجاري، ولا دعم الشبكة الرئيسية، ولا الاسترداد بعملة ورقية، ولا الامتثال، ولا التوافر في أي بلد.
في x402 v2، تستخدم الشبكات معرّفات CAIP-2، وتحمل المتطلبات حقولًا مثل `scheme` و`network` و`asset` و`amount` و`payTo` و`maxTimeoutSeconds`. ويجب على العملاء استخدام مكتبات متوافقة بدلًا من تجميع التواقيع يدويًا انطلاقًا من أمثلة قديمة. وينبغي مراجعة قائمة قدرات الوسيط قبل نشر أي قاعدة.
أين يدخل Pix وأين لا يدخل
يحل Pix وx402 مشكلات مترابطة، لكنهما ليسا البروتوكول نفسه. Pix نظام دفع برازيلي له طلبات التحصيل ورمز QR والتأكيد والمطابقة الخاصة به. أما x402 فهو اصطلاح للإشارة إلى المدفوعات والإذن بها داخل تبادل HTTP، مع مخططات وشبكات يحددها التنفيذ.
يمكن لشركة أن تحمي واجهة API للمشترين المتوافقين مع x402 وتحتفظ بصفحة دفع منفصلة عبر Pix للأفراد. ويمكنها أيضًا تقديم مورد برازيلي لا يُتاح إلا بعد تأكيد تحصيل عبر Pix. وفي الحالتين، لا ينبغي التظاهر بأن رمز QR توقيع x402، أو بأن محفظة x402 هي تلقائيًا حساب Pix.
بالنسبة إلى Pix، يظل التأكيد الموثوق صادرًا عن الجهة المشاركة والتكامل المتعاقد عليه، لا عن شاشة لدى العميل.
مثال على البنية
تخيّل شركة تبيع بيانات محدّثة عن الشحن. يُحصَّل `GET /datasets/frete` لكل وصول، بينما لـ `GET /datasets/frete?regiao=sudeste` سعر متغير حتى سقف معيّن. يطلب العميل نقطة النهاية. تقيّم البوابة الطريقة والمسار والبيئة وتعيد المتطلبات. يوقّع العميل الخيار المقبول. يتحقق الوسيط من التفويض. يحسب الخادم الأصلي المجموعة المُسلَّمة فعليًا، ويبلّغ عن المبلغ حين يسمح المخطط، ويعيد مجموعة البيانات. ثم تُجري البوابة التسوية، وتسجّل الإيصال، وتسلّم الاستجابة.
يحتاج هذا التدفق إلى عدم التكرار (idempotency). فإذا انقطع الاتصال بعد التنفيذ، يجب على العميل الاستعلام عن النتيجة أو الإيصال قبل تكرار عملية ذات أثر مالي. وإذا أخفق الخادم الأصلي بعد التحقق، يجب أن يسجّل النظام الإخفاق ويطبّق دلالات المخطط؛ فلا يكفي وسم المعاملة بالنجاح لأن الدفعة بدت صالحة.
ماذا يحدث عندما لا تكون الاستجابة فورية؟
قد تمر عملية تحقيق الدخل بحالات وسيطة. فقد يكون التفويض صالحًا بينما لا يزال الخادم الأصلي يعالج الطلب. وقد تعتمد التسوية على تأكيد لاحق. وقد يفقد العميل الاتصال بعد تنفيذ المورد وقبل تلقي الاستجابة. وفي كل هذه الحالات، لا تعني عبارة «لم أتلقَّ استجابة» تلقائيًا أنه «لم يحدث تحصيل».
صمّم ما لا يقل عن أربعة عروض مترابطة: محاولة الوصول، والتفويض المقدَّم، ونتيجة التنفيذ، والتسوية. ويجب أن يتيح معرّف ثابت الاستعلام عن الحالة دون إنشاء عملية جديدة. وعلى البوابة أيضًا أن تميّز الطلب المكرر من المحاولة الأولى، وأن تعيد النتيجة المعروفة متى سمحت دلالات العملية بذلك.
هذا الحرص مهم بوجه خاص للأدوات التي تُحدث آثارًا خارجية. فالاستعلام يمكن تكراره بمخاطرة منخفضة؛ أما الإجراء الذي يُنشئ سجلًا أو يرسل رسالة أو يحجز موردًا فيحتاج إلى سياسة إعادة محاولة أكثر صرامة بكثير. وسعر الاستدعاء لا يغني عن عدم التكرار ولا عن تفويض الأعمال.
كيف تصمّم سياسة الوصول لكل مورد؟
ابدأ بتحديد الوحدة التي يحصل عليها المشتري. فعبارة «الوصول إلى API» أوسع من أن تُبنى عليها قاعدة جيدة. حدّد ما إذا كانت القيمة في تقرير أو مجموعة سجلات أو عملية تحويل أو نافذة بيانات أو إجراء منفَّذ.
ثم افصل بين الموارد العامة والمحمية والمدفوعة. فلا ينبغي أن تقع نقاط نهاية فحص السلامة والوثائق والملفات اللازمة للتكامل ومسارات الإدارة تحت قاعدة عامة لمجرد أنها على النطاق نفسه. ويجب أن تكون الأولوية صريحة: الاستثناء العام يتقدّم على قاعدة تحصيل واسعة، والمسار المميز يجب أن يبقى محميًا حتى لو غيّر العميل المعاملات.
ومن المفيد أيضًا تحديد ما يحدث في كل بيئة. يجب أن تكون لبيئة التطوير وشبكة الاختبار محافظ وشبكات وخوادم أصلية منفصلة عن الإنتاج. ويجب أن تُظهر القاعدة المنشورة البيئة التي تعمل فيها وإصدارها ووقت سريانها. وهذا يمنع اعتبار اختبار ناجح إيرادًا حقيقيًا، أو تغيير سعر كأنه بأثر رجعي.
كيف تقيس ما إذا كان تحقيق الدخل ناجحًا؟
الإيرادات مهمة، لكنها ليست المقياس الوحيد. لفهم مسار التحويل، تتبّع محاولات الوصول، واستجابات 402، والتفويضات المقدَّمة، والتفويضات المتحقَّق منها، وعمليات التنفيذ المكتملة، والتسويات، والموارد المُسلَّمة. ويحتاج كل معدل إلى مقام واضح.
قد يشير الانخفاض بين 402 والتفويض إلى أن المتطلبات غير واضحة أو أن العميل لا يدعم الخيار المنشور. وقد يشير الانخفاض بين التفويض المتحقَّق منه والتسليم إلى عطل في الخادم الأصلي أو انتهاء مهلة أو عدم توافق في التنفيذ. أما الفرق بين التسوية والمورد المُسلَّم فيتطلب تحقيقًا تشغيليًا وسياسة صريحة للتعويض أو إعادة المحاولة.
يجب أن تساعد لوحة المتابعة على الإجابة عن أسئلة ملموسة: أي مسار يولّد الطلب، وأي قاعدة تحقق التحويل، وأي بيئة قيد الاستخدام، وأي الأعطال تتكرر، وأي المدفوعات لا تزال بحاجة إلى مطابقة. ومن دون هذه الرؤية، قد تخلط الشركة بين حركة الزيارات والإيرادات، وبين التفويض والقيمة المُسلَّمة فعلًا.
أمان وحدود لا يمكن تجاهلها
لا ينبغي أن تحصل البوابة على صلاحيات تفوق ما تحتاجه لأداء وظيفتها. يجب التعامل مع المحافظ والمفاتيح والأسرار وسياق الخادم الأصلي والصلاحيات التشغيلية كلٌّ على حدة. ولا تضع أبدًا سرًّا خاصًا بالوسيط في صفحة عامة أو في طلب يستطيع العميل فحصه.
تحقّق من الطريقة والمسار والنطاق والبيئة والمبلغ والشبكة والأصل والمستفيد ومدة الانتهاء. وارفض التفويضات المنتهية، والمبالغ الأقل من المطلوب، وقيم nonce المكررة، والسياق غير المتوافق. وسجّل سبب كل قرار دون تخزين بيانات غير ضرورية عن المشتري.
تشمل الحماية أيضًا حدودًا للتوافر. فقد يتعرض مورد مدفوع لإساءة الاستخدام عبر الاستدعاءات المتكررة أو الاستعلامات المكلفة أو المعاملات التي تضخّم الاستهلاك. وتُعدّ حدود معدل الطلبات، وحدود التنفيذ، والتخزين المؤقت حين يكون آمنًا، والضوابط الخاصة بالعمليات ذات الآثار مكمّلات لقاعدة التسعير، لا بديلًا عن الدفع.
متى لا يكون x402 الخيار الأفضل؟
ليس x402 حلًا عامًا لكل تجربة تجارية. فإذا كان المشتري شخصًا يحتاج إلى التقسيط أو Pix أو الدعم أو فاتورة ضريبية أو رحلة موافقة مرئية، فقد تكون صفحة الدفع التقليدية أنسب. وإذا كان المورد يُستهلك بحجم متوقع من قِبل عدد قليل من العملاء، فقد يبسّط عقدٌ أو خطة متكررة العمليات.
يكون x402 أكثر منطقية عندما تكون النية برمجية، ويمكن وصف وحدة القيمة في طلب، ويستطيع العميل تفسير متطلبات الدفع والاستجابة لها. ويمكنه أن يتعايش مع قنوات أخرى: فواجهة API قد تخدم الوكلاء عبر x402 والمستخدمين البشر عبر المصادقة وصفحة الدفع؛ والمنتج قد يقدّم Pix للأفراد ومحفظة متوافقة للعملاء البرمجيين.
وتسلك المشتريات التي يجريها الوكلاء في المتاجر طريقًا آخر أيضًا: طريق شبكات البطاقات. فعلى سبيل المثال، وسّعت Visa اختبارات المعاملات التي يبدأها الوكلاء لتشمل جهات الاستحواذ ومزوّدي خدمات الدفع (PSP).
قائمة التحقق لإطلاق Monetization Gateway
قبل تفعيل أي قاعدة، تأكد من أن للمورد مالكًا وسعرًا وخادمًا أصليًا وجمهورًا محددين. وتحقق من أن الخادم الأصلي لا يقبل التجاوز، وأن القاعدة لا تلتقط مسارات عامة، وأن المحفظة والشبكة والأصل والوسيط متوافقة مع البيئة.
اختبر استدعاءً بلا دفع، وتفويضًا صالحًا، ومبلغًا خاطئًا، وشبكة غير متوافقة، وتفويضًا منتهيًا، وnonce مكررًا، وخادمًا أصليًا غير متاح، وانتهاء مهلة، وإعادة محاولة آمنة، وتسوية متأخرة. ثم طابِق ما حدث في البوابة وفي الخادم الأصلي وفي مكوّن الدفع.
وأخيرًا، اكتب سياسة الدعم. يجب أن يتمكن أحدٌ من شرح سبب تلقي استدعاء ما للحالة 402، وسبب رفض تفويض ما، وما إذا كان المورد قد نُفّذ، وما هي الحالة المالية. ولا تكون تجربة تحقيق الدخل جاهزة إلا عندما يستطيع الفريق التحقيق في أي استثناء دون الاعتماد على التخمين.
قائمة التحقق لتشغيل قاعدة في بيئة الإنتاج
ابدأ بالمورد وملكية النطاق. تحقق من أنه لا يمكن الوصول إلى الخادم الأصلي دون المرور عبر البوابة. عرّف القاعدة الأكثر تحديدًا أولًا ووثّق الأولوية. ولا تختر `exact` أو `upto` إلا بعد تحديد طريقة حساب المبلغ.
بعد ذلك ثبّت إصدار البروتوكول والشبكة والأصل والمحفظة والوسيط والبيئة. اختبر طلبًا بلا دفع، وتفويضًا صالحًا، وتفويضًا منتهيًا، ومبلغًا خاطئًا، وnonce مكررًا، وإخفاقًا في التسوية، وانتهاء مهلة، وإعادة محاولة آمنة. وسجّل ما تلقاه الخادم الأصلي وما تلقاه المشتري.
وأخيرًا، طابِق أربعة عروض: محاولة الوصول، والتفويض، والتسوية على السلسلة (on-chain)، والمورد المُسلَّم. فإذا تعذّر ربط أيٍّ منها بمعرّف ثابت، سيجد فريق الدعم صعوبة في شرح عملية تحصيل أو وصول فاشل.
الأسئلة الشائعة
هل يحل x402 محل صفحة الدفع المخصصة للأفراد؟
لا. يفيد x402 بشكل خاص العملاء البرمجيين والوكلاء والتطبيقات القادرة على تفسير المتطلبات وتوقيع التفويض. أما صفحة الدفع المخصصة للأفراد فقد تتطلب رحلة مختلفة، وإمكانية وصول، ومصادقة، ووسائل دفع محلية مثل Pix.
هل يمكنني تحصيل رسوم على أي صفحة بقاعدة واحدة؟
من الناحية التقنية، يمكن لقاعدة واسعة أن تطابق عناوين URL كثيرة، لكن ذلك لا يجعلها سياسة جيدة. ابدأ بالموارد التي لها سعر وخادم أصلي وجمهور وطريقة تسليم محددة جيدًا. واستخدم الأولوية والاختبارات لتجنّب التحصيل على نقاط نهاية فحص السلامة أو الملفات العامة أو الطرق التي لا ينبغي أن يكون لها سعر.
هل يثبت مقال الإعلان أن المنتج متاح؟
لا. يصف الإعلان مقترحًا ومرحلة بعينها. أما ما يمكن تفعيله فتحدده الوثائق الحالية وصلاحيات الحساب والشبكة والوسيط والعقود السارية. تعامَل مع أي قدرة لم تُختبر في بيئتك على أنها غير مؤكدة.
الخطوات التالية
أفضل تسليم أول ليس جدار دفع تزيينيًا، بل قاعدة قابلة للاختبار مع خادم أصلي محمي، وعميل متوافق، وبيئة منفصلة، وسجل يشرح كل خطوة. وبعد إثبات التدفق، توسّع إلى موارد متعددة وأسعار متغيرة ووكلاء وتكاملات محلية دون الخلط بين التفويض التقني والاستلام والتسليم.

المبدأ مباشر: تحقيق الدخل من مورد HTTP يعني بناء حدّ قابل للتحقق بين النية والدفع والوصول. التقنية تفتح هذا الحد؛ وهندسة الحالات والأمان والمطابقة تحافظ على موثوقيته. وللتعرّف على العرض التجاري للمنتج، اطّلع أيضًا على AZPay Monetization Gateway: حوّل أي مورد رقمي إلى وصول مدفوع.