x402 là gì?
x402 là giao thức thanh toán máy-với-máy được xây dựng xung quanh HTTP402 Payment Required. Nó cho phép các tác nhân AI tự động thanh toán cho quyền truy cập API mà không cần sự can thiệp của con người. AgentWallex triển khai x402 v2 với payload ủy quyền EIP-3009.
Header x402 v2
Giao thức sử dụng ba header HTTP:Luồng Thanh toán
1
Tác nhân yêu cầu tài nguyên
Tác nhân gửi yêu cầu HTTP tiêu chuẩn đến endpoint API trả phí.
2
Server trả về 402
API phản hồi với HTTP 402 và header
PAYMENT-REQUIRED chứa chi tiết giá cả (số tiền, token, chuỗi, địa chỉ payTo).3
Tác nhân thanh toán qua AgentWallex
Tác nhân gửi chi tiết thanh toán đến
POST /x402/pay. AgentWallex đánh giá chính sách và ký thanh toán.4
Tác nhân thử lại với bằng chứng thanh toán
Tác nhân thử lại yêu cầu ban đầu với header
PAYMENT-SIGNATURE được đính kèm.5
Server xác minh và phản hồi
API xác minh chữ ký thanh toán (qua facilitator AgentWallex) và trả về tài nguyên.
Sử dụng API x402
Kiểm tra URL có Hỗ trợ x402 không
Tạo Ngân sách Phiên
Phiên cho phép bạn ủy quyền trước ngân sách chi tiêu cho các cuộc gọi API lặp lại:Kích hoạt Thương lượng Thanh toán
payment_info với:
Tích hợp SDK
Bộ chặn HTTP Tự động
SDK TypeScript cung cấp bộ chặn xử lý toàn bộ luồng x402 tự động:Luồng Thủ công
Dành cho Nhà cung cấp Dịch vụ
Nếu bạn cung cấp API trả phí, server của bạn nên trả về thách thức x402 v2 khi thiếu thanh toán.Trả về 402 với PAYMENT-REQUIRED
Mã hóa thách thức JSON (base64) vào headerPAYMENT-REQUIRED: