Swap your API key for a sk_test_ key - that alone puts you on Base Sepolia. Fund the agent's wallet from the public Base Sepolia USDC faucet, make a real test payment with payments.create (test funds, no real money), and tunnel your local webhook through ngrok. The response shapes match live, so a flow that passes in test passes in production. Exercise the failure paths, not just the happy one.

Wechseln Sie zu einem Testschlüssel.

Ein sk_test_-Schlüssel transaktiert auf Base Sepolia; ein sk_live_-Schlüssel transaktiert auf dem Base-Mainnet. Das Präfix wählt das Netzwerk - es gibt keine separate Netzwerk-Umgebungsvariable, und ein Testschlüssel kann keine Mainnet-Gelder bewegen. Daher ändern Sie für eine Entwicklungsumgebung nur den Schlüssel (und das Test-Webhook-Geheimnis).

# .env.development
# A sk_test_ key picks Base Sepolia automatically - there is no network env var.
BLOCKCHAIN0X_API_KEY=sk_test_01J9...
BLOCKCHAIN0X_WEBHOOK_SECRET=...   # the test webhook's secret, from the dashboard

Führen Sie eine echte Testzahlung durch.

Mit der finanzierten Wallet rufen Sie payments.create mit Ihrem sk_test_-Schlüssel auf. Es handelt sich um eine echte Überweisung auf Base Sepolia mit Testmitteln, und es löst das payment.received-Webhooks genau so aus, wie es das Mainnet tun würde - sodass Sie den tatsächlichen Codepfad ausüben, nicht eine Simulation. Sehen Sie zu, wie das Ereignis bei Ihrem tunnellierten Handler ankommt.

// On a sk_test_ key this is a REAL transfer on Base Sepolia (test funds, no
// real money). It fires the payment.received webhook just like mainnet does.
const tx = await client.payments.create({
  agentId: "agt_123",
  to: "0xRecipientOnSepolia",
  amountWei: "10000", // 0.01 USDC
});

console.log(tx); // watch payment.received arrive at your webhook

tx = client.payments.create(body={
    "agentId": "agt_123",
    "to": "0xRecipientOnSepolia",
    "amountWei": "10000",  # 0.01 USDC
})

print(tx)  # watch payment.received arrive at your webhook

Drei Szenarien, die mindestens geübt werden müssen: eine Zahlung, die ankommt (der glückliche Weg, payment.received), eine Zahlung, die niemals ankommt (weisen Sie das Webhook auf eine tote URL und bestätigen Sie, dass Ihr Versöhnungssweep den steckengebliebenen Job erfasst - den Weg, den die meisten Teams ignorieren), und einen Webhook-Wiederholungsversuch (erzwingen Sie beim ersten Mal einen 500 und beim zweiten Mal einen 200, und überprüfen Sie dann, ob Ihre Idempotenz die doppelte Arbeit übersprungen hat).

Schnell scheitern bei falsch konfigurierten Schlüsseln.

Der häufigste Produktionsvorfall bei Test-/Live-Keys ist still: Ein Deployment erfolgt mit einem Test-Key, keine Zahlungen gehen durch, Warnungen werden erst am nächsten Geschäftstag ausgelöst. Blockieren Sie dies beim Booten: Weigern Sie sich zu starten, wenn die Umgebung und das Key-Präfix nicht übereinstimmen.

// Fail fast if test/live get mixed up.
const apiKey = process.env.BLOCKCHAIN0X_API_KEY!;
const env = process.env.NODE_ENV;

if (env === "production" && apiKey.startsWith("sk_test_")) {
  throw new Error("Test key in production environment - aborting boot.");
}
if (env !== "production" && apiKey.startsWith("sk_live_")) {
  throw new Error("Live key in non-production environment - aborting boot.");
}

import os, sys

api_key = os.environ["BLOCKCHAIN0X_API_KEY"]
env = os.environ.get("ENV", "development")

if env == "production" and api_key.startswith("sk_test_"):
    sys.exit("Test key in production environment - aborting boot.")
if env != "production" and api_key.startswith("sk_live_"):
    sys.exit("Live key in non-production environment - aborting boot.")

Sobald die Testschleife in Ihrem Entwicklungszyklus ist.

Mit einem gesunden Testloop ist die verbleibende Arbeit hauptsächlich das Härtung: zuverlässige Webhook-Verarbeitung unter Last, eine abschließende Sicherheitscheckliste und Migrationen von jedem vorherigen Zahlungsanbieter, den Sie möglicherweise parallel betreiben.

Vollständige Referenz unter docs.blockchain0x.com. Testnet-Details: Base chain glossary. Produktoberfläche: Payment API.