สร้างเอเจนต์ด้วย createClient จาก @blockchain0x/node (หรือไคลเอนต์ Python) ส่งการชำระเงิน USDC ด้วย payments.create และตรวจสอบ webhook ที่ลงนามด้วย webhooks.verify การควบคุมการใช้จ่ายตั้งค่าในแดชบอร์ดและอ่านได้เฉพาะผ่าน API เอเจนต์ไม่เคยสัมผัสกุญแจส่วนตัวโดยตรง ใช้เวลาไม่ถึงสิบจากการลงทะเบียนจนถึงการชำระเงิน USDC ครั้งแรกของคุณบน Base ใน TypeScript หรือ Python.

สร้างโปรไฟล์เอเจนต์.

โปรไฟล์เอเจนต์คือเอกลักษณ์ที่สามารถระบุได้เบื้องหลังการชำระเงินทุกครั้งที่เอเจนต์ของคุณส่งหรือรับ มันมีที่อยู่กระเป๋าเงิน, หน้าเว็บสาธารณะ, แท็กการตรวจสอบ, และ (ในภายหลัง) นโยบายการใช้จ่าย สร้างหนึ่งต่อเอเจนต์ที่มีเหตุผล.

import { createClient } from "@blockchain0x/node";

const client = createClient({ apiKey: process.env.BLOCKCHAIN0X_API_KEY! }); // sk_test_ / sk_live_

const agent = await client.agents.create({ name: "research-bot" });

console.log(agent.id); // "agt_..."
// Public page: https://wallet.blockchain0x.com/a/{slug}

from blockchain0x import Client

client = Client()  # reads BLOCKCHAIN0X_API_KEY from the environment

agent = client.agents.create(body={"name": "research-bot"})

print(agent["id"])  # "agt_..."
# Public page: https://wallet.blockchain0x.com/a/{slug}

After this call, the agent has a public page at https://wallet.blockchain0x.com/a/<slug> that any counterparty (human or agent) can hover for verification info. See the agent payment identity glossary entry for what that page exposes.

จัดการ webhook.

Webhooks เป็นวิธีที่คุณค้นพบว่าการชำระเงินได้ชำระแล้ว ใน Node, webhooks.verify จาก @blockchain0x/node จะทำการตรวจสอบ HMAC และส่งคืนการรวมที่แยกแยะ; ในภาษาอื่น ๆ คำนวณ HMAC เดียวกันกับเนื้อหาดิบ แยกตามประเภทเหตุการณ์ (payment.received สำหรับการเข้ามา) ตอบสนอง 2xx อย่างรวดเร็ว และรอคิวสิ่งที่หนักกว่าหลัง 2xx เพื่อไม่ให้การจัดส่งหมดเวลา

import express from "express";
import { webhooks } from "@blockchain0x/node";

const app = express();
// Capture the RAW body. The HMAC is over the exact bytes on the wire.
app.use(express.raw({ type: "application/json" }));

app.post("/webhooks/payment", (req, res) => {
  const result = webhooks.verify({
    headers: req.headers,
    rawBody: req.body, // Buffer, raw bytes
    secret: process.env.BLOCKCHAIN0X_WEBHOOK_SECRET!,
  });
  if (!result.ok) return res.status(400).json({ code: result.code });

  if (result.eventType === "payment.received") {
    // USDC landed - deliver the work, fulfil the order, etc.
    void deliver(result.eventId);
  }
  res.status(200).send("ok");
});

import hmac, hashlib, os, time
from flask import Flask, request, abort

app = Flask(__name__)
SECRET = os.environ["BLOCKCHAIN0X_WEBHOOK_SECRET"].encode()

@app.post("/webhooks/payment")
def webhook():
    raw = request.get_data()  # RAW bytes - do not parse first
    sig = request.headers.get("X-Blockchain0x-Signature", "")
    ts = request.headers.get("X-Blockchain0x-Timestamp", "")
    parts = dict(p.split("=", 1) for p in sig.split(",") if "=" in p)
    t, v1 = parts.get("t", ts), parts.get("v1", sig)
    want = hmac.new(SECRET, t.encode() + b"." + raw, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(want, v1) or abs(time.time() - int(t)) > 300:
        abort(401)
    if request.headers.get("X-Blockchain0x-Event-Type") == "payment.received":
        deliver(request.get_json())  # USDC landed
    return ("ok", 200)

ทดสอบกระบวนการทั้งหมดบน Base Sepolia.

ก่อนที่จะเปลี่ยนไปใช้คีย์ sk_live_ ให้รันเส้นทางทั้งหมดจากต้นจนจบด้วย sk_test_ คีย์ทดสอบจะเก็บทุกอย่างไว้บน Base Sepolia ซึ่งคุณเติมเงินในกระเป๋าเงินจากก๊อกสาธารณะและรูปแบบการตอบสนองตรงกับแบบสด คีย์พรีฟิกเลือกเครือข่าย ดังนั้นคีย์ทดสอบจึงไม่สามารถย้ายเงินใน mainnet ได้

ฝึกฝนสามสถานการณ์: การชำระเงินที่ราบรื่นที่ทำให้เกิด payment.received, การจัดส่งที่พลาด (ชี้ webhook ไปที่ URL ที่ตายแล้ว, จากนั้นปรับสมดุลโดยการดึงธุรกรรมด้วย transactions.get), และการลองใหม่ของ webhook (ส่งกลับ 500 ครั้งแรก, 200 ครั้งที่สอง, และยืนยันว่าตัวจัดการของคุณเป็น idempotent). เมื่อทั้งสามผ่านการทดสอบ, เปลี่ยนกุญแจและส่ง.

เมื่อคุณมีการชำระเงินครั้งแรก

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

เอกสารอ้างอิง API เต็มรูปแบบอยู่ที่ docs.blockchain0x.com. พื้นผิวผลิตภัณฑ์สำหรับ API เดียวกัน: Payment API.