ప్రధాన కంటెంట్‌కు దాటవేయండి
కలవండినిఘంటువుx402
గ్లోసరీ

x402 అంటే ఏమిటి.

వ్యాఖ్యానం

x402 HTTP-నేటివ్ చెల్లింపుల కోసం ఓపెన్ ప్రోటోకాల్, ఇది Coinbase ద్వారా 2024 చివర్లో ప్రచురించబడింది. ఇది ఒక సర్వర్ 402 చెల్లింపు అవసరం నిర్మిత JSON శరీరం - ఒక స్వీకరించదగిన చెల్లింపు అవసరాల జాబితా (పథం, నెట్‌వర్క్, చైన్ ID, స్వీకర్త చిరునామా, USDC బేస్ యూనిట్లలో మొత్తం, మరియు చెల్లింపు-అభ్యర్థన ID) - ఎలా తిరిగి ఇవ్వాలో నిర్వచిస్తుంది, కాబట్టి ఒక యంత్ర క్లయింట్ ప్రతిస్పందనను పార్స్ చేయవచ్చు, ఆన్-చైన్‌లో చెల్లించవచ్చు, మరియు 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[]. శరీరం రక్షిత వనరును పేరు పెట్టి ఒకటి లేదా ఎక్కువ ఆమోదయోగ్యమైన చెల్లింపు అవసరాలను జాబితా చేస్తుంది. ఒక మైగ్రేషన్ రెండు అవసరాలను ఉల్లేఖించవచ్చు (ఉదాహరణకు మైన్‌నెట్ మరియు టెస్ట్‌నెట్) మరియు క్లయింట్‌ను ఎంచుకోవడానికి అనుమతించవచ్చు.
  • స్కీమ్ / నెట్‌వర్క్ / చైన్ ID. చెల్లింపు స్కీమ్ (exact-usdc), చైన్ (మైన్‌నెట్ బేస్), మరియు దాని CAIP-2 ఐడి. చెల్లించడానికి ముందు క్లయింట్ వీటిపై సరిపోతుంది.
  • payToAddress / amountWeiUsdc. గ్రహీత వాలెట్ మరియు USDC ప్రాథమిక యూనిట్లలో ఖచ్చితమైన మొత్తం (50000 = 0.05 USDC, 6 డెసిమల్స్). చెల్లించడానికి ముందు క్లయింట్ రెండింటిని నిర్ధారిస్తుంది.
  • paymentRequestId + maxAgeSeconds. ఈ ఐడీ చెల్లింపును ఈ ఉల్లేఖనానికి కట్టిస్తుంది; maxAgeSeconds చెల్లింపు ఎంత తాజాగా ఉండాలి. ఒక వేరే ఐడీని సూచించే చెల్లింపు లేదా విండో కంటే పాతది తిరస్కరించబడుతుంది.
  • పునరావృతం X-Payment హెడ్డర్‌ను కలిగి ఉంది. క్లయింట్ on-chainలో చెల్లిస్తాడు, తరువాత చెల్లింపును నిరూపించే X-Payment హెడ్డర్‌తో అసలు అభ్యర్థనను మళ్లీ జారీ చేస్తాడు. సర్వర్ దీన్ని నిర్ధారిస్తుంది మరియు వాస్తవ ఫలితాన్ని తిరిగి ఇస్తుంది. ఎలాంటి ప్రతిస్పందన హెడ్డర్లు లేదా హోస్టెడ్ పేజీ x402 వైర్ యొక్క భాగం కాదు.
ఉదాహరణలు

x402 in the వనరు.

ప్రతి పొరలో ఆమోదం ఎంత పక్వంగా ఉందో ఆధారంగా క్రమబద్ధీకరించిన మూడు కాంక్రీట్ డిప్లాయ్‌మెంట్లు.

ఉదాహరణ 1

చెల్లించని టూల్ కాల్ కు 402 సవాలు తిరిగి MCP సర్వర్

ఒక చెల్లించిన MCP సాధనం Claude డెస్క్‌టాప్ నుండి ఒక ఆహ్వానం పొందుతుంది మరియు కాలర్ ఇంకా చెల్లించినట్లు గుర్తించబడలేదు. సర్వర్ ఒక requirePayment ఛాలెంజ్‌ను నిర్మిస్తుంది - ధర మరియు హోస్టెడ్ URLను కలిగి ఉన్న 402 - మరియు దాన్ని సాధన పొరపాటుగా తిరిగి ఇస్తుంది. Claude డెస్క్‌టాప్ చాట్లో లింక్‌ను చూపిస్తుంది; వినియోగదారు $0.05 USDC చెల్లిస్తాడు; అదే సాధనానికి తరువాత కాల్ విజయవంతమవుతుంది.

ఉదాహరణ 2

API ఎండ్‌పాయింట్ గేటింగ్ ప్రతి కాల్ బిల్లింగ్

ఒక పరిశోధన API x402 సర్వర్ అడాప్టర్ వెనుక ప్రతి కాల్‌కు $0.50 ఛార్జ్ చేస్తుంది. ఒక AI ఏజెంట్ ఎండ్ పాయింట్‌ను పిలుస్తుంది, మొత్తం మరియు గ్రహీతను జాబితా చేసే 402ను పొందుతుంది, తన వాలెట్ నుండి బేస్‌పై చెల్లిస్తుంది, మరియు X-Payment హెడ్డర్‌తో అభ్యర్థనను మళ్లీ జారీ చేస్తుంది. అడాప్టర్ హెడ్డర్‌ను నిర్ధారిస్తుంది మరియు చెల్లించిన ప్రతిస్పందనను తిరిగి ఇస్తుంది. మొత్తం చక్రం 60 సెకన్లలో పూర్తవుతుంది.

