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.

テストキーに切り替えます。

sk_test_キーはBase Sepoliaで取引され、sk_live_キーはBaseメインネットで取引されます。プレフィックスがネットワークを選択します - 別のネットワーク環境変数はなく、テストキーはメインネットの資金を移動できません。したがって、開発環境で変更するのはキー（およびテストWebhookシークレット）だけです。

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

実際のテスト支払いを行う。

ウォレットに資金が供給されたら、sk_test_キーでpayments.createを呼び出します。これはテスト資金を使用したBase Sepoliaでの実際の転送であり、mainnetと同様にpayment.received webhookが発火します - したがって、実際のコードパスを実行し、シミュレーションではありません。トンネルされたハンドラーにイベントが到着するのを見てください。

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

最低限の運用シナリオは3つです：着地する支払い（ハッピーパス、payment.received）、決して着地しない支払い（Webhookを無効なURLに向け、調整スイープがスタックしたジョブをキャッチすることを確認します - これはほとんどのチームが無視するパスです）、およびWebhookの再試行（最初に500を強制し、2回目に200を返し、次に冪等性が重複作業をスキップしたことを確認します）。

誤設定されたキーで迅速に失敗する。

テスト/ライブキーに関する最も一般的なプロダクションインシデントは静かです：デプロイがテストキーで行われ、支払いは通過せず、アラートは次の営業日以降にのみ発火します。これをブート時にブロックします：envとキーのプレフィックスが一致しない場合は起動を拒否します。

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

テストループが開発サイクルに入ったら。

健全なテストループが整っていると、残りの作業は主に強化です：負荷下での信頼できるWebhook処理、最終的なセキュリティチェックリスト、および以前の支払いプロバイダーからの移行です。

docs.blockchain0x.comに完全なリファレンスがあります。テストネットの詳細: Baseチェーン用語集。製品表面: Payment API。