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.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 체인 용어집. 제품 표면: 결제 API.