OKX से AI agent कोखुद भुगतान और साइन अप करने दें
OKX Wallet से x402 पर भुगतान करें और एक अनुरोध में API key व बैलेंस पाएं।
- X Layer पर USD₮0, OKX के जरिए सेटल
- क्रेडिट कार्ड और साइन-अप फ़ॉर्म की ज़रूरत नहीं
- सामान्य उपयोगकर्ता भी x402 से टॉप अप कर सकते हैं
curl -i -X POST https://bazaarlink.ai/api/v1/agents/register/x402 \
-H "Content-Type: application/json" \
-d '{"name":"my-agent","amountUsd":1.1}'HTTP/1.1 402 Payment Required
Content-Type: application/json
{
"x402Version": 2,
"resource": {
"url": "https://bazaarlink.ai/api/v1/agents/register/x402",
"description": "BazaarLink paid agent registration",
"mimeType": "application/json"
},
"accepts": [
{
"scheme": "exact",
"network": "eip155:196",
"payTo": "0xPAY_TO_ADDRESS",
"asset": "0xASSET_CONTRACT",
"amount": "1100000",
"maxTimeoutSeconds": 300,
"extra": { "name": "USD₮0", "version": "1" }
}
]
}x402 क्या है
- POST
/api/v1/agents/register/x402 - ← 402
accepts[ network, asset, amount, payTo ] - sign
EIP-3009 - POST
X-PAYMENT: … - ← 201
api_key, credits, claim_token
भुगतान OKX के x402 facilitator के जरिए X Layer पर ऑन-चेन सेटल होते हैं; सर्वर कार्रवाई से पहले हर भुगतान जांचता है।
HTTP 402 भुगतान मांगता है
सर्वर 402 के साथ स्वीकार किए जाने वाले नेटवर्क, एसेट, राशि और भुगतान पते की सूची देता है। क्लाइंट भुगतान प्राधिकरण पर साइन करके वही अनुरोध फिर भेजता है। BazaarLink हर भुगतान को OKX के x402 facilitator के जरिए X Layer पर सेटल करता है।
api_keysk-bl-…credits5claim_token…payment.txHash0x…पहले अकाउंट की ज़रूरत नहीं
agent को पहले फ़ॉर्म भरने या अकाउंट बनाने की ज़रूरत नहीं है। भुगतान वाला अनुरोध अकाउंट बनाता है, API key जारी करता है और बैलेंस जोड़ता है।
अनुरोध से API key तक चार चरण
अनुरोध भेजें
/api/v1/agents/register/x402 पर POST करके नाम और भुगतान की जाने वाली अमेरिकी डॉलर राशि भेजें।
402 पाएं
सर्वर 402 के साथ भुगतान की आवश्यकताएं भेजता है। इस चरण पर कुछ भी नहीं बनाया जाता।
साइन करके फिर भेजें
अपने वॉलेट से भुगतान प्राधिकरण पर साइन करें, उसे X-PAYMENT हेडर में रखें और वही अनुरोध फिर भेजें।
API key पाएं
भुगतान की पुष्टि के बाद API key, बैलेंस और क्लेम लिंक वाला 201 मिलता है। API key केवल इसी रिस्पॉन्स में दिखती है, इसलिए तुरंत सेव करें।
अकाउंट पहले से है? x402 से भी टॉप अप करें
agent अपनी मौजूदा API key इस्तेमाल करता है। सामान्य उपयोगकर्ता साइन इन करके क्रेडिट पेज से टॉप अप करते हैं।
Agent और स्क्रिप्ट
Authorization हेडर और amountUsd के साथ /api/x402/topup पर POST करें। रजिस्ट्रेशन जैसा ही क्रम है: कोट, साइन, फिर भेजें।
सामान्य उपयोगकर्ता
साइन इन करें, क्रेडिट पेज खोलें, x402 चुनें और ब्राउज़र वॉलेट से भुगतान पर साइन करें।
समर्थित नेटवर्क और एसेट
अभी एक संयोजन समर्थित है।
- नेटवर्क
- X Layer, OKX के x402 facilitator के जरिए सेटल
- एसेट
- USD₮0
- बैलेंस
- प्लेटफ़ॉर्म टॉप-अप शुल्क लगता है, इसलिए जमा होने वाला बैलेंस भुगतान की गई राशि से कम होता है (कीमत देखें)
- हर भुगतान की राशि
- न्यूनतम और अधिकतम सीमा है; मौजूदा सीमाएं 402 रिस्पॉन्स और GET /api/x402/topup में दिखती हैं
ऑन-चेन भुगतान वापस नहीं किए जा सकते। साइन करने से पहले राशि और नेटवर्क जांचें।
अभी भुगतान नहीं किया? मुफ़्त मॉडल फिर भी चलते हैं
जिस agent अकाउंट ने भुगतान नहीं किया है, वह मौजूदा मुफ़्त-मॉडल भत्ता और रेट लिमिट (auto:free) इस्तेमाल करता है। भुगतान के बाद अकाउंट सामान्य पेड-अकाउंट नियमों का पालन करता है।
अक्सर पूछे जाने वाले सवाल
x402 क्या है?
x402 एक प्रोटोकॉल है जो भुगतान मांगने के लिए HTTP 402 स्टेटस कोड इस्तेमाल करता है। सर्वर राशि, नेटवर्क और भुगतान पता बताता है; क्लाइंट भुगतान प्राधिकरण पर साइन करके वही अनुरोध फिर भेजता है।
x402 से भुगतान करने के लिए क्या चाहिए?
OKX Wallet या EIP-3009 प्राधिकरण पर साइन कर सकने वाली किसी भी वॉलेट कुंजी के साथ X Layer पर USD₮0 चाहिए। इंटीग्रेशन दस्तावेज़ में साइनिंग के लिए x402 क्लाइंट वाला TypeScript कोड है।
कौन-से नेटवर्क और एसेट समर्थित हैं?
X Layer पर USD₮0, OKX के x402 facilitator से सेटल होता है। प्लेटफ़ॉर्म टॉप-अप शुल्क लगता है, इसलिए मिलने वाला बैलेंस भुगतान की गई राशि से कम होता है; कीमत पेज देखें।
दो बार भुगतान या अनुरोध भेजने पर क्या होता है?
हर भुगतान केवल एक बार क्रेडिट होता है। टॉप अप में वही भुगतान फिर भेजने पर already_credited मिलता है। रजिस्ट्रेशन में 15 मिनट तक वही परिणाम मिलता है; उसके बाद already_registered मिलता है और API key फिर नहीं दिखाई जाती।
क्या रिफंड मिल सकता है?
ऑन-चेन भुगतान वापस नहीं किए जा सकते और सिस्टम अपने-आप रिफंड नहीं करता। समस्या होने पर सहायता से संपर्क करें।
क्या रजिस्ट्रेशन की सीमा है?
हां। एक ही नेटवर्क स्रोत से होने वाले रजिस्ट्रेशन कम समय में सीमित हैं। सीमा पहुंचने पर 429 और Retry-After हेडर मिलता है; प्रतीक्षा करके फिर कोशिश करें।
क्या कोई व्यक्ति agent अकाउंट अपने नाम ले सकता है?
हां। रजिस्ट्रेशन रिस्पॉन्स में claim_token और upgrade_url होते हैं। व्यक्ति साइन इन करके अकाउंट क्लेम करता है, फिर API key और बैलेंस उसके अकाउंट में चले जाते हैं। claim_expires समय-सीमा बताता है।