---
title: 'HTTP 402 Payment Required: المعنى والتاريخ وx402 | RunAPI'
description: ما معنى رمز الحالة HTTP 402 Payment Required، ولماذا بقي دون استخدام لعقود، ومتى تُرجعه واجهات API اليوم، وكيف يحوّله x402 إلى تدفق دفع.
url: https://runapi.ai/ar/http-402.md
canonical: https://runapi.ai/ar/http-402
locale: ar
updated: '2026-09-24'
date: '2026-09-24'
site: RunAPI
image: https://runapi.ai/assets/opengraph-bfaaa0f0.png
alternates:
  en: https://runapi.ai/http-402
  zh-CN: https://runapi.ai/zh-CN/http-402
  es: https://runapi.ai/es/http-402
  ja: https://runapi.ai/ja/http-402
  de: https://runapi.ai/de/http-402
  fr: https://runapi.ai/fr/http-402
  pt-BR: https://runapi.ai/pt-BR/http-402
  ko: https://runapi.ai/ko/http-402
  it: https://runapi.ai/it/http-402
  nl: https://runapi.ai/nl/http-402
  pl: https://runapi.ai/pl/http-402
  tr: https://runapi.ai/tr/http-402
  zh-TW: https://runapi.ai/zh-TW/http-402
  zh-HK: https://runapi.ai/zh-HK/http-402
  ar: https://runapi.ai/ar/http-402
  x-default: https://runapi.ai/http-402
---

> HTML version: https://runapi.ai/ar/http-402
> Site index for agents: https://runapi.ai/llms.txt

# HTTP 402 Payment Required: معناه وكيف يستخدمه x402

402 هو رمز حالة HTTP للطلب الذي يتطلب الدفع قبل أن ينفّذه الخادم. طوال معظم تاريخه لم تكن له صيغة قياسية، وx402 يمنحه هذه الصيغة.

_آخر تحديث September 24, 2026 · قراءة 5 دقائق_


## Key takeaways

- 402 Payment Required خطأ من جهة العميل: الطلب صالح، لكن الخادم يريد الدفع أولًا.
- حجز HTTP/1.1 الرمز 402 للاستخدام المستقبلي ولم يحدد قط كيف يجب أن يتم الدفع، فاستخدمته كل واجهة API بطريقة مختلفة.
- يحدد x402 العناصر الناقصة: ترويسة PAYMENT-REQUIRED بشروط قابلة للقراءة آليًا، ودفعة موقَّعة عند إعادة المحاولة.

## معنى 402 Payment Required

تخبر استجابة 402 العميلَ أن الطلب نفسه سليم، لكنه لن يُنفَّذ حتى يتم الدفع. وينتمي إلى فئة 4xx لأن الخطوة التالية تقع على عاتق العميل وليس الخادم.

يختلف 402 عن 401 Unauthorized و403 Forbidden. فالرمز 401 يطلب بيانات اعتماد، و403 يرفض الطلب رفضًا قاطعًا، أما 402 فيطلب الدفع.


## لماذا بقي 402 دون استخدام طويلًا

حُجز الرمز عند كتابة HTTP/1.1 على أمل أن يظهر لاحقًا شكل من أشكال النقد الرقمي. لكن المواصفة لم تحدد قط ما يجب أن يحتويه نص استجابة 402 ولا كيف يدفع العميل، فلم تتعامل معه المتصفحات أبدًا.

في غياب صيغة مشتركة، استخدمت واجهات API التي أرجعت 402 هذا الرمز خطأً عاديًا: نفاد رصيد الحساب، أو رفض البطاقة، أو بلوغ حد الخطة.


## متى تُرجع واجهات API الرمز 402 اليوم

ستصادف 402 في حالتين رئيسيتين.

- أخطاء فوترة الحساب: المفتاح صالح لكن الرصيد أو الحصة أو الاشتراك لا يغطي الطلب. والحل هو إعادة الشحن أو الترقية.
- عروض أسعار الدفع لكل طلب: يُرجع الخادم شروط الدفع، ويستطيع العميل الدفع وإعادة إرسال الطلب نفسه. وهذه هي طريقة عمل x402.

## كيف يحوّل x402 الرمز 402 إلى تدفق دفع

يضع x402 شروطًا قابلة للقراءة آليًا في ترويسة PAYMENT-REQUIRED: المبلغ والأصل والشبكة والمستلم. يوقّع العميل تفويضًا بعملة مستقرة وفق هذه الشروط، ويعيده في ترويسة PAYMENT-SIGNATURE، ثم يتلقى الاستجابة مع إيصال PAYMENT-RESPONSE.

ولأن التبادل كله يجري عبر HTTP عادي، يستطيع وكيل ذكاء اصطناعي يملك محفظة أن يدفع مقابل استدعاء API دون تسجيل أو تخزين مفتاح API.


## التعامل مع 402 في عميلك

تحقق أولًا من وجود ترويسة PAYMENT-REQUIRED. إن وُجدت، فالاستجابة عرض سعر x402 ويمكن لعميل x402 دفعه. وإن لم توجد، فاقرأ نص الخطأ: فهو يعني عادةً أن الحساب يحتاج إلى رصيد إضافي أو خطة مختلفة.



## الأسئلة الشائعة حول HTTP 402

### هل 402 Payment Required خطأ؟

هو خطأ من جهة العميل ضمن نطاق 4xx، لكنه لا يعني أن الطلب مشوَّه. بل يعني أن الدفع مطلوب قبل أن يتابع الخادم.

### ما الفرق بين 402 و401؟

