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

एक वास्तविक चाचणी पेमेंट करा.

Wallet मध्ये निधी आल्यावर तुमच्या sk_test_ key वर payments.create कॉल करा. Base Sepolia वर test funds वापरून हा प्रत्यक्ष transfer आहे, आणि तो payment.received webhook mainnet प्रमाणेच trigger करतो - त्यामुळे तुम्ही simulation नाही, तर खरा code path तपासता. Event तुमच्या tunnelled handler वर येताना पहा.

// 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, नंतर तुमची आयडेम्पोटेंसी दुहेरी कार्य चुकली याची पुष्टी करा).

चुकलेल्या कॉन्फिगर केलेल्या कीजवर जलद अपयशी ठरावे.

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

एकदा चाचणी लूप तुमच्या विकास चक्रात.

चांगला test loop तयार झाल्यावर उरलेले काम मुख्यतः hardening चे असते: load खाली विश्वसनीय webhook handling, अंतिम security checklist, आणि तुम्ही सोबत चालवत असलेल्या जुन्या payment provider कडून migrations.

पूर्ण संदर्भ docs.blockchain0x.com येथे आहे. टेस्टनेट तपशील: Base chain glossary. उत्पादन पृष्ठ: Payment API.