Để AI agent thanh toán bằng OKXvà tự đăng ký
Thanh toán bằng OKX Wallet qua x402 để nhận API key và số dư trong một yêu cầu.
- USD₮0 trên X Layer, quyết toán qua OKX
- Không cần thẻ tín dụng hay biểu mẫu đăng ký
- Người dùng thông thường cũng có thể nạp bằng x402
curl -i -X POST https://bazaarlink.ai/api/v1/agents/register/x402 \
-H "Content-Type: application/json" \
-d '{"name":"my-agent","amountUsd":1.1}'HTTP/1.1 402 Payment Required
Content-Type: application/json
{
"x402Version": 2,
"resource": {
"url": "https://bazaarlink.ai/api/v1/agents/register/x402",
"description": "BazaarLink paid agent registration",
"mimeType": "application/json"
},
"accepts": [
{
"scheme": "exact",
"network": "eip155:196",
"payTo": "0xPAY_TO_ADDRESS",
"asset": "0xASSET_CONTRACT",
"amount": "1100000",
"maxTimeoutSeconds": 300,
"extra": { "name": "USD₮0", "version": "1" }
}
]
}x402 là gì
- POST
/api/v1/agents/register/x402 - ← 402
accepts[ network, asset, amount, payTo ] - sign
EIP-3009 - POST
X-PAYMENT: … - ← 201
api_key, credits, claim_token
Thanh toán được quyết toán qua x402 facilitator của OKX trên X Layer; máy chủ kiểm tra từng khoản trước khi xử lý.
HTTP 402 yêu cầu thanh toán
Máy chủ trả về 402 và liệt kê mạng, tài sản, số tiền cùng địa chỉ nhận được chấp nhận. Client ký ủy quyền thanh toán rồi gửi lại cùng yêu cầu. BazaarLink quyết toán từng khoản qua x402 facilitator của OKX trên X Layer.
api_keysk-bl-…credits5claim_token…payment.txHash0x…Không cần tài khoản trước
agent không cần điền biểu mẫu hay tạo tài khoản trước. Yêu cầu kèm thanh toán sẽ tạo tài khoản, cấp API key và cộng số dư.
Bốn bước từ yêu cầu đến API key
Gửi yêu cầu
POST tới /api/v1/agents/register/x402 với tên và số tiền đô la Mỹ bạn muốn thanh toán.
Nhận 402
Máy chủ trả về 402 cùng yêu cầu thanh toán. Chưa có gì được tạo ở bước này.
Ký và gửi lại
Dùng ví của bạn ký ủy quyền thanh toán, đặt vào header X-PAYMENT rồi gửi lại cùng yêu cầu.
Nhận API key
Sau khi thanh toán được xác nhận, bạn nhận 201 gồm API key, số dư và liên kết nhận tài khoản. API key chỉ xuất hiện trong phản hồi này, hãy lưu ngay.
Đã có tài khoản? Nạp tiền bằng x402
agent dùng API key hiện có. Người dùng thông thường đăng nhập rồi nạp tiền từ trang tín dụng.
Agent và script
POST tới /api/x402/topup với header Authorization và amountUsd. Quy trình giống đăng ký: báo giá, ký, gửi lại.
Người dùng thông thường
Đăng nhập, mở trang tín dụng, chọn x402 rồi ký thanh toán bằng ví trình duyệt.
Mạng và tài sản được hỗ trợ
Hiện hỗ trợ một tổ hợp.
- Mạng
- X Layer, quyết toán qua x402 facilitator của OKX
- Tài sản
- USD₮0
- Số dư
- Áp dụng phí nạp tiền của nền tảng, nên số dư được cộng thấp hơn số tiền đã trả (xem bảng giá)
- Số tiền mỗi lần thanh toán
- Có mức tối thiểu và tối đa; xem giới hạn hiện tại trong phản hồi 402 và GET /api/x402/topup
Thanh toán on-chain không thể hoàn tác. Kiểm tra số tiền và mạng trước khi ký.
Chưa thanh toán? Model miễn phí vẫn hoạt động
Tài khoản agent chưa thanh toán dùng hạn mức model miễn phí và giới hạn tần suất hiện có (auto:free). Sau khi thanh toán, tài khoản tuân theo quy tắc thông thường của tài khoản trả phí.
Câu hỏi thường gặp
x402 là gì?
x402 là giao thức dùng mã trạng thái HTTP 402 để yêu cầu thanh toán. Máy chủ nêu số tiền, mạng và địa chỉ nhận; client ký ủy quyền thanh toán rồi gửi lại cùng yêu cầu.
Cần gì để thanh toán bằng x402?
OKX Wallet hoặc bất kỳ khóa ví nào có thể ký ủy quyền EIP-3009, cùng USD₮0 trên X Layer. Tài liệu tích hợp có mã TypeScript dùng client x402 để ký.
Mạng và tài sản nào được hỗ trợ?
USD₮0 trên X Layer, được quyết toán qua x402 facilitator của OKX. Áp dụng phí nạp tiền của nền tảng, nên số dư bạn nhận thấp hơn số tiền đã trả; xem bảng giá.
Nếu thanh toán hoặc gửi lại hai lần thì sao?
Mỗi khoản thanh toán chỉ được cộng một lần. Gửi lại cùng khoản thanh toán khi nạp tiền sẽ trả về already_credited. Đăng ký trả về cùng kết quả trong 15 phút; sau đó trả về already_registered và API key không được hiển thị lại.
Có thể hoàn tiền không?
Thanh toán on-chain không thể hoàn tác và hệ thống không tự động hoàn tiền. Liên hệ bộ phận hỗ trợ nếu có vấn đề.
Đăng ký có giới hạn không?
Có. Đăng ký từ cùng một nguồn mạng bị giới hạn trong một khoảng thời gian ngắn. Khi chạm giới hạn, bạn nhận 429 cùng header Retry-After; hãy chờ rồi thử lại.
Một người có thể nhận tài khoản agent không?
Có. Phản hồi đăng ký gồm claim_token và upgrade_url. Người đó đăng nhập và nhận tài khoản, API key cùng số dư sẽ chuyển sang tài khoản của họ. claim_expires cho biết thời hạn.