يعني 401 أن الخادم يحتاج إلى بيانات اعتماد صالحة، ويعني 402 أن الخادم يحتاج إلى الدفع. قد تُرجع واجهة API الرمز 401 لمفتاح غير صالح، و402 لمفتاح صالح بلا رصيد.

### هل تتعامل المتصفحات مع 402 تلقائيًا؟

لا. تعرض المتصفحات 402 مثل أي صفحة خطأ أخرى. ويتطلب الدفع التلقائي عميلًا يفهم بروتوكولًا مثل x402.

### ما واجهات API التي تستخدم 402 مع x402؟

أي خادم ينفّذ بروتوكول x402. تُرجع RunAPI عروض أسعار x402 على نقاط نهاية نماذج الذكاء الاصطناعي المسعّرة لكل استدعاء، فيستطيع الوكيل دفع ثمن توليد الصور والفيديو والموسيقى والصوت بـ USDC.



## صفحات ذات صلة

- [x402 API لنماذج الذكاء الاصطناعي](https://runapi.ai/ar/x402.md) - ادفع لكل طلب بـ USDC على Base دون مفتاح API.
- [كتالوج النماذج](https://runapi.ai/ar/models.md) - جميع النماذج ونقاط النهاية المتاحة على RunAPI.
- [وثائق المطورين](https://runapi.ai/ar/docs/guides) - صيغ الطلبات، والاستعلام عن المهام، ورموز الأخطاء.
- [الأسعار](https://runapi.ai/ar/pricing.md) - الرصيد، والأسعار لكل استدعاء، وتفاصيل الفوترة.


Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.


## جرّب 402 يمكنك دفعه فعلًا

أرسل طلبًا إلى نقطة نهاية في RunAPI مسعّرة لكل استدعاء دون مفتاح، واطّلع على عرض سعر x402 الذي تُرجعه.

- [تصفّح النماذج](https://runapi.ai/ar/models.md)
- [اقرأ الوثائق](https://runapi.ai/ar/docs/guides)



---

## More from RunAPI

- [Home](https://runapi.ai/ar/.md)
### المنتج
- [كتالوج النماذج](https://runapi.ai/ar/models.md)
- [الأسعار](https://runapi.ai/ar/pricing.md)
- [مزودو الخدمة](https://runapi.ai/ar/models#all-models)
### المطورون
- [التوثيق](https://runapi.ai/ar/docs/guides)
- [حزم SDK](https://runapi.ai/ar/sdk.md)
- [CLI](https://runapi.ai/ar/cli.md)
- [خادم MCP](https://runapi.ai/ar/mcp.md)
### الأدلة
- [Claude Code مقابل Cursor](https://runapi.ai/ar/claude-code-vs-cursor.md)
- [إعداد Cursor API](https://runapi.ai/ar/cursor-api-setup.md)
- [RunAPI مقابل OpenRouter](https://runapi.ai/ar/openrouter-alternative.md)
- [واجهة x402 البرمجية](https://runapi.ai/ar/x402.md)
### الشركة
- [المؤسسات](https://runapi.ai/ar/contact.md)
- [اتصل بنا](https://runapi.ai/ar/contact.md)
### القانوني
- [الشروط](https://runapi.ai/ar/terms.md)
- [الخصوصية](https://runapi.ai/ar/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/ar/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/aricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "Article",
    "headline": "HTTP 402 Payment Required: المعنى والتاريخ وx402",
    "description": "ما معنى رمز الحالة HTTP 402 Payment Required، ولماذا بقي دون استخدام لعقود، ومتى تُرجعه واجهات API اليوم، وكيف يحوّله x402 إلى تدفق دفع.",
    "datePublished": "2026-09-24",
    "dateModified": "2026-09-24",
    "author": {
      "@type": "Organization",
      "name": "RunAPI"
    },
    "publisher": {
      "@type": "Organization",
      "name": "RunAPI",
      "url": "https://runapi.ai/ar"
    },
    "mainEntityOfPage": "https://runapi.ai/ar/http-402"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "هل 402 Payment Required خطأ؟",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "هو خطأ من جهة العميل ضمن نطاق 4xx، لكنه لا يعني أن الطلب مشوَّه. بل يعني أن الدفع مطلوب قبل أن يتابع الخادم."
        }
      },
      {
        "@type": "Question",
        "name": "ما الفرق بين 402 و401؟",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "يعني 401 أن الخادم يحتاج إلى بيانات اعتماد صالحة، ويعني 402 أن الخادم يحتاج إلى الدفع. قد تُرجع واجهة API الرمز 401 لمفتاح غير صالح، و402 لمفتاح صالح بلا رصيد."
        }
      },
      {
        "@type": "Question",
        "name": "هل تتعامل المتصفحات مع 402 تلقائيًا؟",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "لا. تعرض المتصفحات 402 مثل أي صفحة خطأ أخرى. ويتطلب الدفع التلقائي عميلًا يفهم بروتوكولًا مثل x402."
        }
      },
      {
        "@type": "Question",
        "name": "ما واجهات API التي تستخدم 402 مع x402؟",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "أي خادم ينفّذ بروتوكول x402. تُرجع RunAPI عروض أسعار x402 على نقاط نهاية نماذج الذكاء الاصطناعي المسعّرة لكل استدعاء، فيستطيع الوكيل دفع ثمن توليد الصور والفيديو والموسيقى والصوت بـ USDC."
        }
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "الرئيسية",
        "item": "https://runapi.ai/ar"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "HTTP 402",
        "item": "https://runapi.ai/ar/http-402"
      }
    ]
  }
]
```