बस एक दिक्कत है। भुगतान कैसे लेना है, यह endpoint तय करता है, और agent को मिलने वाले x402 endpoints आम तौर पर किसी खास network पर USDC माँगते हैं, जैसे Base या Solana। आपके agent के पास कुछ और हो सकता है: Solana पर USDT, Stellar पर USDC, या BNB Chain पर USDT। हर call से पहले bridge करना भी काम नहीं करता, क्योंकि x402 payment requirement सिर्फ़ कुछ मिनट valid रहती है, और chains के बीच पैसा भेजने में आम तौर पर इससे ज़्यादा समय लगता है।
ROZO स्वतंत्र है और किसी भी x402 seller से जुड़ा नहीं है।
एक बार top up करें, कई बार भुगतान करें
ROZO का x402 payer इस समस्या को दो हिस्सों में बाँटता है। आप एक बार अपने पास पहले से मौजूद coin से, उसी chain पर जो आप पहले से इस्तेमाल करते हैं, ROZO balance top up करते हैं। उसके बाद, Base पर USDC लेने वाले endpoint को हर x402 call का भुगतान उसी balance से सेकंडों में, payment window के अंदर हो जाता है।
अगर आपका agent shell command चला सकता है, तो पूरा integration बस इतना है:
- Balance एक बार top up करें। यह एक one-time deposit address दिखाता है; उसे अपने wallet से pay करें: npx @rozoai/checkout x402 topup 20 --with usdt-solana
- किसी paid endpoint को call करें। CLI 402 पढ़ता है, ROZO sign करता है, और request भुगतान के साथ दोबारा भेजी जाती है: npx @rozoai/checkout x402 pay https://api.example.com/v1/search --method POST --body '{"q":"..."}'
- बचा हुआ balance देखें: npx @rozoai/checkout x402 balance
x402 pay पर क्या होता है
आपकी machine request सीधे endpoint को भेजती है। जब 402 वापस आता है, CLI payment requirements पढ़ता है, सिर्फ़ Base पर USDC वाला option रखता है, और ROZO से उसी एक भुगतान पर sign करने को कहता है। फिर वह PAYMENT-SIGNATURE header के साथ आपकी मूल request दोबारा भेजता है और response दिखाता है।
हर भुगतान के साथ एक idempotencyKey होती है, और उसी भुगतान का retry वही key दोबारा इस्तेमाल करता है, इसलिए timeout होने पर भी आपसे दो बार पैसा नहीं कटता।
Shell नहीं है? यही भुगतान दो core HTTP endpoints, /v1/x402/topup और /v1/x402/sign, से भी होता है, जिनमें आपकी agent key bearer token के रूप में जाती है। आपका agent signature के साथ अपनी request ख़ुद दोबारा भेजता है। x402 page पर दोनों calls के उदाहरण हैं।
आपके पैसे की सुरक्षा कैसे होती है
Agent को wallet देना असली जोखिम है, इसलिए payer को सीमित permissions के आसपास बनाया गया है।
- Key सिर्फ़ balance खर्च करती है। पहले top up पर ak_ से शुरू होने वाली एक agent key बनती है। वह आपके ROZO balance से भुगतान कर सकती है, और कुछ नहीं। वह आपके अपने wallet को कभी नहीं छूती, ROZO आपकी wallet keys कभी नहीं रखता, और ROZO agent key का सिर्फ़ hash रखता है।
- हर भुगतान की एक सीमा है। Default रूप से एक भुगतान अधिकतम $5 का हो सकता है और एक key एक दिन में अधिकतम $100 खर्च कर सकती है। दोनों default हैं और हर key के लिए बदले जा सकते हैं। आप किसी key को payTo addresses की एक list तक सीमित भी कर सकते हैं, और CLI --max-usd से तय की गई सीमा से ऊपर का कोई भी भुगतान मना कर देता है।
- हर बार एक बार का भुगतान, कभी subscription नहीं। हर call के लिए seller से नया 402 और ROZO से नया signature चाहिए। Seller को बाद में और पैसा निकालने की कोई स्थायी अनुमति कभी नहीं मिलती।
- आपकी request आपकी ही रहती है। Paid request आपकी machine से endpoint तक जाती है। ROZO request body, आपके headers या उस service के लिए इस्तेमाल होने वाली API keys कभी नहीं देखता। वह सिर्फ़ वह payment requirement देखता है जिस पर उसे sign करना है: भुगतान किसे, कितना और किस network पर।
किससे top up कर सकते हैं, और भुगतान किसमें होता है
यहाँ दो हिस्से हैं, और उन्हें जानबूझकर अलग दिखाया गया है।
Top up हिस्सा, आपसे ROZO तक:
- Solana, BNB Chain, Ethereum या Polygon पर USDT
- Solana, BNB Chain, Ethereum, Polygon, Base या Stellar पर USDC
आपके पास native coin या sats हैं? उनसे आप checkout.rozo.ai पर ROZO Checkout के ज़रिए OpenRouter top up कर सकते हैं।
भुगतान हिस्सा, ROZO से x402 seller तक:
- Base (eip155:8453): USDC, x402 scheme exact
- Solana: बाद में आएगा
Sellers को हमेशा USDC में भुगतान मिलता है, क्योंकि x402 exact भुगतान token transfers होते हैं। USDT सिर्फ़ balance top up करने के काम आता है; seller को USDC मिलता है। अगर कोई endpoint सिर्फ़ Solana पर USDC लेता है, तो CLI कुछ भी charge होने से पहले X402_UNSUPPORTED के साथ रुक जाता है।
न्यूनतम top up $5 है, और top up पर 1% fee लगती है। Balance से होने वाले हर x402 भुगतान की लागत सिर्फ़ उतनी है जितनी seller माँगता है। Withdrawal अभी self serve नहीं है: अपनी masked key और राशि के साथ hi@rozo.ai पर email करें, और balance आपकी चुनी हुई chain पर वापस भेज दिया जाएगा।
अभी शुरू करें
Payer अभी live है। checkout.rozo.ai/x402 page पर तीनों commands, raw HTTP calls, limits और FAQ एक जगह हैं। हर error code के साथ पूरा reference docs.rozo.ai पर है। Agents यही निर्देश, safety rules और retry guidance के साथ, checkout.rozo.ai/llms.txt और GitHub पर RozoAI/rozo-checkout-skill repository में पढ़ सकते हैं।
अपने पास वाले coin से एक बार top up करें, और अपने agent को उन APIs का भुगतान ख़ुद करने दें जिन्हें वह call करता है।