x402 काय आहे.
x402 हे HTTP-नैतिक पेमेंटसाठी एक ओपन प्रोटोकॉल आहे, जे Coinbase द्वारे 2024 च्या उत्तरार्धात प्रकाशित केले गेले. हे परिभाषित करते की सर्व्हर कसा 402 पेमेंट आवश्यक स्थिती परत करतो संरचित JSON शरीरासह - स्वीकार्य पेमेंट आवश्यकता (योजना, नेटवर्क, चेन आयडी, प्राप्तकर्ता पत्ता, USDC बेस युनिट्समध्ये रक्कम, आणि पेमेंट-रुजू आयडी) यांची यादी - जेणेकरून एक मशीन क्लायंट प्रतिसाद पार्स करू शकेल, ऑन-चेन भरणा करू शकेल, आणि एक X-Payment हेडरसह मूळ कॉल पुनःप्रयत्न करू शकेल, सर्व प्रोग्रामेटिकली.
HTTP 402 तीस वर्षे वापरात नव्हता. x402 ने ते कार्यान्वित केले.
The 402 Payment Required status code was reserved in the original HTTP spec for "future use" and never received a standardized implementation. For three decades, every actual payment flow on the web was built on top of 200 / 401 / 403: a server returns 401 when authentication is missing, the client signs up via a separate UI flow, gets credentials, and re-authenticates. The signup happens out of band. None of this works for AI agents, which cannot complete signup forms.
x402 fixes this by giving 402 a usable specification. A server can return 402 with structured machine-readable payment instructions; a client can parse those instructions, pay, and retry, all without ever touching a signup form. The protocol is the missing piece between "AI agents can call APIs" and "AI agents can pay for the APIs they call". Before x402, the only practical agent payment paths were pre-paid balance accounts (with manual top-up) or proprietary integrations per API. Both broke at scale.
x402 ची धोरणात्मक महत्त्व म्हणजे ती इकोसिस्टमच्या इतर भागांनी बांधण्यासाठी एक मानक सेट करते. वॉलेट एकदा x402 हँडलर लागू करतात, आणि प्रत्येक x402-अनुकूल API त्या वॉलेटसह कार्य करते. सर्व्हर फ्रेमवर्क एकदा x402 मिडलवेअर लागू करतात, आणि प्रत्येक x402-ज्ञानी क्लायंट त्यांना पैसे देऊ शकतो. सुलभ करणारे (आधारभूत पेमेंट निपटारा करणाऱ्या सेवा) लॉक-इनवर नाही तर सेवा गुणवत्तेवर स्पर्धा करतात.
एक प्रतिसाद, एक पुन्हा प्रयत्न, एक पेमेंट.
आयुष्यचक्रात तीन स्थिती आहेत: अनपेड कॉल, पेमेंट, पुन्हा प्रयत्न केलेला कॉल. खाली अनपेड-कॉल प्रतिसाद वायर्डवर कसा दिसतो ते आहे.
HTTP/1.1 402 Payment Required Content-Type: application/json { "resource": "POST /api/research-query", "accepts": [ { "scheme": "exact-usdc", "network": "mainnet", "chainId": "eip155:8453", "payToAddress": "0xAgent...", "amountWeiUsdc": "50000", "paymentRequestId": "pr_01J9...", "maxAgeSeconds": 60 } ] }
- Status code 402. Distinct from 401 (auth missing) and 403 (auth refused). The presence of 402 signals "payment is the missing input."
- resource + accepts[]. शरीर संरक्षित संसाधनाचे नाव ठेवते आणि एक किंवा अधिक स्वीकार्य पेमेंट आवश्यकता सूचीबद्ध करते. एक स्थलांतर दोन आवश्यकता उद्धृत करू शकते (उदा. मुख्य नेटवर्क आणि टेस्टनेट) आणि क्लायंटला निवडण्याची परवानगी देते.
- योजना / नेटवर्क / चेनआयडी. पेमेंट योजना (exact-usdc), चेन (मुख्य नेटवर्क म्हणजे Base), आणि त्याची CAIP-2 आयडी. क्लायंट पैसे देण्यापूर्वी यावर जुळतो.
- payToAddress / amountWeiUsdc. प्राप्तकर्ता वॉलेट आणि USDC बेस युनिटमध्ये अचूक रक्कम (50000 = 0.05 USDC, 6 दशांश). क्लायंट पैसे देण्यापूर्वी दोन्हीची पुष्टी करतो.
- paymentRequestId + maxAgeSeconds. आयडी या कोटशी पैसे जोडतो; maxAgeSeconds म्हणजे पैसे किती ताजे असावे लागतात. एक पैसे जे भिन्न आयडीचा संदर्भ देते, किंवा विंडोपेक्षा जुने आहे, ते नाकारले जाते.
- पुन्हा प्रयत्न करणे X-Payment हेडर घेऊन येते. क्लायंट ऑन-चेन पैसे देतो, नंतर मूळ विनंती X-Payment हेडरसह पुन्हा जारी करतो जो पैसे दिल्याचे सिद्ध करतो. सर्व्हर ते सत्यापित करतो आणि वास्तविक परिणाम परत करतो. कोणतेही प्रतिसाद हेडर किंवा होस्टेड पृष्ठ x402 वायरचा भाग नाही.
x402 जंगलात.
तीन ठोस तैनाती, प्रत्येक स्तरात स्वीकृती किती प्रगल्भ आहे यानुसार क्रमबद्ध.
MCP सर्व्हर एक न भरलेल्या साधन कॉलसाठी 402 आव्हान परत करत आहे
एक पेड MCP टूल Claude Desktop कडून एक आवाहन प्राप्त करते आणि कॉलरला अद्याप पैसे दिले म्हणून चिन्हांकित केलेले नाही. सर्व्हर requirePayment आव्हान तयार करतो - एक 402 ज्याचे शरीर किंमत आणि एक होस्टेडUrl वाहून नेते - आणि ते टूल त्रुटी म्हणून परत करतो. Claude Desktop चॅटमध्ये लिंक दर्शवतो; वापरकर्ता $0.05 USDC भरतो; त्याच टूलसाठी पुढील कॉल यशस्वी होतो.
API अंतिम बिंदू गेटिंग प्रति-कॉल बिलिंग
एक संशोधन API x402 सर्व्हर अडॅप्टरच्या मागे $0.50 प्रति कॉल आकारते. एक AI एजंट एंडपॉइंटला कॉल करतो, रक्कम आणि प्राप्तकर्ता सूचीबद्ध करणारा 402 मिळवतो, त्याच्या वॉलेटमधून Base वर पैसे भरतो, आणि X-Payment हेडरसह विनंती पुन्हा जारी करतो. अडॅप्टर हेडरची पुष्टी करतो आणि पैसे दिलेले उत्तर परत करतो. संपूर्ण लूप 60 सेकंदांच्या आत पूर्ण होते.
एक एजंट x402-जानकारी असलेल्या वॉलेटद्वारे प्रोग्रामेटिकली पैसे देत आहे
एजंटचा रनटाइम x402-aware आहे (तो स्पेक लागू करतो). जेव्हा तो 402 वर येतो, तेव्हा तो accepts[] मधून payToAddress आणि रक्कम वाचतो, त्याच्या पूर्व-प्राधिकृत वॉलेटमधून (त्याच्या खर्च परवानगीच्या आत) हस्तांतरणावर सही करतो, Base वर प्रसारित करतो, आणि X-Payment हेडरसह मूळ कॉल पुन्हा प्रयत्न करतो. कोणतीही मानवी सहभाग नाही; लूप 5-10 सेकंदात पूर्ण होते.
स्टॅकमध्ये x402 च्या भोवती काय आहे.
x402 हा प्रोटोकॉल आहे. हे तीन शब्द त्या संकल्पनांना कव्हर करतात ज्यावर ते बसले आहे आणि ते सक्षम करणारे वापराचे प्रकरणे.