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.

Passa a una chiave di test.

Una chiave sk_test_ transaziona su Base Sepolia; una chiave sk_live_ transaziona su Base mainnet. Il prefisso sceglie la rete - non c'è una variabile di ambiente di rete separata, e una chiave di test non può muovere fondi mainnet. Quindi tutto ciò che cambi per un ambiente di sviluppo è la chiave (e il segreto del webhook di test).

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

Effettua un pagamento di prova reale.

Con il wallet finanziato, chiama payments.create sulla tua chiave sk_test_. È un trasferimento reale su Base Sepolia utilizzando fondi di test, e attiva il webhook payment.received esattamente come farebbe mainnet - così eserciti il percorso del codice reale, non una simulazione. Guarda l'evento arrivare al tuo gestore tunnelato.

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

Tre scenari da esercitare come minimo: un pagamento che arriva (il percorso felice, payment.received), un pagamento che non arriva mai (punta il webhook a un URL morto e conferma che la tua pulizia di riconciliazione cattura il lavoro bloccato - il percorso che la maggior parte dei team ignora), e un retry del webhook (forza un 500 la prima volta e 200 la seconda, quindi verifica che la tua idempotenza abbia saltato il lavoro duplicato).

Fallisci rapidamente su chiavi configurate in modo errato.

L'incidente di produzione più comune riguardo le chiavi di test/live è silenzioso: un deploy arriva con una chiave di test, nessun pagamento passa, gli avvisi si attivano solo dopo il giorno lavorativo successivo. Blocca questo all'avvio: rifiuta di avviarsi se l'ambiente e il prefisso della chiave non corrispondono.

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

Una volta che il ciclo di test è nel tuo ciclo di sviluppo.

Con un ciclo di test sano in atto, il lavoro rimanente è principalmente di indurimento: gestione affidabile dei webhook sotto carico, una checklist di sicurezza finale e migrazioni da qualsiasi fornitore di pagamento precedente che potresti avere in esecuzione.

Riferimento completo su docs.blockchain0x.com. Dettagli della testnet: Glossario della catena Base. Superficie del prodotto: API di pagamento.