پروتکل x402 چیست؟ پرداخت HTTP 402 برای ایجنت‌های هوش مصنوعی
x402 یک پروتکل پرداخت باز است که پرداخت را به داخل درخواست‌های معمولی وب می‌برد. وقتی یک کلاینت منبعی پولی را درخواست می‌کند، سرور با کد وضعیت HTTP 402 (Payment Required) و یک قیمت جواب می‌دهد. کلاینت، که اغلب یک ایجنت هوش مصنوعی است، پرداختی با استیبل‌کوین، معمولاً USDC، امضا می‌کند و همان درخواست را دوباره همراه با پرداخت می‌فرستد. نه حساب کاربری لازم است، نه کلید API و نه صفحه پرداخت.
این راهنما توضیح می‌دهد x402 قدم‌به‌قدم چطور کار می‌کند، اصطلاحاتی که در مشخصات آن می‌بینید چه معنایی دارند، نسخه V2 چه چیزهایی را عوض کرد، روی کدام شبکه‌ها کار می‌کند، چه هزینه‌ای دارد و چه وقت یک صفحه پرداخت ارز دیجیتال معمولی گزینه بهتری است. OrcaRail امروز پرداخت x402 ارائه نمی‌دهد و در انتهای این مطلب توضیح می‌دهیم به‌جای آن چه چیزی ارائه می‌دهد.
x402 چیست
x402 خودش را «استانداردی باز و بی‌طرف برای پرداخت‌های بومی اینترنت» معرفی می‌کند (x402.org). مستندات x402 در Coinbase دقیق‌تر توضیح می‌دهد: x402 به سرور اجازه می‌دهد هزینه یک منبع را در همان درخواستی بگیرد که آن منبع با آن دریافت می‌شود (پرسش‌های متداول x402).
نامش از کد وضعیت HTTP 402 یعنی Payment Required آمده است. استاندارد HTTP این کد را تعریف کرده اما بی‌استفاده گذاشته و می‌گوید این کد «برای استفاده در آینده رزرو شده است» (RFC 9110). x402 به این کد یک کار واقعی می‌دهد.
- چه کسی آن را ساخت. کار روی x402 را Coinbase شروع کرد (اعلامیه Cloudflare و Coinbase) و این پروتکل در مه ۲۰۲۵ راه‌اندازی شد (اعلامیه x402 V2).
- چه کسی امروز آن را اداره می‌کند. بنیاد لینوکس (Linux Foundation) در ۱۴ ژوئیه ۲۰۲۶ راه‌اندازی عملیاتی بنیاد x402 (x402 Foundation) را اعلام کرد؛ نهادی با حاکمیت باز که برای هدایت پروتکل x402 تشکیل شده و Coinbase این پروتکل را به آن سپرده است (اعلامیه).
- کد کجاست. در github.com/x402-foundation/x402، با مجوز Apache-2.0 و SDK برای TypeScript، Python و Go.
اطلاعات پروتکل در این مطلب از x402.org، مخزن بنیاد x402 و پرسش‌های متداول x402 در Coinbase گرفته شده و در ۱۲ نوامبر ۲۰۲۶ بررسی شده است.
x402 قدم‌به‌قدم چطور کار می‌کند
مخزن کد، جریان معمول را شرح می‌دهد. به‌طور خلاصه:
- کلاینت یک منبع را درخواست می‌کند، مثلاً
GET /api/report. - سرور با
402 Payment Requiredجواب می‌دهد. هدرPAYMENT-REQUIREDگزینه‌های پرداختی را که سرور می‌پذیرد فهرست می‌کند: طرح پرداخت، شبکه، توکن، مبلغ و آدرس دریافت. - کلاینت یکی از گزینه‌ها را انتخاب می‌کند و با کیف پولش پرداخت را امضا می‌کند.
- کلاینت همان درخواست را دوباره می‌فرستد، این بار با پرداخت امضاشده در هدر
PAYMENT-SIGNATURE. - سرور پرداخت را بررسی می‌کند، خودش یا با فراخوانی endpoint
/verifyدر یک تسهیل‌گر. - سرور کار را انجام می‌دهد و پرداخت را روی بلاکچین تسویه می‌کند، خودش یا از طریق endpoint
/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: تسویه دسته‌ای تعداد زیادی پرداخت کوچک روی بلاکچین). |
نسخه V2 در x402 چه چیزهایی را تغییر داد
اعلامیه V2 و پرسش‌های متداول Coinbase این تغییرات را فهرست می‌کنند:
- هدرهای جدید.
PAYMENT-REQUIRED،PAYMENT-SIGNATUREوPAYMENT-RESPONSEجایX-PAYMENTوX-PAYMENT-RESPONSEدر نسخه V1 را گرفته‌اند. حالا همه داده‌های پرداخت در هدرها جابه‌جا می‌شوند؛ نسخه V1 شرایط پرداخت را در بدنه پاسخ می‌فرستاد. - نام‌گذاری استاندارد شبکه‌ها. شبکه‌ها با شناسه‌های CAIP-2 نام‌گذاری می‌شوند. شناسه Base
eip155:8453است و هر شبکه سولانا باsolana:و genesis hash همان شبکه مشخص می‌شود. - نشست‌ها (sessions). نسخه V2 هویت مبتنی بر کیف پول را اضافه می‌کند تا لازم نباشد برای هر فراخوانی دوباره پرداخت کنید.
- افزونه‌ها و پلاگین‌ها. قابلیت‌های جدید به‌شکل افزونه (extension) اضافه می‌شوند، نه با تغییر مشخصات. یک نمونه Discovery است که به سرویس‌های x402 اجازه می‌دهد فراداده‌ای منتشر کنند که تسهیل‌گرها می‌توانند ایندکس کنند. در SDKها هم شبکه‌ها، توکن‌ها و طرح‌های پرداخت به‌صورت پلاگین اضافه می‌شوند.
- سازگاری با نسخه قبل. SDKهای مرجع کاملاً با V1 سازگارند.
x402 از کدام شبکه‌ها و توکن‌ها پشتیبانی می‌کند
به گفته x402.org این پروتکل به بلاکچین خاصی وابسته نیست، از همه شبکه‌های سازگار با EVM، سولانا و شبکه‌های دیگر پشتیبانی می‌کند و کاربرد اصلی آن پرداخت با استیبل‌کوین است. طوری هم طراحی شده که بتواند به روش‌های پرداخت سنتی گسترش پیدا کند.
اینکه در عمل چه چیزی کار می‌کند به تسهیل‌گری بستگی دارد که استفاده می‌کنید. برای مثال، تسهیل‌گر میزبانی‌شده Coinbase روی mainnet شبکه‌های Base، Polygon، Arbitrum، Monad، World و سولانا تسویه می‌کند (پرسش‌های متداول). روی این شبکه‌های EVM توکن‌های ERC-20 و روی سولانا توکن‌های SPL یا Token-2022 را می‌پذیرد. توکن‌هایی که EIP-3009 را پیاده‌سازی کرده‌اند، مثل USDC و EURC، بدون اینکه خریدار توکنی برای کارمزد گس داشته باشد تسویه می‌شوند. بقیه توکن‌های ERC-20 از Permit2 عبور می‌کنند که ممکن است یک تأیید یک‌باره اضافه کند و هزینه گس آن با خریدار است.
هزینه x402 چقدر است
- کارمزد پروتکل: صفر. به گفته x402.org پروتکل هیچ کارمزدی ندارد و برای مشتری و فروشنده رایگان است؛ آن‌ها فقط کارمزد ناچیز شبکه پرداخت را می‌پردازند.
- کارمزد شبکه. هر تسویه یک تراکنش روی بلاکچین است و کسی باید گس آن را بپردازد. تسهیل‌گر Coinbase آن را می‌پردازد و با قیمتی که برای هر تراکنش می‌گیرد پوشش می‌دهد.
- کارمزد تسهیل‌گر. هر تسهیل‌گر کارمزد خودش را تعیین می‌کند. تسهیل‌گر Coinbase ۱٬۰۰۰ تراکنش اول هر ماه را رایگان انجام می‌دهد و بعد برای هر تراکنش ۰٫۰۰۱ دلار می‌گیرد. بررسی پرداخت رایگان است.
x402 در مقابل درگاه پرداخت ارز دیجیتال
| x402 | درگاه پرداخت ارز دیجیتال | |
|---|---|---|
| چه کسی پرداخت می‌کند | نرم‌افزار: ایجنت هوش مصنوعی، اسکریپت یا اپلیکیشنی با کیف پول | آدم‌ها، در یک صفحه پرداخت |
| پرداخت کی انجام می‌شود | داخل درخواست HTTP، در هر فراخوانی | هنگام خرید، برای هر سفارش یا هر دوره صورت‌حساب |
| قیمت‌گذاری | برای هر درخواست: مبلغی دقیق یا تا یک سقف | سفارش، فاکتور و اشتراک |
| پرداخت‌کننده چطور می‌پردازد | کلاینت در کد امضا می‌کند، بدون صفحه | مشتری از کیف پولش در صفحه پرداخت میزبانی‌شده می‌پردازد |
| بک‌اند شما چطور باخبر می‌شود | هدر PAYMENT-RESPONSE در همان درخواست | وب‌هوک و داشبورد |
| OrcaRail امروز | ارائه نمی‌شود | بله |
این دو، مسئله‌های متفاوتی را حل می‌کنند. x402 برای API، داده و محتوایی مناسب است که نرم‌افزار خودش و درخواست‌به‌درخواست می‌خرد. درگاه پرداخت برای فروش به آدم‌ها مناسب است: صفحه محصول، فاکتور یا پلن ماهانه.
x402 برای چه کسانی است
- ارائه‌دهندگان API و داده که می‌خواهند برای هر فراخوانی، بدون حساب کاربری و کلید API، پول بگیرند.
- سازندگان ایجنت هوش مصنوعی که ایجنتشان باید خودش هزینه ابزار، داده یا محتوا را بپردازد.
- ناشران که می‌خواهند به‌جای اشتراک، برای هر مقاله یا هر درخواست پول بگیرند.
اگر مشتریان شما آدم‌هایی هستند که محصول، پلن یا خدمات می‌خرند، صفحه پرداخت میزبانی‌شده هنوز ساده‌ترین راه است. مردم انتظار دارند صفحه پرداخت، رسید و راهی برای مدیریت اشتراکشان داشته باشند.
چطور با x402 شروع کنیم
- مشخصات پروتکل را بخوانید در مخزن بنیاد x402 و یک طرح پرداخت انتخاب کنید.
exactساده‌ترین است. - یک SDK نصب کنید. README بسته‌های TypeScript زیر
@x402/، یک بسته Python (pip install x402) و یک ماژول Go را فهرست می‌کند. - اول روی تست‌نت آزمایش کنید، مثلاً Base Sepolia (
eip155:84532). راهنمای فاست‌های تست‌نت ما می‌گوید USDC آزمایشی رایگان را از کجا بگیرید. - یک تسهیل‌گر انتخاب کنید، یا پرداخت‌ها را در سرور خودتان بررسی و تسویه کنید.
- به mainnet بروید وقتی پرداخت‌های آزمایشی همان‌طور که انتظار دارید تسویه شدند، با کیف پولی که در اختیار خودتان است به‌عنوان آدرس دریافت.
OrcaRail به‌جای آن چه ارائه می‌دهد
OrcaRail امروز از x402 پشتیبانی نمی‌کند. OrcaRail یک درگاه پرداخت ارز دیجیتال برای فروش به آدم‌هاست. مشتریان شما در صفحه پرداخت میزبانی‌شده (payment intent)، با لینک پرداخت یا با اشتراک پرداخت می‌کنند؛ با USDC، تتر (USDT) یا توکن‌های دیگر، روی شبکه‌های EVM، سولانا و بیت‌کوین. هر پرداخت به کیف پول‌های خودتان منتقل می‌شود. کارمزد OrcaRail برای هر تراکنش تکمیل‌شده ۰٫۵٪ است و ۱۰۰ تراکنش اول رایگان است (قیمت‌گذاری).
با این حال، ایجنت‌های هوش مصنوعی می‌توانند این پرداخت‌ها را برایتان اداره کنند. سرور MCP OrcaRail به Claude Code، Cursor و Codex اجازه می‌دهد با یک پرامپت صفحه پرداخت و اشتراک بسازند؛ مطلب پرداخت با ایجنت هوش مصنوعی نشان می‌دهد چطور آن را در سندباکس وصل کنید. برای ساختن یکپارچه‌سازی با یک ایجنت کدنویسی، llms.txt را به آن بدهید و ساخت با هوش مصنوعی را ببینید.
می‌خواهید همین امروز از مشتریانتان USDC بگیرید؟ راهنمای دریافت پرداخت USDC را ببینید.
پرسش‌های متداول
نام x402 از کجا آمده است؟
از کد وضعیت HTTP 402 یعنی Payment Required که استاندارد HTTP آن را برای استفاده در آینده رزرو کرده است. x402 یک پروتکل است، نه یک رمز ارز: پرداخت‌ها توکن‌های موجود را جابه‌جا می‌کنند، بیشتر استیبل‌کوین‌هایی مثل USDC.
استفاده از x402 رایگان است؟
خود پروتکل کارمزدی ندارد. کارمزد شبکه را همچنان می‌پردازید و تسهیل‌گر ممکن است برای بررسی و تسویه پرداخت‌ها کارمزد بگیرد. برای مثال، تسهیل‌گر Coinbase ۱٬۰۰۰ تراکنش اول هر ماه را رایگان انجام می‌دهد و بعد برای هر تراکنش ۰٫۰۰۱ دلار می‌گیرد (بررسی‌شده در ۱۲ نوامبر ۲۰۲۶).
x402 روی سولانا کار می‌کند؟
بله. x402.org شبکه‌های EVM و سولانا را فهرست می‌کند و تسهیل‌گر Coinbase روی mainnet سولانا تسویه می‌کند. در نسخه V2 هر شبکه سولانا با solana: و genesis hash همان شبکه نام‌گذاری می‌شود.
مخزن گیت‌هاب x402 کجاست؟
در github.com/x402-foundation/x402، با مجوز Apache-2.0. مخزن قدیمی‌تر coinbase/x402 حالا یک fork توسعه است و issueها و pull requestهای آن به مخزن بنیاد x402 منتقل شده‌اند.
OrcaRail از x402 پشتیبانی می‌کند؟
فعلاً نه. OrcaRail صفحه پرداخت میزبانی‌شده، لینک پرداخت و اشتراک را برای آدم‌هایی ارائه می‌دهد که با USDC، تتر و توکن‌های دیگر پرداخت می‌کنند، و یک سرور MCP دارد که به ایجنت‌های هوش مصنوعی اجازه می‌دهد این پرداخت‌ها را برایتان بسازند.