x402 क्या है।
x402 HTTP-देशी भुगतानों के लिए एक खुला प्रोटोकॉल है, जिसे Coinbase ने 2024 के अंत में प्रकाशित किया। यह परिभाषित करता है कि एक सर्वर संरचित JSON शरीर के साथ 402 भुगतान आवश्यक कैसे लौटाता है - स्वीकार्य भुगतान आवश्यकताओं (स्कीम, नेटवर्क, चेन आईडी, प्राप्तकर्ता पता, 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[]. बॉडी संरक्षित संसाधन का नाम देती है और एक या अधिक स्वीकार्य भुगतान आवश्यकताओं की सूची बनाती है। एक माइग्रेशन दो आवश्यकताओं का उद्धरण दे सकता है (जैसे मुख्य नेटवर्क और परीक्षण नेटवर्क) और ग्राहक को चुनने दे सकता है।
- scheme / network / chainId. भुगतान योजना (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 जिसका शरीर मूल्य और एक hostedUrl ले जाता है - और इसे एक उपकरण त्रुटि के रूप में लौटाता है। Claude Desktop चैट में लिंक को प्रस्तुत करता है; उपयोगकर्ता $0.05 USDC का भुगतान करता है; उसी उपकरण के लिए अगला कॉल सफल होता है।
API एंडपॉइंट गेटिंग प्रति-कॉल बिलिंग
एक शोध API x402 सर्वर एडेप्टर के पीछे प्रति कॉल $0.50 चार्ज करता है। एक AI एजेंट एंडपॉइंट को कॉल करता है, राशि और प्राप्तकर्ता की सूची के साथ 402 प्राप्त करता है, अपने वॉलेट से Base पर भुगतान करता है, और X-Payment हेडर के साथ अनुरोध को फिर से जारी करता है। एडेप्टर हेडर को सत्यापित करता है और भुगतान की गई प्रतिक्रिया लौटाता है। पूरा लूप 60 सेकंड से कम समय में पूरा होता है।
x402-सचेत वॉलेट के माध्यम से प्रोग्रामेटिक रूप से भुगतान कर रहा एजेंट
एक एजेंट का रनटाइम x402-जानकारी है (यह विनिर्देश को लागू करता है)। जब यह 402 पर पहुँचता है, तो यह accepts[] से payToAddress और राशि पढ़ता है, अपने पूर्व-स्वीकृत वॉलेट से एक ट्रांसफर पर हस्ताक्षर करता है (इसके व्यय अनुमति के भीतर), बेस पर प्रसारण करता है, और X-Payment हेडर के साथ मूल कॉल को फिर से प्रयास करता है। कोई मानव भागीदारी नहीं; लूप 5-10 सेकंड में पूरा होता है।
स्टैक में x402 के चारों ओर क्या है।
x402 प्रोटोकॉल है। ये तीन शर्तें उन अवधारणाओं को कवर करती हैं जिन पर यह आधारित है और उपयोग के मामलों को सक्षम करती हैं।