createClient'i @blockchain0x/node'dan (veya Python istemcisinden) kullanarak bir ajan oluşturun, payments.create ile bir USDC ödemesi gönderin ve imzalı webhook'u webhooks.verify ile doğrulayın. Harcama kontrolleri kontrol panelinde ayarlanır ve API üzerinden yalnızca okunur. Ajan asla özel anahtarlara doğrudan dokunmaz. Kaydolmaktan Base üzerinde ilk USDC ödemenize kadar on dakikadan az, TypeScript veya Python ile.

Ajan profilini oluştur.

Ajan profili, ajanınızın gönderdiği veya aldığı her ödemenin adreslenebilir kimliğidir. Cüzdan adresini, kamu sayfasını, doğrulama rozetlerini ve (sonrasında) harcama politikasını taşır. Her mantıksal ajan için bir tane oluşturun.

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'u yönetin.

Webhook'lar, bir ödemenin yerleştiğini nasıl öğrenirsiniz. Node'da, @blockchain0x/node'dan webhooks.verify HMAC kontrolünü yapar ve ayrımlı bir birleşim döndürür; diğer dillerde, ham gövde üzerinde aynı HMAC'ı hesaplayın. Olay türüne göre (gelen için payment.received) ayrılın, hızlı bir şekilde 2xx yanıt verin ve teslimatın zaman aşımına uğramaması için daha ağır olan her şeyi 2xx'in arkasında sıraya alın.

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)

Tüm akışı Base Sepolia'da test edin.

Canlı sk_live_ anahtarlarına geçmeden önce, sk_test_ ile tam yolu baştan sona çalıştırın. Bir test anahtarı, her şeyi Base Sepolia'da tutar, burada cüzdanı kamu musluğundan finanse edersiniz ve yanıt şekilleri canlı ile eşleşir. Anahtar ön eki, ağı seçer, bu nedenle bir test anahtarı ana ağ fonlarını taşıyamaz.

Üç senaryoyu deneyin: payment.received tetikleyen bir sorunsuz ödeme, kaçırılan bir teslimat (webhook'u ölü bir URL'ye yönlendirin, ardından işlemi transactions.get ile alarak uzlaştırın) ve bir webhook tekrar denemesi (ilk seferde 500 döndürün, ikinci seferde 200, ve işleyicinizin idempotent olduğunu doğrulayın). Üçü de testten geçtiğinde, anahtarı değiştirin ve gönderin.

İlk ödemenizi aldığınızda.

Temel ödemeler çalışırken, en çok fayda sağlayan sonraki adımlar spend controls'dur (agent bütçeyle kontrolden çıkmasın diye), webhook robustness'tır (ödemeler yük altında sessizce düşmesin diye) ve identity verification'dır (karşı taraflar agent'ın public page'ine güvensin diye).

Tam API referansı docs.blockchain0x.com'da bulunmaktadır. Aynı API'ler için ürün yüzeyi: Ödeme API'si.