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.

Changer pour une clé de test.

Une clé sk_test_ effectue des transactions sur Base Sepolia ; une clé sk_live_ effectue des transactions sur le mainnet de Base. Le préfixe choisit le réseau - il n'y a pas de variable d'environnement réseau séparée, et une clé de test ne peut pas déplacer des fonds du mainnet. Donc, tout ce que vous changez pour un environnement de développement est la clé (et le secret du webhook de 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

Effectuez un vrai paiement de test.

Avec le portefeuille financé, appelez payments.create sur votre clé sk_test_. C'est un transfert réel sur Base Sepolia utilisant des fonds de test, et cela déclenche le webhook payment.received exactement comme le ferait le mainnet - vous exercez donc le chemin de code réel, pas une simulation. Regardez l'événement arriver à votre gestionnaire tunnelé.

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

Trois scénarios à exercer au minimum : un paiement qui arrive (le chemin heureux, payment.received), un paiement qui n'arrive jamais (dirigez le webhook vers une URL morte et confirmez que votre balayage de réconciliation attrape le travail bloqué - le chemin que la plupart des équipes ignorent), et une nouvelle tentative de webhook (forcez un 500 la première fois et 200 la seconde, puis vérifiez que votre idempotence a sauté le travail en double).

Échouez rapidement sur des clés mal configurées.

L'incident de production le plus courant concernant les clés de test/en direct est silencieux : un déploiement se fait avec une clé de test, aucun paiement ne passe, les alertes ne se déclenchent qu'après le jour ouvrable suivant. Bloquez cela au démarrage : refusez de démarrer si l'environnement et le préfixe de la clé ne correspondent pas.

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

Une fois que la boucle de test est dans votre cycle de développement.

Avec une boucle de test saine en place, le travail restant consiste principalement à renforcer : gestion fiable des webhooks sous charge, une liste de contrôle de sécurité finale et des migrations depuis tout fournisseur de paiement précédent que vous pourriez utiliser en parallèle.

Référence complète sur docs.blockchain0x.com. Détails du testnet : Glossaire de la chaîne Base. Surface du produit : API de paiement.