Maak een agent aan met createClient van @blockchain0x/node (of de Python-client), stuur een USDC-betaling met payments.create en verifieer de ondertekende webhook met webhooks.verify. Uitgavencontrole is ingesteld in het dashboard en alleen-lezen via de API. De agent raakt nooit rechtstreeks privé-sleutels aan. Minder dan tien minuten van aanmelding tot je eerste USDC-betaling op Base, in TypeScript of Python.

Maak het agentprofiel aan.

Het agentprofiel is de adresseerbare identiteit achter elke betaling die je agent verzendt of ontvangt. Het bevat het walletadres, de openbare pagina, de verificatiebadges en (later) het uitgavenbeleid. Maak er één per logische agent.

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.

Verwerk de webhook.

Webhooks zijn hoe je erachter komt dat een betaling is afgehandeld. In Node doet webhooks.verify van @blockchain0x/node de HMAC-controle en retourneert een gediscrimineerde unie; in andere talen bereken je dezelfde HMAC over de ruwe body. Vertak op het type gebeurtenis (payment.received voor inkomend), reageer snel met 2xx, en zet alles zwaarder achter de 2xx in de wachtrij zodat de levering niet tijdslimiet.

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)

Test de hele flow op Base Sepolia.

Voordat u overschakelt naar sk_live_ sleutels, voert u het volledige pad end-to-end uit met sk_test_. Een testsleutel houdt alles op Base Sepolia, waar u de portemonnee financiert vanuit de openbare kraan en de responsvormen overeenkomen met live. De sleutelprefix kiest het netwerk, zodat een testsleutel geen mainnet-fondsen kan verplaatsen.

Oefen drie scenario's: een happy-path betaling die payment.received activeert, een gemiste levering (wijs de webhook naar een dode URL, en reconcilieer door de transactie op te halen met transactions.get), en een webhook-herhaling (geef de eerste keer een 500 terug, 200 de tweede keer, en bevestig dat je handler idempotent is). Wanneer alle drie de tests slagen, wissel de sleutel en verzend.

Zodra je je eerste betaling hebt.

Met basisbetalingen die werken, zijn de vervolgacties die het meest opleveren uitgavencontroles (zodat de agent niet met het budget kan weglopen), webhook-robustheid (zodat betalingen niet stilletjes onder belasting verdwijnen), en identiteitsverificatie (zodat tegenpartijen de openbare pagina van de agent vertrouwen).

Volledige API-referentie bevindt zich op docs.blockchain0x.com. Productoppervlak voor dezelfde API's: Betalings-API.