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.

Schakel over naar een test sleutel.

Een sk_test_ sleutel transacteert op Base Sepolia; een sk_live_ sleutel transacteert op Base mainnet. Het voorvoegsel kiest het netwerk - er is geen aparte netwerk omgevingsvariabele, en een test sleutel kan geen mainnet fondsen verplaatsen. Dus alles wat je verandert voor een ontwikkelomgeving is de sleutel (en het test webhook geheim).

# .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

Doe een echte testbetaling.

Met de portemonnee gefinancierd, roep payments.create aan op je sk_test_ sleutel. Het is een echte overdracht op Base Sepolia met testfondsen, en het activeert de payment.received webhook precies zoals mainnet zou doen - zodat je het daadwerkelijke codepad uitoefent, niet een simulatie. Kijk hoe de gebeurtenis aankomt bij je getunnelde handler.

// 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

Drie scenario's om minimaal te oefenen: een betaling die aankomt (het gelukkige pad, payment.received), een betaling die nooit aankomt (wijs de webhook naar een dode URL en bevestig dat je reconciliatie-sweep de vastgelopen taak opvangt - het pad dat de meeste teams negeren), en een webhook-herhaling (dwing een 500 de eerste keer en 200 de tweede, verifieer dan dat je idempotentie het dubbele werk heeft overgeslagen).

Failliet snel bij verkeerd geconfigureerde sleutels.

Het meest voorkomende productie-incident rond test/live-sleutels is stil: een implementatie komt met een testsleutel, er komen geen betalingen binnen, waarschuwingen worden pas na de volgende werkdag geactiveerd. Blokkeer dit bij opstarten: weiger te starten als de omgevingsvariabelen en het sleutelprefix niet overeenkomen.

// 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.")

Zodra de testlus in uw ontwikkelingscyclus zit.

Met een gezonde testloop op zijn plaats, is het resterende werk voornamelijk het versterken: betrouwbare webhook-afhandeling onder belasting, een laatste beveiligingschecklijst, en migraties van elke eerdere betalingsprovider die je mogelijk naast elkaar draait.

Volledige referentie op docs.blockchain0x.com. Testnetdetails: Base chain glossary. Productoppervlak: Payment API.