HTTP 402 đã trở lại: AI trí tuệ nhân tạo bắt đầu tự thanh toán cho API

Đối tượng thông minh của bạn cần gọi một giao diện. Đường dẫn thông thường hoàn toàn được thiết kế cho con người: đăng ký tài khoản, xác minh email, liên kết thẻ tín dụng, lấy khóa API, chọn gói đăng ký------để sử dụng 17 lần, trước tiên mua gói 10000 lần.

Thực ra còn một con đường thứ tư, và nó đã 30 tuổi: mã trạng thái HTTP 402 Payment Required, đã được dự trữ trong tiêu chuẩn HTTP ban đầu, ghi chú "dành cho sử dụng trong tương lai". Tương lai đã đến. Giao thức x402 (v2, do Coinbase dẫn đầu duy trì) biến 402 thành một bộ bắt tay thanh toán có thể sử dụng: máy chủ trả về một báo giá, đối tượng thông minh ký một giấy ủy quyền thanh toán bằng stablecoin, bên thanh toán hoàn tất chuyển khoản trên chuỗi, giao diện ngay lập tức trả về kết quả------không cần tài khoản, không cần khóa, không cần đăng ký. Việc thanh toán chính là xác thực danh tính.

Đây không phải là hướng dẫn tài liệu trắng. Mỗi bước dưới đây đã được kiểm tra thực tế với giao diện trực tuyến (dịch vụ thử nghiệm: call402.com, một dịch vụ x402 công khai đang hoạt động), báo giá và phản hồi xuất hiện đều là dữ liệu thực, không có chỗ nào là hình minh họa.

Bước đầu tiên: hỏi giá------một bảng báo giá thực

Không trả tiền mà gọi bất kỳ giao diện nào, bạn sẽ nhận được HTTP 402 và một bảng báo giá có thể đọc được bởi máy:
BASH sao chép

curl -X POST https://call402.com/api/phone-lookup \
  -H 'Content-Type: application/json' \
  -d '{"number": "+14155552671"}'

JSON sao chép

{
  "x402Version": 2,
  "accepts": [{
    "scheme": "exact",
    "network": "eip155:8453",
    "amount": "5000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0xAc6F1C3C3b17040730F16dC24Ee9993e9565BE4A",
    "maxTimeoutSeconds": 300,
    "extra": { "name": "USD Coin", "version": "2" }
  }]
}

Đọc nó như một nhãn giá: amount là đơn vị tối thiểu, 5000 chính là 0.005 đô la (USDC có 6 chữ số thập phân); asset là hợp đồng USDC trên chuỗi Base; payTo là bên nhận tiền; bạn có 300 giây để thanh toán theo báo giá này.

Bước thứ hai: thanh toán và gọi------mã của người mua tổng cộng như vậy

Sử dụng thư viện TypeScript chính thức, người mua hoàn chỉnh chỉ là vài dòng này:
TYPESCRIPT sao chép

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
const client = new x402Client();
client.register("eip155:*", new ExactEvmScheme(signer));
const fetchWithPay = wrapFetchWithPayment(fetch, client);

const res = await fetchWithPay("https://call402.com/api/phone-lookup", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ number: "+14155552671" }),
});
console.log(await res.json());

// Chứng từ thanh toán được trả về trong tiêu đề phản hồi PAYMENT-RESPONSE:
const proof = res.headers.get("PAYMENT-RESPONSE");
if (proof) {
  const settlement = JSON.parse(Buffer.from(proof, "base64").toString("utf8"));
  console.log("tx:", settlement.transaction, "payer:", settlement.payer);
}

BASH sao chép

npm i @x402/fetch @x402/core @x402/evm viem

Bộ bọc thấy 402, sẽ xây dựng một giấy ủy quyền thanh toán EIP-3009 theo báo giá, kèm theo chữ ký thử lại, bên thanh toán ngay lập tức hoàn tất chuyển khoản USDC này trên Base. Phản hồi chính là JSON thông thường:
JSON sao chép

{ "valid": true, "country": "US", "type": "FIXED_LINE_OR_MOBILE",
  "e164": "+14155552671", "national": "(415) 555-2671" }

Các giao diện khác của cửa hàng này------và bất kỳ người bán x402 nào------cách sử dụng hoàn toàn giống nhau. Một người mua, đi khắp mọi cửa hàng.

Bước thứ ba: đừng tin 200, tự xác minh thanh toán

Giải mã tiêu đề phản hồi PAYMENT-RESPONSE (nó là JSON mã hóa Base64), kiểm tra ba điều: giao dịch này thực sự tồn tại trên trình duyệt Base và trạng thái thành công; hồ sơ chuyển khoản USDC thực sự từ địa chỉ của bạn đến payTo trong báo giá; số tiền và báo giá amount không sai lệch. Nếu có một trong ba điều không khớp, ghi lại và dừng lại------đừng thanh toán lại ngay lập tức.

Những cạm bẫy thực tế sẽ gặp phải chỉ có vài cái:

Bước thứ tư: đặt ra một kỷ luật ngân sách cho ví

Đối tượng thông minh có thể ký, chính là đối tượng thông minh có thể tiêu tiền. Bốn quy tắc khiến nó trở nên nhàm chán:

1. Giới hạn tối đa một lần (ví dụ 0.01 đô la) và giới hạn tối đa hàng ngày (ví dụ 1 đô la), đều phải được kiểm tra trước khi ký.
2. Danh sách trắng tên miền và tài sản ------người mua nên từ chối bất kỳ báo giá nào ngoài danh sách trắng.
3. Ví chuyên dụng, chỉ chứa số dư tối đa, không bao giờ sử dụng ví chính.
4. Một sổ chi tiêu chỉ tăng không giảm: mã giao dịch, giao diện, số tiền, định kỳ đối chiếu với chuyển khoản trên chuỗi.

Cuối cùng để lại một câu hỏi

Nếu đối tượng thông minh của bạn có một ví ngân sách 1 đô la mỗi ngày, bạn sẽ để nó tự mua gì trước? Còn có điều gì mà bạn tuyệt đối không cho phép nó chạm vào? Khi cánh cửa thanh toán được mở ra, những gì đối tượng thông minh có thể tự làm sẽ tăng lên rất nhiều------và mỗi người đặt ra ranh giới ở đâu, có thể quyết định hơn cả công nghệ này sẽ đi về đâu.