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 मुख्य नेटवर्क पर लेनदेन करती है। उपसर्ग नेटवर्क को चुनता है - कोई अलग नेटवर्क env var नहीं है, और एक परीक्षण कुंजी मुख्य नेटवर्क के फंड को स्थानांतरित नहीं कर सकती। इसलिए विकास वातावरण के लिए आप केवल कुंजी (और परीक्षण वेबहुक सीक्रेट) बदलते हैं।

# .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 पर परीक्षण निधियों का उपयोग करके एक वास्तविक ट्रांसफर है, और यह वास्तव में मुख्य नेटवर्क की तरह payment.received वेबहुक को सक्रिय करता है - ताकि आप वास्तविक कोड पथ का अभ्यास करें, न कि एक अनुकरण। अपने टनल किए गए हैंडलर पर इवेंट को उतरते हुए देखें।

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

कम से कम अभ्यास करने के लिए तीन परिदृश्य: एक भुगतान जो पहुँचता है (खुश रास्ता, payment.received), एक भुगतान जो कभी नहीं पहुँचता (वेबहुक को एक मृत URL पर इंगित करें और पुष्टि करें कि आपका समेटना अटका हुआ कार्य पकड़ता है - वह रास्ता जिसे अधिकांश टीमें अनदेखा करती हैं), और एक वेबहुक पुनः प्रयास (पहली बार 500 को मजबूर करें और दूसरी बार 200, फिर सत्यापित करें कि आपकी idempotency ने डुप्लिकेट कार्य को छोड़ दिया)।

गलत कॉन्फ़िगर की गई चाबियों पर तेजी से विफल हों।

परीक्षण/लाइव कुंजियों के चारों ओर सबसे सामान्य उत्पादन घटना चुप है: एक तैनाती एक परीक्षण कुंजी के साथ उतरती है, कोई भुगतान नहीं आता, अलर्ट केवल अगले व्यावसायिक दिन के बाद ही सक्रिय होते हैं। इसे बूट पर ब्लॉक करें: यदि 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.")

एक बार परीक्षण लूप आपके विकास चक्र में।

एक स्वस्थ परीक्षण लूप स्थापित होने के साथ, शेष कार्य ज्यादातर मजबूत करना है: लोड के तहत विश्वसनीय वेबहुक हैंडलिंग, एक अंतिम सुरक्षा चेकलिस्ट, और किसी भी पूर्व भुगतान प्रदाता से माइग्रेशन जो आप चला सकते हैं।

पूर्ण संदर्भ docs.blockchain0x.com पर। टेस्टनेट विवरण: Base chain glossary. उत्पाद सतह: Payment API।