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.

Test anahtarına geçin.

Bir sk_test_ anahtarı, Base Sepolia üzerinde işlem yapar; bir sk_live_ anahtarı, ana ağ Base üzerinde işlem yapar. Ön ek, ağı seçer - ayrı bir ağ ortam değişkeni yoktur ve bir test anahtarı ana ağ fonlarını hareket ettiremez. Bu nedenle, bir geliştirme ortamı için tek değiştirmeniz gereken anahtar (ve test webhook gizliliğidir).

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

Gerçek bir test ödemesi yapın.

Wallet fonlandıktan sonra sk_test_ anahtarınızla payments.create çağırın. Bu, test fonları kullanarak Base Sepolia üzerinde gerçek bir transferdir ve mainnet'teki gibi payment.received webhook'unu tetikler - yani simülasyon değil, gerçek code path'i çalıştırırsınız. Event'in tunnel edilmiş handler'ınıza ulaştığını izleyin.

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

En azından üç senaryo uygulamak için: bir ödeme gerçekleştiğinde (mutlu yol, payment.received), asla gerçekleşmeyen bir ödeme (webhook'u ölü bir URL'ye yönlendirin ve uzlaşma taramanızın takılı işi yakaladığını doğrulayın - çoğu ekibin göz ardı ettiği yol) ve bir webhook tekrar denemesi (ilk seferde 500 zorlayın ve ikinci seferde 200, ardından idempotentliğinizin tekrar eden işi atladığını doğrulayın).

Yanlış yapılandırılmış anahtarlar üzerinde hızlıca başarısız olun.

Test/canlı anahtarlar etrafındaki en yaygın üretim olayı sessizdir: bir dağıtım test anahtarı ile gelir, ödemeler geçmez, uyarılar yalnızca bir sonraki iş günü sonra tetiklenir. Bunu başlangıçta engelleyin: ortam ve anahtar öneki eşleşmiyorsa başlamayı reddedin.

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

Test döngüsü geliştirme döngünüzde bir kez.

Sağlıklı bir test döngüsü kurulduktan sonra kalan işlerin çoğu hardening'dir: yük altında güvenilir webhook handling, son bir security checklist ve birlikte çalıştırıyor olabileceğiniz önceki payment provider'dan migration.

Tam referans için docs.blockchain0x.com adresine bakın. Testnet detayları: Base chain glossary. Ürün yüzeyi: Payment API.