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), ਚੇਨ (ਮੁੱਖ ਨੈੱਟ ਬੇਸ ਹੈ), ਅਤੇ ਇਸਦਾ 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 ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ, ਆਪਣੇ ਵਾਲਿਟ ਤੋਂ ਬੇਸ 'ਤੇ ਭੁਗਤਾਨ ਕਰਦਾ ਹੈ, ਅਤੇ X-Payment ਹੈਡਰ ਨਾਲ ਬੇਨਤੀ ਨੂੰ ਦੁਬਾਰਾ ਜਾਰੀ ਕਰਦਾ ਹੈ. ਐਡਾਪਟਰ ਹੈਡਰ ਦੀ ਪੁਸ਼ਟੀ ਕਰਦਾ ਹੈ ਅਤੇ ਭੁਗਤਾਨ ਕੀਤੀ ਜਵਾਬ ਵਾਪਸ ਕਰਦਾ ਹੈ. ਪੂਰਾ ਲੂਪ 60 ਸਕਿੰਟਾਂ ਤੋਂ ਘੱਟ ਸਮੇਂ ਵਿੱਚ ਪੂਰਾ ਹੁੰਦਾ ਹੈ.
ਏਜੰਟ x402-ਜਾਣਕਾਰੀ ਵਾਲੇ ਵੈਲਟ ਰਾਹੀਂ ਪ੍ਰੋਗਰਾਮੈਟਿਕ ਤੌਰ 'ਤੇ ਭੁਗਤਾਨ ਕਰ ਰਿਹਾ ਹੈ
ਇੱਕ ਏਜੰਟ ਦਾ ਰਨਟਾਈਮ x402-ਜਾਣਕਾਰੀ ਵਾਲਾ ਹੈ (ਇਹ ਵਿਸ਼ੇਸ਼ਤਾ ਨੂੰ ਲਾਗੂ ਕਰਦਾ ਹੈ)। ਜਦੋਂ ਇਹ 402 'ਤੇ ਪਹੁੰਚਦਾ ਹੈ, ਇਹ payToAddress ਅਤੇ amount ਨੂੰ accepts[] ਤੋਂ ਪੜ੍ਹਦਾ ਹੈ, ਆਪਣੇ ਪੂਰਵ-ਅਧਿਕਾਰਿਤ ਵੈਲਿਟ ਤੋਂ ਇੱਕ ਹਵਾਲਾ ਸਾਈਨ ਕਰਦਾ ਹੈ (ਇਸਦੀ ਖਰਚ ਕਰਨ ਦੀ ਆਗਿਆ ਦੇ ਅੰਦਰ), Base 'ਤੇ ਪ੍ਰਸਾਰਿਤ ਕਰਦਾ ਹੈ, ਅਤੇ X-Payment ਹੈਡਰ ਨਾਲ ਮੂਲ ਕਾਲ ਨੂੰ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰਦਾ ਹੈ। ਕੋਈ ਮਨੁੱਖੀ ਸ਼ਾਮਿਲਤਾ ਨਹੀਂ; ਲੂਪ 5-10 ਸਕਿੰਟ ਵਿੱਚ ਪੂਰਾ ਹੁੰਦਾ ਹੈ।
ਸਟੈਕ ਵਿੱਚ x402 ਦੇ ਆਸ-ਪਾਸ ਕੀ ਹੈ।
x402 ਪ੍ਰੋਟੋਕੋਲ ਹੈ। ਇਹ ਤਿੰਨ ਸ਼ਬਦ ਉਹ ਧਾਰਨਾਵਾਂ ਨੂੰ ਕਵਰ ਕਰਦੇ ਹਨ ਜੋ ਇਹ ਉੱਪਰ ਬੈਠੇ ਹਨ ਅਤੇ ਇਸ ਦੇ ਯੂਜ਼ ਕੇਸਾਂ ਨੂੰ ਯੋਗ ਬਣਾਉਂਦੇ ਹਨ।