x402 là gì.
x402 là một giao thức mở cho các khoản thanh toán gốc HTTP, được Coinbase công bố vào cuối năm 2024. Nó định nghĩa cách một máy chủ trả về 402 Payment Required với một thân JSON có cấu trúc - một danh sách các yêu cầu thanh toán chấp nhận được (chương trình, mạng, id chuỗi, địa chỉ người nhận, số tiền bằng đơn vị cơ bản USDC, và một id yêu cầu thanh toán) - để một máy khách có thể phân tích phản hồi, thanh toán trên chuỗi, và thử lại cuộc gọi ban đầu với một tiêu đề X-Payment, tất cả đều lập trình.
HTTP 402 đã không được sử dụng trong ba mươi năm. x402 đã làm cho nó hoạt động.
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.
Tầm quan trọng chiến lược của x402 là nó thiết lập một tiêu chuẩn mà phần còn lại của hệ sinh thái có thể xây dựng dựa trên. Ví thực hiện một trình xử lý x402 một lần, và mọi API tuân thủ x402 đều hoạt động với ví đó. Các khung máy chủ thực hiện một middleware x402 một lần, và mọi khách hàng nhận thức x402 đều có thể thanh toán cho họ. Các nhà tạo điều kiện (các dịch vụ giải quyết các khoản thanh toán cơ bản) cạnh tranh về chất lượng dịch vụ thay vì về sự khóa chặt.
Một phản hồi, một thử lại, một thanh toán.
Vòng đời có ba trạng thái: cuộc gọi chưa thanh toán, thanh toán, cuộc gọi đã thử lại. Dưới đây là những gì phản hồi cuộc gọi chưa thanh toán thực sự trông như thế nào qua mạng.
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[]. Thân xác định tài nguyên được bảo vệ và liệt kê một hoặc nhiều yêu cầu thanh toán chấp nhận được. Một cuộc di cư có thể trích dẫn hai yêu cầu (ví dụ: mainnet và testnet) và để khách hàng chọn.
- scheme / network / chainId. Sơ đồ thanh toán (exact-usdc), chuỗi (mainnet là Base), và id CAIP-2 của nó. Khách hàng khớp với những điều này trước khi thanh toán.
- payToAddress / amountWeiUsdc. Ví người nhận và số tiền chính xác bằng đơn vị cơ bản USDC (50000 = 0.05 USDC, 6 chữ số thập phân). Khách hàng xác minh cả hai trước khi thanh toán.
- paymentRequestId + maxAgeSeconds. ID liên kết thanh toán với báo giá này; maxAgeSeconds là mức độ mới của thanh toán phải như thế nào. Một thanh toán tham chiếu đến một ID khác, hoặc cũ hơn khoảng thời gian, sẽ bị từ chối.
- Cuộc thử lại mang theo một tiêu đề X-Payment. Khách hàng thanh toán trên chuỗi, sau đó phát hành lại yêu cầu gốc với một tiêu đề X-Payment chứng minh thanh toán. Máy chủ xác minh và trả về kết quả thực tế. Không có tiêu đề phản hồi hoặc trang lưu trữ nào là một phần của x402 wire.
x402 trong thực tế.
Ba triển khai cụ thể, được sắp xếp theo mức độ trưởng thành của việc áp dụng trong mỗi lớp.
Máy chủ MCP trả về một thách thức 402 cho một cuộc gọi công cụ chưa thanh toán
Một công cụ MCP trả phí nhận được một lời gọi từ Claude Desktop và người gọi chưa được đánh dấu là đã thanh toán. Máy chủ xây dựng một thử thách requirePayment - một 402 mà thân mang giá và một hostedUrl - và trả về nó như một lỗi công cụ. Claude Desktop hiển thị liên kết trong cuộc trò chuyện; người dùng thanh toán $0.05 USDC; cuộc gọi tiếp theo đến cùng một công cụ thành công.
Cổng điểm cuối API tính phí theo cuộc gọi
Một API nghiên cứu tính phí $0.50 cho mỗi cuộc gọi qua bộ chuyển đổi máy chủ x402. Một đại lý AI gọi điểm cuối, nhận được một 402 liệt kê số tiền và người nhận, thanh toán trên Base từ ví của nó, và phát hành lại yêu cầu với một tiêu đề X-Payment. Bộ chuyển đổi xác minh tiêu đề và trả về phản hồi đã thanh toán. Toàn bộ vòng lặp hoàn thành trong chưa đầy 60 giây.
Tác nhân thanh toán theo chương trình qua ví nhận biết x402
Thời gian chạy của một đại lý nhận thức được x402 (nó thực hiện đặc tả). Khi nó gặp lỗi 402, nó đọc payToAddress và số tiền từ accepts[], ký một chuyển khoản từ ví đã được ủy quyền trước của nó (trong phạm vi quyền chi tiêu của nó), phát sóng trên Base và thử lại cuộc gọi gốc với tiêu đề X-Payment. Không có sự can thiệp của con người; vòng lặp hoàn thành trong 5-10 giây.
Những gì bao quanh x402 trong ngăn xếp.
x402 là giao thức. Ba thuật ngữ này bao gồm các khái niệm mà nó dựa vào và các trường hợp sử dụng mà nó cho phép.