Skip to main content

x402 là gì?

x402 là giao thức thanh toán máy-với-máy được xây dựng xung quanh HTTP 402 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

Phản hồi bao gồm 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 header PAYMENT-REQUIRED:

Xác minh và Thanh toán

Sử dụng các endpoint facilitator của AgentWallex:

Giá trị Mặc định Vận hành