Создайте агента с помощью 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.

Обработайте вебхук.

Вебхуки - это способ узнать, что платеж завершен. В 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, где вы пополняете кошелек из публичного крана, и формы ответов совпадают с живыми. Префикс ключа выбирает сеть, поэтому тестовый ключ не может перемещать средства основной сети.

Протестируйте три сценария: платеж по счастливому пути, который вызывает payment.received, пропущенная доставка (укажите webhook на недоступный URL, затем согласуйте, получив транзакцию с помощью transactions.get) и повторная попытка webhook (верните 500 в первый раз, 200 во второй, и подтвердите, что ваш обработчик идемпотентен). Когда все три пройдут тест, поменяйте ключ и отправляйте.

Как только вы получите свой первый платеж.

С работой основных платежей наиболее полезные последующие действия - это контроль расходов (чтобы агент не мог сбежать с бюджетом), надежность вебхуков (чтобы платежи не терялись под нагрузкой) и верификация личности (чтобы контрагенты доверяли публичной странице агента).

Полная справка по API находится на docs.blockchain0x.com. Продуктовая поверхность для тех же API: Payment API.