Swap your API key for a sk_test_ key - that alone puts you on Base Sepolia. Fund the agent's wallet from the public Base Sepolia USDC faucet, make a real test payment with payments.create (test funds, no real money), and tunnel your local webhook through ngrok. The response shapes match live, so a flow that passes in test passes in production. Exercise the failure paths, not just the happy one.

Chuyển sang khóa thử nghiệm.

Một khóa sk_test_ giao dịch trên Base Sepolia; một khóa sk_live_ giao dịch trên Base mainnet. Tiền tố chọn mạng - không có biến môi trường mạng riêng biệt, và một khóa thử nghiệm không thể di chuyển các quỹ mainnet. Vì vậy, tất cả những gì bạn thay đổi cho một môi trường phát triển là khóa (và bí mật webhook thử nghiệm).

# .env.development
# A sk_test_ key picks Base Sepolia automatically - there is no network env var.
BLOCKCHAIN0X_API_KEY=sk_test_01J9...
BLOCKCHAIN0X_WEBHOOK_SECRET=...   # the test webhook's secret, from the dashboard

Thực hiện một khoản thanh toán thử nghiệm thực sự.

Khi wallet đã được nạp, hãy gọi payments.create bằng khóa sk_test_ của bạn. Đây là một giao dịch thật trên Base Sepolia bằng tiền thử, và nó kích hoạt webhook payment.received đúng như trên mainnet - vì vậy bạn đang kiểm tra luồng mã thực tế, không phải mô phỏng. Hãy theo dõi sự kiện đến handler được tunnel của bạn.

// On a sk_test_ key this is a REAL transfer on Base Sepolia (test funds, no
// real money). It fires the payment.received webhook just like mainnet does.
const tx = await client.payments.create({
  agentId: "agt_123",
  to: "0xRecipientOnSepolia",
  amountWei: "10000", // 0.01 USDC
});

console.log(tx); // watch payment.received arrive at your webhook

tx = client.payments.create(body={
    "agentId": "agt_123",
    "to": "0xRecipientOnSepolia",
    "amountWei": "10000",  # 0.01 USDC
})

print(tx)  # watch payment.received arrive at your webhook

Ba kịch bản để thực hiện tối thiểu: một khoản thanh toán được thực hiện (đường đi hạnh phúc, payment.received), một khoản thanh toán không bao giờ được thực hiện (chỉ định webhook đến một URL chết và xác nhận rằng việc đối chiếu của bạn bắt được công việc bị kẹt - con đường mà hầu hết các đội bỏ qua), và một lần thử lại webhook (ép buộc 500 lần đầu tiên và 200 lần thứ hai, sau đó xác minh rằng tính bất biến của bạn đã bỏ qua công việc trùng lặp).

Thất bại nhanh chóng với các khóa cấu hình sai.

Sự cố sản xuất phổ biến nhất xung quanh các khóa thử nghiệm/trực tiếp là im lặng: một triển khai xảy ra với một khóa thử nghiệm, không có thanh toán nào được thực hiện, cảnh báo chỉ được kích hoạt sau ngày làm việc tiếp theo. Chặn điều này khi khởi động: từ chối khởi động nếu biến môi trường và tiền tố khóa không khớp.

// Fail fast if test/live get mixed up.
const apiKey = process.env.BLOCKCHAIN0X_API_KEY!;
const env = process.env.NODE_ENV;

if (env === "production" && apiKey.startsWith("sk_test_")) {
  throw new Error("Test key in production environment - aborting boot.");
}
if (env !== "production" && apiKey.startsWith("sk_live_")) {
  throw new Error("Live key in non-production environment - aborting boot.");
}

import os, sys

api_key = os.environ["BLOCKCHAIN0X_API_KEY"]
env = os.environ.get("ENV", "development")

if env == "production" and api_key.startswith("sk_test_"):
    sys.exit("Test key in production environment - aborting boot.")
if env != "production" and api_key.startswith("sk_live_"):
    sys.exit("Live key in non-production environment - aborting boot.")

Khi vòng lặp thử nghiệm nằm trong chu trình phát triển của bạn.

Khi đã có vòng kiểm thử ổn định, phần việc còn lại chủ yếu là củng cố: xử lý webhook đáng tin cậy khi tải cao, danh sách kiểm tra bảo mật cuối cùng, và di chuyển từ bất kỳ nhà cung cấp thanh toán nào trước đó mà bạn có thể đang chạy song song.

Tài liệu tham khảo đầy đủ tại docs.blockchain0x.com. Chi tiết Testnet: Thuật ngữ chuỗi cơ sở. Bề mặt sản phẩm: API Thanh toán.