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 key କୁ switch କରନ୍ତୁ।

sk_test_ କୀ Base Sepolia ଉପରେ ଲେନଦେନ କରେ; sk_live_ କୀ Base mainnet ଉପରେ ଲେନଦେନ କରେ। ପ୍ରିଫିକ୍ସ ନେଟୱର୍କକୁ ବାଛେ - ଏହାର କୌଣସି ବିଶେଷ ନେଟୱର୍କ env var ନାହିଁ, ଏବଂ ଏକ ପରୀକ୍ଷା କୀ mainnet ଧନକୁ ଗତି କରିପାରିବ ନାହିଁ। ସେହିପରି, ଏକ ଡେଭଲପର୍ ପରିବେଶ ପାଇଁ ଆପଣ ଯାହା ବଦଳାଇବେ ସେହେଉଛି କୀ (ଏବଂ ପରୀକ୍ଷା 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

ଏକ ବାସ୍ତବ test payment କରନ୍ତୁ।

wallet ରେ ଧନ ଥିଲେ, ଆପଣଙ୍କ sk_test_ key ଉପରେ payments.create call କରନ୍ତୁ। ଏହା test funds ବ୍ୟବହାର କରି Base Sepolia ଉପରେ ଏକ real transfer, ଏବଂ ଏହା mainnet ପରି ସଠିକ୍ ଭାବରେ payment.received webhook fire କରେ - ସେହିପାଇଁ ଆପଣ simulation ନୁହେଁ, actual code path କୁ exercise କରୁଛନ୍ତି। ଆପଣଙ୍କ tunnelled handler ରେ event ପହଞ୍ଚୁଥିବାକୁ ଦେଖନ୍ତୁ।

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

ନ୍ୟୁନତମରେ exercise କରିବାକୁ ତିନୋଟି scenario: ଏକ payment ଯାହା land କରେ (happy path, payment.received), ଏକ payment ଯାହା କେବେ land ନ କରେ (webhook କୁ dead URL ଦିଗରେ point କରନ୍ତୁ ଏବଂ reconcile sweep ଅଟକିଥିବା job କୁ ଧରିଥିବା କଥା confirm କରନ୍ତୁ - ଯେ path କୁ ଅଧିକାଂଶ teams ଅନଦେଖା କରେ), ଏବଂ ଏକ webhook retry (ପ୍ରଥମେ 500 force କରନ୍ତୁ ଏବଂ ଦ୍ୱିତୀୟରେ 200, ତାପରେ ଆପଣଙ୍କ idempotency duplicate work skip କରିଥିଲା କି ନାହିଁ verify କରନ୍ତୁ)।

ଭୁଲ କନଫିଗର୍ କୀସ୍‌ରେ ଦ୍ରୁତ ବିଫଳ ହୁଅନ୍ତୁ।

test/live key ଚାରିପାଖରେ ସବୁଠାରୁ ସାଧାରଣ production incident silent ହୁଏ: ଏକ deploy test key ସହିତ ଆସେ, କୌଣସି payment ଆସେ ନାହିଁ, alert ପରବର୍ତ୍ତୀ business day ପରେ ମାତ୍ର fire ହୁଏ। boot ସମୟରେ ଏହାକୁ block କରନ୍ତୁ: env ଏବଂ key prefix ମେଳ ନହେଲେ start କରିବାକୁ ଅସ୍ୱୀକାର କରନ୍ତୁ।

// 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 ଠାରୁ migration।

docs.blockchain0x.com ରେ ପୂର୍ଣ୍ଣ ସନ୍ଦର୍ଭ। ଟେସ୍ଟନେଟ୍ ବିବରଣୀ: Base chain glossary। ଉତ୍ପାଦ ସର୍ଫେସ୍: Payment API.