x402 nedir.
x402, 2024'ün sonlarında Coinbase tarafından yayınlanan HTTP yerel ödemeleri için açık bir protokoldür. Bir sunucunun, yapılandırılmış bir JSON gövdesi ile 402 Ödeme Gereklidir döndürmesini tanımlar - kabul edilebilir ödeme gereksinimlerinin bir listesi (şeması, ağ, zincir kimliği, alıcı adresi, USDC temel birimlerinde miktar ve bir ödeme talep kimliği) - böylece bir makine istemcisi yanıtı ayrıştırabilir, zincir üzerinde ödeme yapabilir ve orijinal çağrıyı bir X-Payment başlığı ile programlı olarak yeniden deneyebilir.
HTTP 402 otuz yıl boyunca kullanılmadan durdu. x402 bunu çalıştırdı.
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'nin stratejik önemi, ekosistemin geri kalanının inşa edebileceği bir standart belirlemesidir. Cüzdanlar bir kez x402 işleyicisi uygular ve her x402 uyumlu API o cüzdanla çalışır. Sunucu çerçeveleri bir kez x402 ara katmanını uygular ve her x402 farkında olan istemci onlara ödeme yapabilir. Kolaylaştırıcılar (temel ödemeleri çözen hizmetler) kilitlenme yerine hizmet kalitesi üzerinde rekabet eder.
Bir yanıt, bir yeniden deneme, bir ödeme.
Yaşam döngüsünün üç durumu vardır: ödenmemiş çağrı, ödeme, yeniden denenen çağrı. Aşağıda, ödenmemiş çağrının yanıtının kabloda nasıl göründüğünü görebilirsiniz.
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[]. Gövde, korunan kaynağı adlandırır ve bir veya daha fazla kabul edilebilir ödeme gereksinimini listeler. Bir geçiş, iki gereksinimi (örneğin ana ağ ve test ağı) alıntılayabilir ve müşterinin seçmesine izin verebilir.
- scheme / network / chainId. Ödeme şeması (exact-usdc), zincir (ana ağ Base'dir) ve CAIP-2 kimliği. Müşteri, ödeme yapmadan önce bunlarla eşleşir.
- payToAddress / amountWeiUsdc. Alıcı cüzdanı ve USDC temel birimlerinde tam miktar (50000 = 0.05 USDC, 6 ondalık). Müşteri, ödeme yapmadan önce her ikisini de doğrular.
- paymentRequestId + maxAgeSeconds. Kimlik, ödemeyi bu alıntıya bağlar; maxAgeSeconds, ödemenin ne kadar taze olması gerektiğidir. Farklı bir kimliği referans alan veya pencerenin daha eski bir ödemesi reddedilir.
- Tekrar deneme, bir X-Payment başlığı taşır. Müşteri zincir üzerinde ödeme yapar, ardından ödemenin kanıtı olan bir X-Payment başlığı ile orijinal isteği yeniden gönderir. Sunucu bunu doğrular ve gerçek sonucu döner. Hiçbir yanıt başlığı veya barındırılan sayfa x402 telinin bir parçası değildir.
x402 doğada.
Her katmanda benimsemenin ne kadar olgun olduğuna göre sıralanmış üç somut dağıtım.
MCP sunucusu, ödenmemiş bir araç çağrısına 402 zorluğu döndürüyor
Ücretli bir MCP aracı, Claude Desktop'tan bir çağrı alır ve arayan henüz ödenmiş olarak işaretlenmemiştir. Sunucu, fiyatı ve bir hostedUrl taşıyan bir requirePayment zorluğu oluşturur - bir 402 - ve bunu bir araç hatası olarak döner. Claude Desktop, bağlantıyı sohbet içinde görüntüler; kullanıcı 0,05 $ USDC öder; aynı araca yapılan bir sonraki çağrı başarılı olur.
API uç noktası çağrı başına faturalama
Bir araştırma API'si, x402 sunucu adaptörünün arkasında her çağrı için 0,50 $ ücret alır. Bir AI ajanı uç noktayı arar, miktarı ve alıcıyı listeleyen bir 402 alır, cüzdanından Base üzerinde ödeme yapar ve X-Payment başlığı ile isteği yeniden gönderir. Adaptör başlığı doğrular ve ödenmiş yanıtı döner. Tüm döngü 60 saniyeden kısa sürede tamamlanır.
x402 uyumlu cüzdan aracılığıyla programatik olarak ödeme yapan ajan
Bir ajanın çalışma zamanı x402'ye duyarlıdır (spesifikasyonu uygular). 402'ye ulaştığında, accepts[]'den payToAddress ve miktarı okur, önceden yetkilendirilmiş cüzdanından (harcama izni içinde) bir transfer imzalar, Base'de yayın yapar ve orijinal çağrıyı bir X-Payment başlığı ile tekrar dener. İnsan müdahalesi yoktur; döngü 5-10 saniyede tamamlanır.
Yığın içinde x402'yi çevreleyen nedir.
x402 protokoldür. Bu üç terim, üzerine oturduğu kavramları ve mümkün kıldığı kullanım durumlarını kapsar.