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.

เปลี่ยนไปใช้กุญแจทดสอบ.

คีย์ sk_test_ ทำธุรกรรมบน Base Sepolia; คีย์ sk_live_ ทำธุรกรรมบน Base mainnet คำนำหน้าจะเลือกเครือข่าย - ไม่มีตัวแปรสภาพแวดล้อมเครือข่ายแยกต่างหาก และคีย์ทดสอบไม่สามารถย้ายเงินใน mainnet ได้ ดังนั้นสิ่งที่คุณเปลี่ยนสำหรับสภาพแวดล้อมการพัฒนาคือคีย์ (และความลับ webhook ทดสอบ).

# .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

ทำการชำระเงินทดสอบจริง

เมื่อกระเป๋าเงินมีเงินทุนแล้ว ให้เรียก payments.create บนคีย์ sk_test_ ของคุณ มันเป็นการโอนจริงบน Base Sepolia โดยใช้เงินทดสอบ และมันจะส่ง webhook payment.received เช่นเดียวกับที่ mainnet จะทำ - ดังนั้นคุณจึงใช้เส้นทางโค้ดจริง ไม่ใช่การจำลอง ดูเหตุการณ์ที่เข้ามาที่ตัวจัดการที่อุโมงค์ของคุณ

// 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

สามสถานการณ์ที่ต้องฝึกฝนอย่างน้อย: การชำระเงินที่ถึงที่หมาย (เส้นทางที่ดี การชำระเงินที่ได้รับ), การชำระเงินที่ไม่เคยถึงที่หมาย (ชี้ webhook ไปที่ URL ที่ตายและยืนยันว่าการทำความสะอาดการปรับยอดของคุณจับงานที่ติดอยู่ - เส้นทางที่ทีมส่วนใหญ่ละเลย), และการลองใหม่ของ webhook (บังคับให้เกิด 500 ครั้งแรกและ 200 ครั้งที่สอง จากนั้นตรวจสอบว่าคุณได้ข้ามงานที่ซ้ำซ้อนหรือไม่).

ล้มเหลวอย่างรวดเร็วเมื่อกุญแจถูกกำหนดค่าไม่ถูกต้อง

เหตุการณ์การผลิตที่พบบ่อยที่สุดเกี่ยวกับคีย์ทดสอบ/สดคือความเงียบ: การปรับใช้เกิดขึ้นด้วยคีย์ทดสอบ ไม่มีการชำระเงินเข้ามา การแจ้งเตือนจะถูกส่งออกหลังจากวันทำการถัดไป ปิดกั้นนี้ที่การบูต: ปฏิเสธที่จะเริ่มหาก env และคีย์พรีฟิกซ์ไม่ตรงกัน

// 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.")

เมื่อวงจรการทดสอบอยู่ในวงจรการพัฒนาของคุณ

เมื่อมีวงจรการทดสอบที่มีสุขภาพดีอยู่แล้ว งานที่เหลือส่วนใหญ่จะเป็นการเสริมความแข็งแกร่ง: การจัดการ webhook ที่เชื่อถือได้ภายใต้ภาระงาน, รายการตรวจสอบความปลอดภัยขั้นสุดท้าย, และการย้ายจากผู้ให้บริการการชำระเงินก่อนหน้าที่คุณอาจกำลังใช้งานอยู่

เอกสารอ้างอิงทั้งหมดที่ docs.blockchain0x.com. รายละเอียด Testnet: พจนานุกรมของ Base chain. พื้นผิวผลิตภัณฑ์: Payment API.