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.

పరీక్ష కీకి మార్చండి.

A sk_test_ కీ Base Sepoliaలో లావాదేవీ చేస్తుంది; A 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 పై పరీక్ష ఫండ్స్ ఉపయోగించి నిజమైన బదిలీ, మరియు ఇది mainnet ఎలా ఉంటుందో అలాగే 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, తరువాత మీ ఐడెంపొటెన్సీ డుప్లికేట్ పనిని దాటించిందో లేదో నిర్ధారించండి).

తప్పుగా కాన్ఫిగర్ చేసిన కీలు మీద త్వరగా విఫలమవ్వండి.

పరీక్ష/ప్రత్యక్ష కీలు చుట్టూ అత్యంత సాధారణ ఉత్పత్తి సంఘటన నిశ్శబ్దంగా ఉంటుంది: ఒక మోహరించడం పరీక్ష కీతో ఉంటుంది, చెల్లింపులు రావు, హెచ్చరికలు తదుపరి వ్యాపార రోజు తర్వాత మాత్రమే ఫైర్ అవుతాయి. బూట్ వద్ద దీనిని బ్లాక్ చేయండి: 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 వద్ద పూర్తి సూచన. టెస్ట్‌నెట్ వివరాలు: బేస్ చైన్ గ్లోసరీ. ఉత్పత్తి ఉపరితలం: చెల్లింపు API.