ఉదాహరణ 3

x402-అవగాహన వాలెట్ ద్వారా ప్రోగ్రామాటికల్‌గా చెల్లిస్తున్న ఏజెంట్

Agent runtime x402-aware గా ఉంటుంది (అది spec ను implement చేస్తుంది). 402 వచ్చినప్పుడు, అది accepts[] నుండి payToAddress మరియు amount ను చదివి, తన pre-authorized wallet నుండి (తన spend permission లోపల) transfer ను sign చేసి, Base పై broadcast చేసి, original call ను X-Payment header తో మళ్లీ ప్రయత్నిస్తుంది. మనుషుల జోక్యం లేదు; loop 5-10 seconds లో పూర్తవుతుంది.

సంబంధిత పదాలు

స్టాక్‌లో x402ని చుట్టుముట్టేది ఏమిటి.

x402 ప్రోటోకాల్. ఈ మూడు పదాలు ఇది ఉన్న పైన మరియు ఇది అనుమతించే ఉపయోగాలపై కవర్ చేస్తాయి.

ఏజెంటిక్ వాణిజ్యం

The umbrella concept; x402 is one protocol that enables it.

చెల్లించిన MCP సాధనం

నేటి x402 యొక్క అత్యంత సాధారణ production use.

ఏజెంట్ చెల్లింపు గుర్తింపు

x402 response‌లోని recipient address నిజంగా సూచించేది ఏమిటి.

తరచుగా అడిగే ప్రశ్నలు

మూడు సాధారణ ప్రశ్నలు.

x402 ఒక Coinbase ఉత్పత్తి లేదా ఓపెన్ ప్రోటోకాల్నా?

Coinbase ప్రచురించిన ఒక open protocol. ఈ spec GitHub లో ఉంది మరియు permissively licensed; Coinbase భాగస్వామ్యం లేకుండానే ఎవరైనా దీన్ని implement చేయవచ్చు. Coinbase ఒక reference implementation ను ship చేసి, facilitator service ను నడుపుతుంది, కానీ protocol Coinbase అనే కంపెనీకి స్వతంత్రం. Multiple facilitators (Blockchain0x, Coinbase, ecosystem పెరుగుతున్న కొద్దీ ఇతరులు) x402 payments ను settle చేయగలరు; మీరు server adapter ను wire up చేస్తున్నప్పుడు మీ facilitator ను ఎంచుకుంటారు, caller కాదు.

AI ఏజెంట్లు 402-తిరిగి వచ్చే APIని ఉపయోగించడానికి x402-జ్ఞానం కలిగి ఉండాలి吗?

ఇది 402 వేరియంట్‌పై ఆధారపడి ఉంటుంది. x402 సర్వర్ అడాప్టర్ x402-సమాచార క్లయింట్‌ను ఆశిస్తుంది: x402ని మాట్లాడని క్లయింట్ 402ని పొందుతుంది మరియు కేవలం ఫలితం పొందదు (సరైన ఫలితం - కాల్ చెల్లించబడలేదు). ఒక మానవుడు చెల్లించగలిగే సందర్భాల కోసం, Blockchain0x ఒక హోస్టెడ్-చెకౌట్ వేరియంట్‌ను అందిస్తుంది, దాని 402 శరీరంలో చెల్లింపు URL ఉంటుంది (ఇది MCP requirePayment ఛాలెంజ్ ఉపయోగించే విధానం), కాబట్టి ఒక చాట్ క్లయింట్ క్లిక్ చేయదగిన లింక్‌ను రూపొందించగలదు. కాలక్రమేణా, మరిన్ని క్లయింట్లు x402-సమాచారంగా మారుతాయి మరియు మానవుడి చొరవ లేకుండా ప్రోగ్రామాటిక్‌గా చెల్లిస్తాయి.

x402తో పోటీ చేసే ఇతర ప్రోటోకాల్‌లు ఏమిటి?

గూగుల్ యొక్క AP2 (ఏజెంట్ చెల్లింపుల ప్రోటోకాల్) విభిన్న డిజైన్ (ఆదేశం ఆధారితమైనది కంటే 402 ఆధారితమైనది) తో సమానమైన భూమిని కవర్ చేస్తుంది. స్ట్రైప్ ఏజెంట్ చెల్లింపుల పొరను సంకేతం చేసింది కానీ ఇంకా ఒక ప్రజా స్పెక్స్‌ను ప్రచురించలేదు. అనేక చిన్న ప్రాజెక్టులు (బిట్‌కాయిన్ లైట్‌నింగ్ ఇకోసిస్టమ్‌లో L402) x402కి ముందు సమానమైన ఆలోచనలతో ఉన్నాయి. x402 ఈ రోజు EVM/stablecoin ఏజెంట్ ఇకోసిస్టమ్‌లో అత్యంత అమలు చేయబడిన ప్రోటోకాల్; AP2 గూగుల్ ఇకోసిస్టమ్‌లో ముందంజలో ఉంది. అవి ఒకటి గెలవడం కంటే సహజంగా ఉండే అవకాశం ఉంది, ఎందుకంటే అవి కొంచెం వేరు వేరు అమలు సందర్భాలను లక్ష్యంగా చేసుకుంటాయి.
చివరి సమీక్ష: 2026-05-15. CC BY 4.0 కింద ప్రచురించబడింది.

మీ ఏజెంట్‌తో x402 మాట్లాడండి.

Blockchain0x ఒక x402 సదుపాయాన్ని అందిస్తుంది. ప్రారంభించడానికి ఉచితం. మీ మొదటి ఏజెంట్ వాలెట్‌కు ఐదు నిమిషాలు.