Erstellen Sie einen Agenten mit createClient von @blockchain0x/node (oder dem Python-Client), senden Sie eine USDC-Zahlung mit payments.create und überprüfen Sie den signierten Webhook mit webhooks.verify. Ausgabensteuerungen werden im Dashboard festgelegt und sind über die API nur lesbar. Der Agent berührt niemals direkt private Schlüssel. Unter zehn Minuten von der Anmeldung bis zu Ihrer ersten USDC-Zahlung auf Base, in TypeScript oder Python.

Erstellen Sie das Agentenprofil.

Das Agentenprofil ist die adressierbare Identität hinter jeder Zahlung, die Ihr Agent sendet oder empfängt. Es enthält die Wallet-Adresse, die öffentliche Seite, die Verifizierungsabzeichen und (später) die Ausgabenrichtlinie. Erstellen Sie eins pro logischen Agenten.

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.

Verarbeiten Sie den Webhook.

Webhooks sind, wie Sie erfahren, dass eine Zahlung abgeschlossen ist. In Node führt webhooks.verify von @blockchain0x/node die HMAC-Überprüfung durch und gibt eine diskriminierte Vereinigung zurück; in anderen Sprachen berechnen Sie dasselbe HMAC über den Rohkörper. Branch auf den Ereignistyp (payment.received für eingehend), antworten Sie schnell mit 2xx und stellen Sie alles Schwerere hinter die 2xx, damit die Lieferung nicht zeitlich abläuft.

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)

Testen Sie den gesamten Ablauf auf Base Sepolia.

Bevor Sie zu sk_live_-Schlüsseln wechseln, führen Sie den gesamten Pfad von Anfang bis Ende mit sk_test_ aus. Ein Testschlüssel hält alles auf Base Sepolia, wo Sie die Wallet aus dem öffentlichen Wasserhahn finanzieren und die Antwortformen mit der Live-Version übereinstimmen. Das Schlüsselpräfix wählt das Netzwerk aus, sodass ein Testschlüssel keine Hauptnetzmittel bewegen kann.

Üben Sie drei Szenarien: eine Happy-Path-Zahlung, die payment.received auslöst, eine verpasste Lieferung (weisen Sie den Webhook auf eine tote URL, und versöhnen Sie sich, indem Sie die Transaktion mit transactions.get abrufen), und einen Webhook-Wiederholungsversuch (geben Sie beim ersten Mal 500 zurück, beim zweiten Mal 200, und bestätigen Sie, dass Ihr Handler idempotent ist). Wenn alle drei Tests bestehen, wechseln Sie den Schlüssel und versenden Sie.

Sobald du deine erste Zahlung hast.

Mit funktionierenden Grundzahlungen sind die Folgemaßnahmen, die sich am meisten auszahlen, Ausgabensteuerungen (damit der Agent nicht mit dem Budget davonläuft), Webhook-Robustheit (damit Zahlungen unter Last nicht stillschweigend abgebrochen werden) und Identitätsüberprüfung (damit Gegenparteien der öffentlichen Seite des Agenten vertrauen).

Die vollständige API-Referenz befindet sich unter docs.blockchain0x.com. Produktoberfläche für dieselben APIs: Payment API.